WSFederationAuthenticationModule.Realm Vlastnost

Definice

Obor názvů:

System.IdentityModel.Services

Sestavení:

System.IdentityModel.Services.dll

Získá nebo nastaví hodnotu parametru wtrealm, který se má použít pro WS-Federation žádosti o přihlášení ("wsignin1.0").

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

Hodnota vlastnosti

String

Identifikátor URI, který identifikuje předávající stranu (RP) ke službě tokenů zabezpečení (STS).

Výjimky

ArgumentException

Při pokusu o nastavení vlastnosti na nebo dojde k null prázdnému řetězci.

-nebo-

Dojde k pokusu o nastavení vlastnosti na hodnotu, která není platným absolutním identifikátorem URI.

Poznámky

Toto je požadovaná vlastnost pro WS-Federation žádosti o přihlášení. Pokud jsou povolená pasivní přesměrování, musí být nastavená. Identifikátor URI identifikuje rps pro sts. (Informace o identifikaci služby STS pro poskytovatele prostředků najdete ve Issuer vlastnosti).

Hodnota této vlastnosti je serializována jako parametr řetězce dotazu wtrealm v protokolu WS-Federation. Identifikuje rps služby STS. Služba zabezpečení ho používá k rozhodování, jaké zásady se mají použít pro vystavování tokenů a kam se má uživatel po vystavení tokenu přesměrovat. (Informace o identifikaci služby STS pro poskytovatele prostředků najdete v tématu Issuer.)

Toto nastavení můžete přepsat u každého požadavku HTTP přidáním obslužné rutiny RedirectingToIdentityProvider pro událost. Tato událost je vyvolána těsně před tím, než modul přesměruje na službu tokenů zabezpečení (STS) se zprávou o WS-Federation žádosti o přihlášení. Služba STS je určena Issuer vlastností .