WSFederationAuthenticationModule.Realm Eigenschaft

Definition

Namespace:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Ruft den Wert des „wtrealm“-Parameters für die Verwendung bei WS-Verbund-Anmeldeanforderungen („wsignin1.0“) ab oder legt diesen fest.

public:
 property System::String ^ Realm { System::String ^ get(); void set(System::String ^ value); };

public string Realm { get; set; }

member this.Realm : string with get, set

Public Property Realm As String

Eigenschaftswert

String

Ein URI, der die vertrauende Seite (RP) an den Sicherheitstokendienst (STS) identifiziert.

Ausnahmen

ArgumentException

Es wurde versucht, die Eigenschaft auf null oder eine leere Zeichenfolge festzulegen.

- oder -

Es wurde versucht, die Eigenschaft auf einen Wert festzulegen, der kein gültiger, absoluter URI ist.

Hinweise

Dies ist eine erforderliche Eigenschaft für WS-Federation Anmeldeanforderungen. Sie muss festgelegt werden, wenn passive Umleitungen aktiviert sind. Der URI identifiziert den RP für den STS. (Informationen zum Identifizieren des STS für den RP finden Sie in der Issuer -Eigenschaft.

Der Wert dieser Eigenschaft wird als wtrealm-Abfragezeichenfolgenparameter in WS-Federation Protokoll serialisiert. Er identifiziert den RP mit dem STS. Es wird vom STS verwendet, um zu entscheiden, welche Richtlinie für die Tokenausstellung angewendet werden soll und wohin der Benutzer nach der Tokenausstellung umgeleitet werden soll. (Informationen zum Identifizieren des STS für den RP finden Sie unter Issuer.)

Sie können diese Einstellung bei jeder HTTP-Anforderung überschreiben, indem Sie einen Handler für das RedirectingToIdentityProvider Ereignis hinzufügen. Dieses Ereignis wird unmittelbar vor der Umleitung des Moduls an den Sicherheitstokendienst (STS) mit einer WS-Federation Anmeldeanforderungsnachricht ausgelöst. Der STS wird von der Issuer -Eigenschaft angegeben.