WSFederationAuthenticationModule.CreateSignInRequest 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í.
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.SignInRequestMessagePublic Function CreateSignInRequest (uniqueId As String, returnUrl As String, rememberMeSet As Boolean) As SignInRequestMessagePará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
Mensaje de solicitud de inicio de sesión de WS-Federation.
Excepciones
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
ruvalor se establece en el valor delreturnUrlpará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
cxpará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
rmvalor , que se establece en el valor delrememberMeSetparámetro , ni elidparámetro , que se establece en el valor deluniqueIdparámetro . Se pueden establecer en cualquier valor.
Se CreateSignInRequest llama al método desde el RedirectToIdentityProvider método .
