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

Статья
11/16/2008

Обновлен: Ноябрь 2007

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

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

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

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

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

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

Атрибуты

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

passwordFormat

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

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

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

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

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

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

SHAI Указывает, что шифрование паролей выполняется с помощью хэш-алгоритма 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

См. также

Поделиться через

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

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

Атрибуты

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

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

Заметки

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

Пример

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

См. также

Задачи

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

Ссылки

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

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