Freigeben über


WSFederationAuthenticationModule.Realm Eigenschaft

Definition

Dient zum Abrufen oder Festlegen des Werts des wtrealm-Parameters, der für WS-Federation Anmeldeanforderungen ("wsignin1.0") verwendet werden soll.

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

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

Ausnahmen

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

- oder -

Es wird 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 das RP für den STS. (Informationen zum Identifizieren des STS für das RP finden Sie in der Issuer Eigenschaft).

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

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

Gilt für: