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

WSFederationAuthenticationModule.RedirectToIdentityProvider Метод

Определение

Пространство имен:
System.IdentityModel.Services
Сборка:
System.IdentityModel.Services.dll

Перенаправляет пользователя в службу маркеров безопасности (STS), указанную Issuer свойством, чтобы получить маркер безопасности с помощью протокола WS-Federation.

public:
 virtual void RedirectToIdentityProvider(System::String ^ uniqueId, System::String ^ returnUrl, bool persist);
public virtual void RedirectToIdentityProvider(string uniqueId, string returnUrl, bool persist);
abstract member RedirectToIdentityProvider : string * string * bool -> unit
override this.RedirectToIdentityProvider : string * string * bool -> unit
Public Overridable Sub RedirectToIdentityProvider (uniqueId As String, returnUrl As String, persist As Boolean)

Параметры

uniqueId
String

WSFAM сохраняет это значение в параметре wctx в запросе на вход WS-Federation; Однако модуль не использует его при обработке запросов входа или ответов на вход. Его можно задать для любого значения. Это имя не обязательно должно быть уникальным. Дополнительные сведения см. в методе CreateSignInRequest(String, String, Boolean).

returnUrl
String

URL-адрес, в который модуль должен вернуться при проверке подлинности.

persist
Boolean

WSFAM сохраняет это значение в параметре wctx в запросе на вход WS-Federation; Однако модуль не использует его при обработке запросов входа или ответов на вход. Его можно задать true или false.

Исключения

InvalidOperationException

Issuer имеет null или пустую строку.

–или–

Realm имеет null или пустую строку.

–или–

Свойство Current равно null или пусто.

–или–

Свойство Response контекста, возвращаемое Currentnull или пустое.

Комментарии

Метод RedirectToIdentityProvider вызывается из SignIn метода, когда запрос выдается с веб-страницы, представленной проверяющей стороной (RP) или делегатом OnEndRequest обработчика событий, чтобы выполнить пассивное перенаправление поставщику удостоверений при сбое авторизации.

Параметры, передаваемые методу, используются для создания параметра сообщения wctx. Единственным важным параметром returnUrl является параметр. Это указывает URL-адрес, который RP должен направлять браузер к успешной проверке подлинности. Не следует путать с параметром сообщения wreply, который указывается Reply свойством и который предоставляет адрес в RP, к которому служба маркеров безопасности (STS) должна направлять свой ответ.

Метод выполняет следующее:

  1. VerifyProperties Вызывает метод, чтобы убедиться, что допустимый запрос на вход может быть выдан модулем.

  2. CreateSignInRequest Вызывает метод для создания запроса на вход из свойств, настроенных в модуле.

  3. OnRedirectingToIdentityProvider Вызывает метод для вызова RedirectingToIdentityProvider события. Вы можете отменить перенаправление или изменить сообщение запроса входа в обработчик событий для этого события.

Применяется к