Элемент credentials для элемента forms для элемента authentication (схема параметров ASP.NET)
[Этот раздел из предварительной документации может быть изменен в будущих выпусках. Пустые разделы включены как заполнители.]
Разрешает необязательные определения учетных данных (имени и пароля) в файле конфигурации. Кроме того, для управления проверкой можно реализовать использование внешнего источника (например базы данных) в настраиваемой парольной схеме.
Предупреждение
Данный метод хранения учетных данных следует использовать только в приложениях, не требующих высокого уровня безопасности.
<credentials
passwordFormat="[Clear|SHA1|MD5]"
>
<user />
</credentials>
Атрибуты и элементы
В следующих разделах описаны атрибуты, дочерние элементы и родительские элементы.
Атрибуты
Атрибут |
Описание |
|---|---|
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. Дополнительные сведения см. в разделе Forms Authentication Across Applications.
Конфигурация по умолчанию
Следующий элемент 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>
Сведения об элементе
Обработчик раздела конфигурации |
|
Член конфигурации |
|
Настраиваемые расположения |
Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения |
Требования |
Microsoft Internet Information Services (IIS) версии 5.0, 5.1 или 6.0 .NET Framework версии 1.0, 1.1 или 2.0 Microsoft Visual Studio 2003 или Visual Studio 2005 |
См. также
Задачи
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
Reference
Элемент forms для элемента credentials для элемента authentication (схема параметров ASP.NET)
Элемент clear для элемента credentials для элемента authentication (схема параметров ASP.NET)
Элемент remove для элемента credentials для элемента authentication (схема параметров ASP.NET)
Элемент user для элемента credentials для элемента authentication (схема параметров ASP.NET)
Элемент authentication (схема параметров ASP.NET)
Элемент credentials для элемента forms для элемента authentication (схема параметров ASP.NET)
Элемент system.web (схема параметров ASP.NET)
Элемент passport для элемента credentials для элемента authentication (схема параметров ASP.NET)
Элемент configuration (схема общих параметров)
Основные понятия
Forms Authentication Across Applications
ASP.NET Configuration File Hierarchy
Другие ресурсы
Общие параметры конфигурации (ASP.NET)
Параметры конфигурации ASP.NET