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 контекста, возвращаемого свойством Current, имеет значение null или пусто.

Комментарии

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

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

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

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

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

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