SignInRequestMessage Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa uma mensagem de pedido de início de sessão WS-Federation.
public ref class SignInRequestMessage : System::IdentityModel::Services::WSFederationMessagepublic class SignInRequestMessage : System.IdentityModel.Services.WSFederationMessagetype SignInRequestMessage = class
inherit WSFederationMessagePublic Class SignInRequestMessage
Inherits WSFederationMessage- Herança
Exemplos
string identityProviderUri = Request.QueryString["whr"];
string action = Request.QueryString["wa"];
SignInRequestMessage signInRequest = FederatedAuthentication.WSFederationAuthenticationModule.CreateSignInRequest(Guid.NewGuid().ToString(),
"http://MyAppreturnUrl",
false);
signInRequest.Realm = "htp://MyApp.com";
signInRequest.HomeRealm = identityProviderUri;
Response.Redirect(signInRequest.RequestUrl);
Observações
Uma mensagem de início de sessão WS-Federation é enviada por uma parte confiável (RP) a um serviço de token de segurança (STS) para solicitar um token de segurança. O parâmetro wa deve ser definido como "wsignin1.0" e o parâmetro wtrealm deve ser definido como o domínio de segurança do recurso solicitado (este é frequentemente o URL do recurso solicitado). Outros parâmetros opcionais também podem ser especificados no pedido.
Uma SignInRequestMessage mensagem é criada pelos métodos estáticos da SignInRequestMessage classe, por exemplo, o CreateFromUri método, quando o parâmetro wa está definido como "wsignin1.0", não wresult há nenhum parâmetro wresultptr presente, e está presente ou um wtrealm parâmetro ou um wreply parâmetro.
Importante
Para compatibilidade retroativa com a versão 1.0 do Serviços de Federação do Active Directory (AD FS) (AD FS), Windows Identity Foundation (WIF) permite definir (ou ambos) o parâmetro wtrealm ou o parâmetro wreply para que uma mensagem de início de sessão seja válida; no entanto, o protocolo WS-Federation exige que o parâmetro wtrealm esteja presente num pedido de entrada. Na maioria dos cenários, deve garantir que o parâmetro wtrealm está especificado.
A SignInRequestMessage classe expõe várias propriedades que podem ser usadas para definir ou aceder a parâmetros individuais das mensagens. Estes parâmetros também podem ser definidos ou acedidos através do Parameters dicionário. Por exemplo, pode ler o parâmetro wtrealm na mensagem através da Realm propriedade ou especificando "wtrealm" como chave do Parameters dicionário.
Para mais informações sobre a mensagem que esta classe representa, consulte a secção 13 da seguinte especificação: Web Services Federation Language (WS-Federation) Versão 1.2.
Construtores
| Name | Description |
|---|---|
| SignInRequestMessage(Uri, String, String) |
Inicializa uma nova instância da SignInRequestMessage classe usando o URI base, o parâmetro wtrealm e o parâmetro wreply especificados. Suporta criação de mensagens não padrão para compatibilidade retroativa. |
| SignInRequestMessage(Uri, String) |
Inicializa uma nova instância da SignInRequestMessage classe com a URL base e o parâmetro wtrealm especificados. |
Propriedades
| Name | Description |
|---|---|
| Action |
Obtém ou define o parâmetro wa da mensagem. (Herdado de WSFederationMessage) |
| AuthenticationType |
Obtém ou define o parâmetro wauth da mensagem. |
| BaseUri |
Obtém ou define o URL base ao qual a mensagem se aplica. (Herdado de FederationMessage) |
| Context |
Obtém ou define o parâmetro wctx da mensagem. (Herdado de WSFederationMessage) |
| CurrentTime |
Obtém ou define o parâmetro wct da mensagem. |
| Encoding |
Obtém ou define o parâmetro wencoding da mensagem. (Herdado de WSFederationMessage) |
| Federation |
Obtém ou define o parâmetro wfed da mensagem. |
| Freshness |
Obtém ou define o parâmetro wfresh da mensagem. |
| HomeRealm |
Obtém ou define o parâmetro whr da mensagem. |
| Parameters |
Obtém os parâmetros da mensagem como um dicionário. (Herdado de FederationMessage) |
| Policy |
Obtém ou define o parâmetro wp da mensagem. |
| Realm |
Obtém ou define o parâmetro wtrealm da mensagem. |
| Reply |
Obtém ou define o parâmetro wreply da mensagem. |
| Request |
Obtém ou define o parâmetro wreq da mensagem. |
| RequestPtr |
Obtém ou define o parâmetro wreqptr da mensagem. |
| RequestUrl |
Obtém uma representação em cadeia do URL que corresponde a esta mensagem. |
| Resource |
Obtém ou define o parâmetro wres da mensagem. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetParameter(String) |
Devolve o valor do parâmetro especificado do dicionário de parâmetros. (Herdado de FederationMessage) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| RemoveParameter(String) |
Remove um parâmetro do dicionário de parâmetros. (Herdado de FederationMessage) |
| SetParameter(String, String) |
Define o valor de um parâmetro no dicionário de parâmetros. (Herdado de FederationMessage) |
| SetUriParameter(String, String) |
Define o valor de um parâmetro no dicionário de parâmetros. O valor deve ser um URI absoluto. (Herdado de FederationMessage) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| Validate() |
Valida a instância atual. |
| Write(TextWriter) |
Escreve esta mensagem em forma de string de consulta para o autor do texto especificado. |
| WriteFormPost() |
Serializa a mensagem como um form post e devolve o Form resultante juntamente com o seu Javascript como uma string. (Herdado de FederationMessage) |
| WriteQueryString() |
Devolve uma representação de string da mensagem em formato de query string. (Herdado de FederationMessage) |
