Partilhar via

WSFederationAuthenticationModule.CreateSignInRequest Método

Definição

Namespace:
System.IdentityModel.Services
Assembly:
System.IdentityModel.Services.dll

Cria uma mensagem de solicitação de entrada WS-Federation usando os parâmetros de WS-Federation configurados no módulo.

public:
 System::IdentityModel::Services::SignInRequestMessage ^ CreateSignInRequest(System::String ^ uniqueId, System::String ^ returnUrl, bool rememberMeSet);
public System.IdentityModel.Services.SignInRequestMessage CreateSignInRequest(string uniqueId, string returnUrl, bool rememberMeSet);
member this.CreateSignInRequest : string * string * bool -> System.IdentityModel.Services.SignInRequestMessage
Public Function CreateSignInRequest (uniqueId As String, returnUrl As String, rememberMeSet As Boolean) As SignInRequestMessage

Parâmetros

uniqueId
String

O WSFAM salva esse valor no parâmetro wctx na solicitação de entrada WS-Federation; no entanto, o módulo não o usa ao processar solicitações de entrada ou respostas de entrada. Você pode defini-lo como qualquer valor. Não precisa ser exclusivo.

returnUrl
String

A URL para a qual o módulo deve retornar após a autenticação.

rememberMeSet
Boolean

O WSFAM salva esse valor no parâmetro wctx na solicitação de entrada WS-Federation; no entanto, o módulo não o usa ao processar solicitações de entrada ou respostas de entrada. Você pode defini-lo true ou false.

Retornos

SignInRequestMessage

O WS-Federation mensagem de solicitação de entrada.

Exceções

InvalidOperationException

A Issuer propriedade é ou uma null cadeia de caracteres vazia.

- ou -

A Realm propriedade é ou uma null cadeia de caracteres vazia.

Comentários

Cria uma solicitação de entrada WS-Federation representada por um SignInRequestMessage objeto. As propriedades do novo SignInRequestMessage objeto são definidas da seguinte maneira:

  • A Context propriedade (o parâmetro wctx) é definida como um valor criado usando os parâmetros do método.

  • A CurrentTime propriedade (o parâmetro wct) é definida como a hora atual.

  • Todas as outras propriedades são definidas usando as propriedades equivalentes da instância atual.

Os parâmetros passados para o método são usados para criar o parâmetro de mensagem wctx. Essa é uma cadeia de caracteres com o seguinte formato: ru=returnUrl&cx=SignInContext&rm=rememberMeSet&id=uniqueId.

  • O ru valor é definido como o valor do returnUrl parâmetro passado para o método e especifica a URL que o módulo deve direcionar o navegador para a autenticação bem-sucedida a seguir. Esse é o único valor armazenado na cadeia de caracteres wctx usada pelo WSFAM. O módulo chama o GetReturnUrlFromResponse método para extrair esse valor do parâmetro wctx ao processar uma resposta de entrada WS-Federation. Ele não deve ser confundido com o parâmetro de mensagem wreply, que é especificado pela Reply propriedade e que fornece o endereço no RP para o qual o STS (serviço de token de segurança) deve direcionar sua resposta.

  • O cx parâmetro é definido como o valor da SignInContext propriedade. Essa propriedade é exposta para permitir que você defina qualquer contexto definido pelo aplicativo que deve ser armazenado na cadeia de caracteres wctx; no entanto, o WSFAM não expõe um método para extrair esse valor na resposta. Se o valor for necessário para seu aplicativo, você deverá fornecer o código para analisar a cadeia de caracteres wctx e ler esse valor ao processar a resposta. Você pode fazer isso substituindo o GetReturnUrlFromResponse método.

  • Nem o rm valor, que é definido como o valor do rememberMeSet parâmetro, nem o id parâmetro, que é definido como o valor do uniqueId parâmetro são usados pelo WSFAM. Elas podem ser definidas como qualquer valor.

O CreateSignInRequest método é chamado do RedirectToIdentityProvider método.

Aplica-se a

Confira também