Freigeben über

WSFederationAuthenticationModule.RedirectToIdentityProvider Methode

Definition

Namespace:
System.IdentityModel.Services
Assembly:
System.IdentityModel.Services.dll

Leitet den Benutzer an den von der Issuer Eigenschaft angegebenen Sicherheitstokendienst (Security Token Service, STS) um, um ein Sicherheitstoken mithilfe des WS-Federation-Protokolls abzurufen.

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-Federation Anmeldeanforderung; Das Modul verwendet es jedoch nicht beim Verarbeiten von Anmeldeanforderungen oder Anmeldeantworten. Sie können ihn auf einen beliebigen Wert festlegen. Er muss nicht eindeutig sein. Weitere Informationen finden Sie in der CreateSignInRequest(String, String, Boolean) Methode.

returnUrl
String

Die URL, an die das Modul bei der Authentifizierung zurückgegeben werden soll.

persist
Boolean

WSFAM speichert diesen Wert im wctx-Parameter in der WS-Federation Anmeldeanforderung; Das Modul verwendet es jedoch nicht beim Verarbeiten von Anmeldeanforderungen oder Anmeldeantworten. Sie können es entweder true oder false.

Ausnahmen

InvalidOperationException

Issuer ist null oder eine leere Zeichenfolge.

- oder -

Realm ist null oder eine leere Zeichenfolge.

- oder -

Die Current Eigenschaft ist null oder leer.

- oder -

Die Response Eigenschaft des zurückgegebenen Kontexts 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) oder vom OnEndRequest Ereignishandlerdelegat ausgegeben wird, um eine passive Umleitung an den Identitätsanbieter beim Autorisierungsfehler auszuführen.

Die an die Methode übergebenen Parameter werden verwendet, um den wctx-Nachrichtenparameter zu erstellen. Der einzige signifikante Parameter ist der returnUrl Parameter. Dadurch wird die URL angegeben, über die das RP den Browser an die erfolgreiche Authentifizierung weiterleiten soll. Es sollte nicht mit dem wreply-Nachrichtenparameter verwechselt werden, der von der Reply Eigenschaft angegeben wird und die Adresse an der RP bereitstellt, an die der Sicherheitstokendienst (Security Token Service, STS) seine Antwort leiten 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 eigenschaften zu erstellen, die im Modul konfiguriert sind.

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

Gilt für: