Элемент credentials для элемента forms для элемента authentication (схема параметров ASP.NET)

Статья
08/11/2011

Разрешает необязательные определения учетных данных (имени и пароля) в файле конфигурации. Кроме того, для управления проверкой можно реализовать использование внешнего источника (например базы данных) в настраиваемой парольной схеме.

Внимание
Данный метод хранения учетных данных следует использовать только в приложениях, не требующих высокого уровня безопасности.

<credentials 
   passwordFormat="[Clear|SHA1|MD5]"
>
  <user />
</credentials>

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут	Описание
passwordFormat	Обязательный атрибут. Задает используемый для хранения паролей формат шифрования. Этот атрибут может принимать одно из следующих значений. ЗначениеОписание Clear Указывает, что пароли не зашифрованы. MD5 Указывает, что шифрование паролей выполняется с помощью хэш-алгоритма MD5. SHA1 Указывает, что шифрование паролей выполняется с помощью хэш-алгоритма SHA1. По умолчанию используется значение SHA1.

passwordFormat

Обязательный атрибут.

Задает используемый для хранения паролей формат шифрования.

Этот атрибут может принимать одно из следующих значений.

ЗначениеОписание

Clear Указывает, что пароли не зашифрованы.

MD5 Указывает, что шифрование паролей выполняется с помощью хэш-алгоритма MD5.

SHA1 Указывает, что шифрование паролей выполняется с помощью хэш-алгоритма SHA1.

По умолчанию используется значение SHA1.

Дочерние элементы

Элемент	Описание
clear	Удаляет все ссылки на унаследованные строки подключения, кроме тех, которые добавлены текущим элементом user.
remove	Удаляет из коллекции учетных данных ссылку на наследуемую учетную запись пользователя.
user	Добавляет определение имени пользователя и пароля в коллекцию учетных данных.

Родительские элементы

Элемент	Описание
configuration	Задает обязательный корневой элемент любого файла конфигурации, который используется средой CLR и приложениями .NET Framework.
system.web	Задает корневой элемент для параметров конфигурации ASP.NET в файле конфигурации и содержит элементы конфигурации для настройки веб-приложений ASP.NET и управления работой этих приложений.
authentication	Настраивает схему проверки подлинности ASP.NET, используемую для идентификации пользователей, которые работают с приложением ASP.NET.
forms	Настраивает приложение ASP.NET для пользовательской проверки подлинности на основе форм.

Заметки

Элемент credentials разрешает необязательные определения учетных данных (имени и пароля) в файле конфигурации. Кроме того, для управления проверкой можно реализовать использование внешнего источника (например базы данных) в настраиваемой парольной схеме. Если на одном сервере выполняются несколько приложений, то для каждого приложения в файле Web.config необходимо настроить атрибуты элемента forms. Дополнительные сведения см. в разделе Проверка подлинности форм между приложениями.

Конфигурация по умолчанию

Следующий элемент credentials не задан явно в файле Machine.config или корневом файле Web.config. Однако, он представляет собой конфигурацию по умолчанию, возвращаемую приложением.

<credentials passwordFormat="SHA1" />

Пример

В следующем примере задается режим проверки подлинности, входная страница и формат шифрования входных учетных данных. В файле конфигурации сохраняются учетные записи трех пользователей.

<configuration>
   <system.web>
      <authentication mode="Forms">
         <forms name="401kApp" loginUrl="/login.aspx">
            <credentials passwordFormat = "SHA1">
               <user 
                  name="UserName1" 
                  password="SHA1EncryptedPassword1"/>
               <user 
                  name="UserName2" 
                  password="SHA1EncryptedPassword2"/>
               <user 
                  name="UserName3" 
                  password="SHA1EncryptedPassword3"/>
            </credentials>
         </forms>
      </authentication>
   </system.web>
</configuration>

Сведения об элементе

Обработчик раздела конфигурации	AuthenticationSection
Элемент конфигурации	Credentials
Настраиваемые расположения	Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения
Требования	Microsoft IIS версии 5.0, 5.1 или 6.0 .NET Framework версии 1.0, 1.1 или 2.0 Microsoft Visual Studio 2003 или Visual Studio 2005

См. также

Share via

Элемент credentials для элемента forms для элемента authentication (схема параметров ASP.NET)

Атрибуты и элементы

Атрибуты

Дочерние элементы

Родительские элементы

Заметки

Конфигурация по умолчанию

Пример

Сведения об элементе

См. также

Задачи

Ссылки

Основные понятия

Другие ресурсы

Дополнительные ресурсы