WSFederationAuthenticationModule.RedirectToIdentityProvider Método

  • Referencia

Definición

Espacio de nombres:
System.IdentityModel.Services
Ensamblado:
System.IdentityModel.Services.dll

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 -> unit
Public 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

InvalidOperationException

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 . Esto 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:

  1. Invoca el VerifyProperties método para asegurarse de que el módulo pueda emitir una solicitud de inicio de sesión válida.

  2. Invoca el CreateSignInRequest método para crear la solicitud de inicio de sesión a partir de las propiedades configuradas en el módulo.

  3. 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 para este evento.

Se aplica a