WSFederationAuthenticationModule.RedirectToIdentityProvider Metoda

Definicja

Przestrzeń nazw:

System.IdentityModel.Services

Zestaw:

System.IdentityModel.Services.dll

Przekierowuje użytkownika do usługi tokenu zabezpieczającego (STS) określonej przez Issuer właściwość w celu uzyskania tokenu zabezpieczającego przy użyciu protokołu 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)

Parametry

uniqueId

String

WSFAM zapisuje tę wartość w parametrze wctx w żądaniu logowania WS-Federation; Jednak moduł nie używa go podczas przetwarzania żądań logowania lub odpowiedzi logowania. Można ustawić ją na dowolną wartość. Nie musi być wyjątkowy. Aby uzyskać więcej informacji, zobacz metodę CreateSignInRequest(String, String, Boolean) .

returnUrl

String

Adres URL, do którego moduł powinien zostać zwrócony po uwierzytelnieniu.

persist

Boolean

WSFAM zapisuje tę wartość w parametrze wctx w żądaniu logowania WS-Federation; Jednak moduł nie używa go podczas przetwarzania żądań logowania lub odpowiedzi logowania. Można go ustawić albo truefalse.

Wyjątki

InvalidOperationException

Issuer jest null ciągiem lub ciągiem pustym.

-lub-

Realm jest null ciągiem lub ciągiem pustym.

-lub-

Właściwość jest null pusta lub jest pustaCurrent.

-lub-

Właściwość Response kontekstu zwróconego przez Current element jest null pusta lub jest pusta.

Uwagi

Metoda RedirectToIdentityProvider jest wywoływana z SignIn metody, gdy żądanie jest wystawiane ze strony internetowej przedstawionej przez jednostkę uzależnioną (RP) lub od OnEndRequest delegata programu obsługi zdarzeń w celu wykonania pasywnego przekierowania do dostawcy tożsamości w przypadku niepowodzenia autoryzacji.

Parametry przekazywane do metody są używane do tworzenia parametru komunikatu wctx. Jedynym znaczącym parametrem returnUrl jest parametr . Określa adres URL, pod którym dostawca usługi ma przekierować przeglądarkę do po pomyślnym uwierzytelnieniu. Nie należy go mylić z wreply parametr komunikatu, który jest określony przez Reply właściwość i który dostarcza adres w rp, do którego usługa tokenu zabezpieczającego (STS) powinna kierować jego odpowiedź.

Metoda wykonuje następujące czynności:

1. Wywołuje metodę VerifyProperties , aby upewnić się, że moduł może wysłać prawidłowe żądanie logowania.

2. Wywołuje metodę CreateSignInRequest w celu utworzenia żądania logowania na podstawie właściwości skonfigurowanych w module.

3. Wywołuje metodę OnRedirectingToIdentityProvider w celu wywołania RedirectingToIdentityProvider zdarzenia. Możesz anulować przekierowanie lub zmodyfikować komunikat żądania logowania w programie obsługi zdarzeń dla tego zdarzenia.