WSFederationAuthenticationModule.RedirectToIdentityProvider Método
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.
Redireciona o utilizador para o serviço de token de segurança (STS) 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 guarda este valor no parâmetro wctx no pedido de início de sessão WS-Federation; no entanto, o módulo não o utiliza ao processar pedidos ou respostas de início de sessão. Podes definir para qualquer valor. Não tem de ser único. Para obter mais informações, consulte o método CreateSignInRequest(String, String, Boolean).
- returnUrl
- String
O URL ao qual o módulo deve regressar após a autenticação.
- persist
- Boolean
O WSFAM guarda este valor no parâmetro wctx no pedido de início de sessão WS-Federation; no entanto, o módulo não o utiliza ao processar pedidos ou respostas de início de sessão. Pode defini-lo ou true .false
Exceções
Issuer é null ou uma corda vazia.
-ou-
Realm é null ou uma corda vazia.
-ou-
A Current propriedade está null ou vazia.
-ou-
A Response propriedade do contexto devolvida por Current é null ou vazia.
Observações
O RedirectToIdentityProvider método é chamado do SignIn método quando o pedido é emitido a partir de uma página web apresentada pela parte confiável (RP) ou pelo OnEndRequest delegado handler de eventos para realizar um redirecionamento passivo para o fornecedor de identidade em caso de falha de autorização.
Os parâmetros passados ao método são usados para criar o parâmetro da mensagem wctx. O único parâmetro significativo é o returnUrl parâmetro. Esta especifica a URL para a qual o RP deve encaminhar o navegador após a autenticação bem-sucedida. Não deve ser confundido com o parâmetro da mensagem wreply (wreply message), que é especificado pela Reply propriedade e que fornece o endereço no RP para o qual o serviço de token de segurança (STS) deve direcionar a sua resposta.
O método realiza o seguinte:
Invoca o VerifyProperties método para garantir que um pedido de entrada válido pode ser emitido pelo módulo.
Invoca o CreateSignInRequest método para criar o pedido de entrada a partir das propriedades configuradas no módulo.
Invoca o OnRedirectingToIdentityProvider método para elevar o RedirectingToIdentityProvider evento. Pode cancelar o redirecionamento ou modificar a mensagem de pedido de início de sessão no handler de eventos para este evento.