WSFederationAuthenticationModule.RedirectToIdentityProvider Método

Definição

Namespace:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Redireciona o usuário para o STS (serviço de token de segurança) especificado pela propriedade Issuer para obter o token de segurança usando o protocolo Web Services Federation.

public:
 virtual void RedirectToIdentityProvider(System::String ^ uniqueId, System::String ^ returnUrl, bool persist);

public virtual void RedirectToIdentityProvider (string uniqueId, string returnUrl, bool persist);

abstract member RedirectToIdentityProvider : string * string * bool -> unit
override this.RedirectToIdentityProvider : string * string * bool -> unit

Public Overridable Sub RedirectToIdentityProvider (uniqueId As String, returnUrl As String, persist As Boolean)

Parâmetros

uniqueId

String

O WSFAM salva esse valor no parâmetro wctx na solicitação de entrada do Web Services Federation, no entanto, o módulo não o utiliza ao processar solicitações de entrada ou respostas de entrada. Você pode defini-lo para qualquer valor. Não precisa ser exclusivo. Para obter mais informações, consulte o método CreateSignInRequest(String, String, Boolean).

returnUrl

String

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

persist

Boolean

O WSFAM salva esse valor no parâmetro wctx na solicitação de entrada do Web Services Federation, no entanto, o módulo não o utiliza ao processar solicitações de entrada ou respostas de entrada. É possível defini-lo como true ou false.

Exceções

InvalidOperationException

Issuer é null ou é uma cadeia de caracteres vazia.

- ou -

Realm é null ou é uma cadeia de caracteres vazia.

- ou -

A propriedade Current é null ou vazia.

- ou -

A propriedade Response do contexto retornado por Current é null ou vazia.

Comentários

O RedirectToIdentityProvider método é chamado do SignIn método quando a solicitação é emitida de uma página da Web apresentada pelo RP (terceira parte confiável) ou do delegado manipulador de OnEndRequest eventos para executar um redirecionamento passivo para o provedor de identidade em caso de falha de autorização.

Os parâmetros passados para o método são usados para criar o parâmetro de mensagem wctx. O único parâmetro significativo é o returnUrl parâmetro . Isso especifica a URL para a qual o RP deve direcionar o navegador para a autenticação bem-sucedida. Ele não deve ser confundido com o parâmetro wreply message, 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 método executa o seguinte:

1. Invoca o VerifyProperties método para garantir que uma solicitação de entrada válida possa ser emitida pelo módulo.

2. Invoca o CreateSignInRequest método para criar a solicitação de entrada com base nas propriedades configuradas no módulo.

3. Invoca o OnRedirectingToIdentityProvider método para acionar o RedirectingToIdentityProvider evento. Você pode cancelar o redirecionamento ou modificar a mensagem de solicitação de entrada no manipulador de eventos para esse evento.