Добавление учетных данных проверки подлинности <управления>

Общие сведения

Элемент <add><credentials> элемента добавляет учетную запись пользователя в коллекцию пользователей диспетчера IIS для служб IIS 7. Пользователи диспетчера IIS могут использовать диспетчер IIS для подключения к сайтам и приложениям, для которых они авторизованы администратором сервера.

Примечание

Элемент <credentials> применяется только при использовании configurationAuthenticationProvider по умолчанию в качестве поставщика проверки подлинности.

Совместимость

Версия	Примечания
IIS 10.0	Элемент <add> не был изменен в IIS 10.0.
IIS 8,5	Элемент <add> не был изменен в IIS 8.5.
IIS 8,0	Элемент <add> не был изменен в IIS 8.0.
IIS 7,5	Элемент <add> не был изменен в IIS 7.5.
IIS 7.0	Элемент <add> элемента появился <credentials> в IIS 7.0.
IIS 6,0	Н/Д

Настройка

Установка служб IIS 7 и более поздних версий по умолчанию не включает службу роли службы управления . Чтобы установить эту службу роли, выполните следующие действия.

Windows Server 2012 или Windows Server 2012 R2

1. На панели задач щелкните Диспетчер сервера.
2. В диспетчер сервера откройте меню Управление и выберите пункт Добавить роли и компоненты.
3. В мастере добавления ролей и компонентов нажмите кнопку Далее. Выберите тип установки и нажмите кнопку Далее. Выберите целевой сервер и нажмите кнопку Далее.
4. На странице Роли сервера разверните узел Веб-сервер (IIS), средства управления, а затем выберите Служба управления. Щелкните Далее.
   .
5. На странице Выбор компонентов нажмите кнопку Далее.
6. На странице Подтверждение выбранных элементов для установки нажмите кнопку Установить.
7. На странице Результаты нажмите кнопку Закрыть.

Windows 8 или Windows 8.1

1. На начальном экране переместите указатель в левый нижний угол, щелкните правой кнопкой мыши кнопку Пуск и выберите пункт панель управления.
2. В панель управления щелкните Программы и компоненты, а затем — Включить или отключить компоненты Windows.
3. Разверните узел Службы IIS, средства веб-управления, а затем выберите Служба управления IIS.
   
4. Нажмите кнопку ОК.
5. Щелкните Закрыть.

Windows Server 2008 или Windows Server 2008 R2

1. На панели задач нажмите кнопку Пуск, наведите указатель мыши на пункт Администрирование, а затем щелкните диспетчер сервера.
2. В области иерархии диспетчер сервера разверните узел Роли, а затем щелкните Веб-сервер (IIS) .
3. В области Веб-сервер (IIS) прокрутите страницу до раздела Службы ролей и щелкните Добавить службы ролей.
4. На странице Выбор служб ролеймастера добавления служб ролей выберите Служба управления и нажмите кнопку Далее.
   
5. На странице Подтверждение выбранных элементов для установки нажмите кнопку Установить.
6. На странице Результаты нажмите кнопку Закрыть.

Windows Vista или Windows 7

1. На панели задач нажмите кнопку Пуск, а затем выберите пункт панель управления.
2. В панель управления щелкните Программы и компоненты, а затем — Включить или отключить компоненты Windows.
3. Разверните узел Службы IIS, а затем — Средство управления веб-сайтом.
4. Выберите Служба управления IIS и нажмите кнопку ОК.
   

Инструкции

Включение учетных данных диспетчера IIS для сервера

1. Откройте диспетчер служб IIS.

   • Если вы используете Windows Server 2012 или Windows Server 2012 R2:

     • На панели задач щелкните диспетчер сервера, инструменты, а затем диспетчер служб IIS.

   • Если вы используете Windows 8 или Windows 8.1:

     • Удерживая нажатой клавишу Windows, нажмите букву X и щелкните панель управления.
     • Щелкните Администрирование, а затем дважды щелкните диспетчер служб IIS.

   • Если вы используете Windows Server 2008 или Windows Server 2008 R2:

     • На панели задач нажмите кнопку Пуск, наведите указатель на пункт Администрирование, а затем щелкните Диспетчер служб IIS.

   • Если вы используете Windows Vista или Windows 7:

     • На панели задач нажмите кнопку Пуск, а затем выберите пункт панель управления.
     • Дважды щелкните элемент Администрирование, а затем дважды щелкните диспетчер служб IIS.

2. В области Подключения щелкните имя сервера.

3. На главной панели сервера дважды щелкните Службу управления.
   

4. На странице Служба управления выберите Учетные данные Windows или Учетные данные диспетчера IIS, а затем нажмите кнопку Применить на панели Действия .
   

Добавление учетных данных пользователя диспетчера IIS на сервер

