WSFederationAuthenticationModule.RedirectToIdentityProvider Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Redirige al usuario al servicio de token de seguridad (STS) especificado por la propiedad Issuer para obtener un token de seguridad con el 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
El WSFAM guarda este valor en el parámetro wctx de la solicitud de inicio de sesión de WS-Federation; sin embargo, el módulo no lo usa al procesar solicitudes o respuestas de inicio de sesión. Puede establecerse en cualquier valor. No tiene que ser único. Para obtener más información, vea el método CreateSignInRequest(String, String, Boolean).
- returnUrl
- String
Dirección URL a la que el módulo debe volver después de la autenticación.
- persist
- Boolean
El WSFAM guarda este valor en el parámetro wctx de la solicitud de inicio de sesión de WS-Federation; sin embargo, el módulo no lo usa al procesar solicitudes o respuestas de inicio de sesión. Puede establecerlo en true o false.
Excepciones
Issuer es null o una cadena vacía.
o bien
Realm es null o una cadena vacía.
o bien
La propiedad Current es null o está vacía.
O bien
La propiedad Response del contexto devuelto por Current es null o está vacía.
Comentarios
Se RedirectToIdentityProvider llama al método desde el SignIn método cuando la solicitud se emite desde una página web presentada por el usuario de confianza (RP) o desde el OnEndRequest delegado del controlador de eventos para realizar una redirección pasiva al proveedor de identidades en caso de error de autorización.
Los parámetros pasados al método se usan para crear el parámetro de mensaje wctx. El único parámetro significativo es el returnUrl parámetro . Especifica la dirección URL que el RP debe dirigir al explorador para que siga la autenticación correcta. No debe confundirse con el parámetro wreply message, especificado por la Reply propiedad y que proporciona la dirección en el RP al que el servicio de token de seguridad (STS) debe dirigir su respuesta.
El método realiza lo siguiente:
Invoca el VerifyProperties método para asegurarse de que el módulo puede emitir una solicitud de inicio de sesión válida.
Invoca el CreateSignInRequest método para crear la solicitud de inicio de sesión a partir de las propiedades configuradas en el módulo.
Invoca el OnRedirectingToIdentityProvider método para generar el RedirectingToIdentityProvider evento. Puede cancelar el redireccionamiento o modificar el mensaje de solicitud de inicio de sesión en el controlador de eventos de este evento.
