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 Issuer propriedade para obter um token de segurança usando o protocolo WS-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 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. Para obter mais informações, consulte o CreateSignInRequest(String, String, Boolean) método.
- 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 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.
Exceções
Issuer é ou uma null cadeia de caracteres vazia.
- ou -
Realm é ou uma null cadeia de caracteres vazia.
- ou -
A Current propriedade está ou está null vazia.
- ou -
A Response propriedade do contexto retornado é Current ou vazia null .
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 OnEndRequest representante do manipulador de 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 que o RP deve direcionar o navegador para a autenticação bem-sucedida a seguir. 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 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 das 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.