1. Откройте диспетчер служб IIS.

   • Если вы используете Windows Server 2012 или Windows Server 2012 R2:

     • На панели задач щелкните диспетчер сервера, инструменты, а затем диспетчер служб IIS.

   • Если вы используете Windows 8 или Windows 8.1:

     • Удерживая нажатой клавишу Windows, нажмите букву X и щелкните панель управления.
     • Щелкните Администрирование, а затем дважды щелкните диспетчер служб IIS.

   • Если вы используете Windows Server 2008 или Windows Server 2008 R2:

     • На панели задач нажмите кнопку Пуск, наведите указатель на пункт Администрирование, а затем щелкните Диспетчер служб IIS.

   • Если вы используете Windows Vista или Windows 7:

     • На панели задач нажмите кнопку Пуск, а затем выберите пункт панель управления.
     • Дважды щелкните элемент Администрирование, а затем дважды щелкните диспетчер служб IIS.

2. В области Подключения щелкните имя сервера.

3. На главной панели сервера дважды щелкните элемент Пользователи диспетчера IIS.
   

4. На странице Пользователи диспетчера IIS щелкните Добавить пользователя... в области Действия .
   

5. В диалоговом окне Добавление пользователя введите имя пользователя и пароль, а затем нажмите кнопку ОК.
   

Конфигурация

Атрибуты

Атрибут	Описание
name	Обязательный строковый атрибут. Указывает имя пользователя учетной записи диспетчера IIS.
password	Обязательный строковый атрибут. Указывает хэш SHA256 пароля пользователя для учетной записи пользователя диспетчера IIS. Этот атрибут учитывает регистр. При настройке учетной записи пользователя диспетчера IIS с помощью диспетчера IIS хэш паролей вычисляется автоматически. Если вы хотите вычислить хэш пароля программным способом, можно использовать метод System.Security.Cryptography.SHA256.ComputeHash. Дополнительные сведения см. в разделе Класс SHA256 на сайте MSDN.
enabled	Дополнительный логический атрибут. Указывает, включен ли пользователь диспетчера IIS (true) или отключен (false). Если значение равно true, пользователь диспетчера IIS может использовать диспетчер IIS для подключения ко всем сайтам и приложениям, для которых он авторизован администратором сервера на веб-сервере. Значение по умолчанию — true.

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

Отсутствует.

Образец конфигурации

В следующем примере конфигурации показано, как добавить пользователя диспетчера IIS с именем ContosoUser в Administration.config.

<credentials>
   <add name="ContosoUser" password="Encrypted-Password-Data" enabled="true" />
</credentials>

Пример кода

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

AppCmd.exe

Примечание

Вы не можете настроить <system.webServer/management/authentication> параметры с помощью AppCmd.exe.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetAdministrationConfiguration();

         ConfigurationSection authenticationSection = config.GetSection("system.webServer/management/authentication");
         ConfigurationElementCollection credentialsCollection = authenticationSection.GetCollection("credentials");
         ConfigurationElement addElement = credentialsCollection.CreateElement("add");
         addElement["name"] = @"ContosoUser";
         addElement["password"] = @"P@ssw0rd";
         addElement["enabled"] = true;
         credentialsCollection.Add(addElement);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetAdministrationConfiguration

      Dim authenticationSection As ConfigurationSection = config.GetSection("system.webServer/management/authentication")
      Dim credentialsCollection As ConfigurationElementCollection = authenticationSection.GetCollection("credentials")
      Dim addElement As ConfigurationElement = credentialsCollection.CreateElement("add")
      addElement("name") = "ContosoUser"
      addElement("password") = "P@ssw0rd"
      credentialsCollection.Add(addElement)
      addElement("enabled") = True
      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject("Microsoft.ApplicationHost.WritableAdminManager"); 
adminManager.CommitPath = "MACHINE/WEBROOT"; 
adminManager.SetMetadata("pathMapper", "AdministrationConfig");

var authenticationSection = adminManager.GetAdminSection("system.webServer/management/authentication", "MACHINE/WEBROOT"); 
var credentialsCollection = authenticationSection.ChildElements.Item("credentials").Collection;

var addElement = credentialsCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "ContosoUser";
addElement.Properties.Item("password").Value = "P@ssw0rd";
addElement.Properties.Item("enabled").Value = true;
credentialsCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT"
adminManager.SetMetadata "pathMapper", "AdministrationConfig"

Set authenticationSection = adminManager.GetAdminSection("system.webServer/management/authentication", "MACHINE/WEBROOT")
Set credentialsCollection = authenticationSection.ChildElements.Item("credentials").Collection

Set addElement = credentialsCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "ContosoUser"
addElement.Properties.Item("password").Value = "P@ssw0rd"
addElement.Properties.Item("enabled").Value = True
credentialsCollection.AddElement(addElement)

adminManager.CommitChanges()