Образец кода: простые формы ASP.NET

В этом примере демонстрируется, как реализовать Служба управления доступом с помощью приложения веб-форм ASP.NET. Код для этого примера расположен в подкаталоге ASPNETSimpleForms (C#\Websites/ASPNETSimpleForms) пакета Примеры кода для контроля доступа в Microsoft Azure Active Directory.

Предварительные требования

Для запуска этого примера вам потребуется:

Учетная запись на портале Azure и Пространство имен Access Control.

Visual Studio 2010 (любая версия).

Пакет SDK Windows Identity Foundation.

Настройка примера

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

Вариант 1. Настройка примера с помощью портала управления Служба управления доступом

Вариант 2. Настройка примера с помощью службы управления Служба управления доступом

Вариант 1. Настройка примера с помощью портала управления Служба управления доступом

Настройка примера с помощью портала управления Служба управления доступом

Перейдите на портал управления Microsoft Azure, выполните вход и щелкните Active Directory. (Совет по устранению неполадок. Элемент "Active Directory" отсутствует или недоступен)

Чтобы создать пространство имен Access Control, щелкните Создать, Службы приложений, Управление доступом, а затем выберите Быстрое создание. (Или щелкните Пространства имен Access Control перед тем, как щелкнуть Создать.)

Для выполнения управления пространством имен Access Control выберите пространство имен и щелкните Управление. (Или щелкните Пространства имен Access Control, выберите пространство имен, а затем щелкните Управление.)

Это действие открывает портал управления Access Control Service.

Чтобы установить связь с поставщиками удостоверений, которые пользователи смогут использовать при входе, щелкните Поставщики удостоверений и добавьте Yahoo! и Google. Затем нажмите кнопку Домашняя страница, чтобы вернуться на главную страницу.

Чтобы зарегистрировать приложение в Служба управления доступом, щелкните Приложения проверяющей стороны, нажмите кнопку Добавить, а затем введите следующие данные в форме:

В поле Имя введите Пример простых форм ASP .NET.

В поле Область введите https://localhost:62000/.

В поле URL-адрес области введите https://localhost:62000/.

В раскрывающемся списке Формат токена выберите SAML 2.0.

В разделе Поставщики удостоверений выберите Google, Windows Live ID и Yahoo!

В поле Подпись токена выберите Использовать сертификат пространства имен службы (стандартный).

Оставьте значения по умолчанию в других полях.

Щелкните кнопку Сохранить и перейдите на главную страницу.

После регистрации приложения проверяющей стороны можно создать правила, определяющие утверждения, которые Служба управления доступом будет выдавать приложению. В этом примере мы просто передадим все утверждения, выданные поставщиком удостоверений. Чтобы создать это правило, щелкните кнопку Группы правил, а затем нажмите Группа правил по умолчанию для примера простых форм ASP .NET. В нижней части страницы щелкните ссылку Создать. Убедитесь, что выбраны три поставщика удостоверений: Yahoo!, Google и — и щелкните кнопку Создать. Наконец, щелкните кнопку Сохранить и вернитесь на главную страницу.

Настроив Служба управления доступом, откройте Visual Studio.

Вариант 2. Настройка примера с помощью службы управления Служба управления доступом

Настройка примера с помощью службы управления Служба управления доступом

Чтобы настроить пример, откройте файл SamplesConfiguration.cs (acs\Management\ManagementService\Common). Замените заполнители в классе SamplesConfiguration в общей библиотеке классов на данные о вашей службе Пространство имен Access Control. Эти сведения можно найти на портале управления Служба управления доступом.

Перейдите на портал управления Служба управления доступом. Перейдите на портал управления Microsoft Azure, выполните вход и щелкните Active Directory. (Совет по устранению неполадок. Элемент "Active Directory" отсутствует или недоступен) Для выполнения управления пространством имен Access Control выберите пространство имен и щелкните Управление. (Или щелкните Пространства имен Access Control, выберите пространство имен, а затем щелкните Управление.)

ServiceNamespace— введите имя вашей службы Пространство имен Access Control.

ManagementServiceIdentityName— введите имя учетной записи службы управления Служба управления доступом. По умолчанию используется значение ManagementClient.

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

ManagementServiceIdentityKey— введите пароль учетной записи службы управления.

Чтобы найти пароль учетной записи службы управления, на портале управления Служба управления доступом щелкните Служба управления. Щелкните имя учетной записи службы управления, а затем в разделе Учетные данные щелкните Пароль. Пароль отображается в поле Пароль. Чтобы скопировать пароль, нажмите кнопку Показать пароль.

Запустите приложение ConfigureSample в службе Visual Studio, которая настроит Служба управления доступом для запуска этого примера.

Запуск примера

Процедура запуска примера

Откройте пример, расположенный в каталоге Websites\ASPNETSimpleForms\ASPNETSimpleForms.sln службы Visual Studio.

Чтобы запустить приложение, нажмите клавишу F5.

Закройте браузер, чтобы остановить приложение.

Щелкните правой кнопкой мыши проект и в контекстном меню нажмите кнопку Добавить ссылку на службы токенов безопасности.

В диалоговом окне введите корень веб-приложения в поле Универсальный код ресурса приложения и нажмите кнопку Далее. Значение для этого примера —https://localhost:62000/.

Косая черта в конце важна, поскольку она соответствует значениям, введенным в Служба управления доступом для проверяющей стороны. Мастер отобразит предупреждение, что сайт не использует SSL. Примите предупреждение, щелкнув кнопку Да , но помните, что рабочий веб-сайт должен практически всегда использовать SSL для таких типов сценариев.

В следующем окне щелкните переключатель Использовать существующую службу токенов безопасности и введите универсальный код ресурса метаданных WS-Federation, опубликованный Пространство имен Access Control. Такой универсальный код ресурса можно найти на портале в разделе Интеграция приложений. Если Пространство имен Access Control является acssamples, универсальный код ресурса —https://acssamples. accesscontrol.windows.net/FederationMetadata/2007-06/FederationMetadata.xml. После того, как вы введете значение, нажмите кнопку Далее.

Поскольку ваш веб-сайт не требует зашифрованных токенов, нажмите кнопку Далее в оставшихся диалоговых окнах, а затем —Готово.

После этого и Служба управления доступом, и ваше приложение будут настроены. Нажмите клавишу F5 в Visual Studio, чтобы запустить приложение. Браузер откроет размещенную страницу обнаружения домашней области Служба управления доступом.

Щелкните Yahoo! или Google, чтобы перейти на этого поставщика удостоверений.

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