WSFederationAuthenticationModule.CreateSignInRequest Método

  • Referencia

Definición

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

Crea una solicitud de inicio de sesión de WS-Federation en el mensaje de solicitud usando los parámetros de WS-Federation configurados en el módulo.

public:
 System::IdentityModel::Services::SignInRequestMessage ^ CreateSignInRequest(System::String ^ uniqueId, System::String ^ returnUrl, bool rememberMeSet);
public System.IdentityModel.Services.SignInRequestMessage CreateSignInRequest (string uniqueId, string returnUrl, bool rememberMeSet);
member this.CreateSignInRequest : string * string * bool -> System.IdentityModel.Services.SignInRequestMessage
Public Function CreateSignInRequest (uniqueId As String, returnUrl As String, rememberMeSet As Boolean) As SignInRequestMessage

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.

returnUrl
String

Dirección URL a la que el módulo debe volver después de la autenticación.

rememberMeSet
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.

Devoluciones

SignInRequestMessage

Mensaje de solicitud de inicio de sesión de WS-Federation.

Excepciones

InvalidOperationException

La propiedad Issuer es null o una cadena vacía.

O bien

La propiedad Realm es null o una cadena vacía.

Comentarios

Crea una solicitud de inicio de sesión WS-Federation representada por un SignInRequestMessage objeto . Las propiedades del nuevo SignInRequestMessage objeto se establecen de la siguiente manera:

  • La Context propiedad (el parámetro wctx) se establece en un valor creado mediante los parámetros del método .

  • La CurrentTime propiedad (el parámetro wct) se establece en la hora actual.

  • Todas las demás propiedades se establecen mediante las propiedades equivalentes de la instancia actual.

Los parámetros pasados al método se usan para crear el parámetro de mensaje wctx. Se trata de una cadena con el formato siguiente: ru=returnUrl&cx=SignInContext&rm=rememberMeSet&id=uniqueId.

  • El ru valor se establece en el valor del returnUrl parámetro pasado al método y especifica la dirección URL que el módulo debe dirigir al explorador para que siga la autenticación correcta. Este es el único valor almacenado en la cadena wctx que usa WSFAM. El módulo llama al GetReturnUrlFromResponse método para extraer este valor del parámetro wctx al procesar una respuesta de inicio de sesión WS-Federation. 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 cx parámetro se establece en el valor de la SignInContext propiedad . Esta propiedad se expone para permitirle establecer cualquier contexto definido por la aplicación que se debe almacenar en la cadena wctx; sin embargo, WSFAM no expone un método para extraer este valor en la respuesta. Si la aplicación necesita el valor, debe proporcionar el código para analizar la cadena wctx y leer este valor al procesar la respuesta. Para ello, invalide el GetReturnUrlFromResponse método .

  • WSFAM no usa el rm valor , que se establece en el valor del rememberMeSet parámetro , ni el id parámetro , que se establece en el valor del uniqueId parámetro . Se pueden establecer en cualquier valor.

Se CreateSignInRequest llama al método desde el RedirectToIdentityProvider método .

Se aplica a

Consulte también