WSFederationAuthenticationModule.RedirectToIdentityProvider Methode

Definition

Namespace:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Leitet den Benutzer zum Sicherheitstokendienst (STS) weiter, der von der Issuer-Eigenschaft angegeben wird, um ein Sicherheitstoken mit dem WS-Verbund-Protokoll zu erhalten.

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)

Parameter

uniqueId

String

WSFAM speichert diesen Wert im wctx-Parameter in der WS-Verbund-Anmeldungsanforderung. Allerdings verwendet das Modul den Wert nicht, wenn es Anmeldungsanforderungen oder Anmeldungsantworten verarbeitet. Sie können jeden beliebigen Wert festlegen. Er muss nicht eindeutig sein. Weitere Informationen finden Sie unter der Methode CreateSignInRequest(String, String, Boolean).

returnUrl

String

Die URL, zu der das Modul nach der Authentifizierung zurückkehren soll.

persist

Boolean

WSFAM speichert diesen Wert im wctx-Parameter in der WS-Verbund-Anmeldungsanforderung. Allerdings verwendet das Modul den Wert nicht, wenn es Anmeldungsanforderungen oder Anmeldungsantworten verarbeitet. Sie können den Wert auf true oder false festlegen.

Ausnahmen

InvalidOperationException

Der Issuer ist null oder eine leere Zeichenfolge.

- oder -

Der Realm ist null oder eine leere Zeichenfolge.

- oder -

Die Current-Eigenschaft ist null oder leer.

- oder -

Die Response-Eigenschaft des Kontexts, zurückgegeben von Current, ist null oder leer.

Hinweise

Die RedirectToIdentityProvider -Methode wird von der SignIn -Methode aufgerufen, wenn die Anforderung von einer Webseite ausgegeben wird, die von der vertrauenden Seite (RP) präsentiert wird, oder vom OnEndRequest Ereignishandlerdelegat, um bei Autorisierungsfehlern eine passive Umleitung an den Identitätsanbieter auszuführen.

Die an die -Methode übergebenen Parameter werden verwendet, um den wctx-Meldungsparameter zu erstellen. Der einzige signifikante Parameter ist der returnUrl -Parameter. Dies gibt die URL an, an die der Rp den Browser nach erfolgreicher Authentifizierung weiterleiten soll. Er sollte nicht mit dem wreply message-Parameter verwechselt werden, der von der Reply -Eigenschaft angegeben wird und der die Adresse am Rp angibt, an die der Sicherheitstokendienst (SECURITY Token Service, STS) seine Antwort weiterleiten soll.

Die -Methode führt Folgendes aus:

1. Ruft die VerifyProperties -Methode auf, um sicherzustellen, dass eine gültige Anmeldeanforderung vom Modul ausgestellt werden kann.

2. Ruft die CreateSignInRequest -Methode auf, um die Anmeldeanforderung aus den für das Modul konfigurierten Eigenschaften zu erstellen.

3. Ruft die OnRedirectingToIdentityProvider -Methode auf, um das -Ereignis auszulösen RedirectingToIdentityProvider . Sie können die Umleitung abbrechen oder die Anmeldeanforderungsnachricht im Ereignishandler für dieses Ereignis ändern.