WSFederationAuthenticationModule.Realm Właściwość

Definicja

Przestrzeń nazw:

System.IdentityModel.Services

Zestaw:

System.IdentityModel.Services.dll

Pobiera lub ustawia wartość parametru wtrealm do użycia dla żądań logowania WS-Federation ("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

Wartość właściwości

String

Identyfikator URI identyfikujący jednostkę uzależnioną (RP) do usługi tokenu zabezpieczającego (STS).

Wyjątki

ArgumentException

Następuje próba ustawienia właściwości na null lub pusty ciąg.

-lub-

Podjęto próbę ustawienia właściwości na wartość, która nie jest prawidłowym, bezwzględnym identyfikatorem URI.

Uwagi

Jest to wymagana właściwość żądań logowania WS-Federation. Należy ją ustawić, jeśli włączono pasywne przekierowania. Identyfikator URI identyfikuje dostawcę usług w usłudze STS. (Aby zidentyfikować usługę STS do dostawcy usług, zobacz Issuer właściwość ).

Wartość tej właściwości jest serializowana jako parametr ciągu zapytania wtrealm w protokole WS-Federation. Identyfikuje on dostawcę usług w usłudze STS. Jest on używany przez usługę STS, aby zdecydować, jakie zasady mają zostać zastosowane do wystawiania tokenów i gdzie przekierować użytkownika do po wystawieniu tokenu. (Aby zidentyfikować usługę STS do rp, zobacz Issuer.)

To ustawienie można zastąpić dla każdego żądania HTTP, dodając procedurę obsługi dla RedirectingToIdentityProvider zdarzenia. To zdarzenie jest zgłaszane tuż przed przekierowanie modułu do usługi tokenu zabezpieczającego (STS) przy użyciu WS-Federation komunikatu o żądaniu logowania. Usługa STS jest określana przez Issuer właściwość .