WSFederationAuthenticationModule.Realm Propriedade

Definição

Namespace:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Obtém ou define o valor do parâmetro wtrealm a ser usado para solicitações de conexão da Web Services 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

Valor da propriedade

String

Um URI que identifica a RP (terceira parte confiável) para o STS (serviço de token de segurança).

Exceções

ArgumentException

Ocorre uma tentativa de definir a propriedade como null ou uma cadeia de caracteres vazia.

- ou -

Ocorre uma tentativa de definir a propriedade como um valor que não é um URI absoluto válido.

Comentários

Essa é uma propriedade necessária para WS-Federation solicitações de entrada. Ele deverá ser definido se os redirecionamentos passivos estiverem habilitados. O URI identifica o RP para o STS. (Para identificar o STS para o RP, consulte a Issuer propriedade ).

O valor dessa propriedade é serializado como o parâmetro wtrealm query string no protocolo WS-Federation. Ele identifica o RP para o STS. Ele é usado pelo STS para decidir qual política aplicar para emissão de token e para onde redirecionar o usuário após a emissão do token. (Para identificar o STS para o RP, consulte Issuer.)

Você pode substituir essa configuração em cada solicitação HTTP adicionando um manipulador para o RedirectingToIdentityProvider evento. Esse evento é gerado pouco antes de o módulo redirecionar para o STS (serviço de token de segurança) com uma mensagem de solicitação de entrada WS-Federation. O STS é especificado pela Issuer propriedade .