WSFederationAuthenticationModule.RedirectToIdentityProvider Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitPublic 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
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:
Invoca o VerifyProperties método para garantir que uma solicitação de entrada válida possa ser emitida pelo módulo.
Invoca o CreateSignInRequest método para criar a solicitação de entrada com base nas propriedades configuradas no módulo.
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.
