WSFederationAuthenticationModule.CreateSignInRequest Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.IdentityModel.Services
Assembly:
System.IdentityModel.Services.dll

Crea un messaggio di richiesta di accesso di WS-Federation utilizzando i parametri di WS-Federation configurati nel modulo.

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

Parametri

uniqueId
String

Il modulo WSFAM salva questo valore nel parametro wctx nella richiesta di accesso WS-Federation; tuttavia non lo utilizza quando elabora le richieste o le risposte di accesso. È possibile impostarlo su qualsiasi valore. Non è necessario che sia univoco.

returnUrl
String

URL cui deve tornare il modulo dopo l'autenticazione.

rememberMeSet
Boolean

Il modulo WSFAM salva questo valore nel parametro wctx nella richiesta di accesso WS-Federation; tuttavia non lo utilizza quando elabora le richieste o le risposte di accesso. È possibile impostarlo su true o false.

Restituisce

SignInRequestMessage

Messaggio di richiesta di accesso WS-Federation.

Eccezioni

InvalidOperationException

La proprietà Issuer è null o una stringa vuota.

-oppure-

La proprietà Realm è null o una stringa vuota.

Commenti

Crea una richiesta di accesso WS-Federation rappresentata da un SignInRequestMessage oggetto . Le proprietà del nuovo SignInRequestMessage oggetto sono impostate come segue:

  • La Context proprietà (parametro wctx) è impostata su un valore creato usando i parametri del metodo.

  • La CurrentTime proprietà (il parametro wct) è impostata sull'ora corrente.

  • Tutte le altre proprietà vengono impostate usando le proprietà equivalenti dell'istanza corrente.

I parametri passati al metodo vengono usati per creare il parametro del messaggio wctx. Si tratta di una stringa con il formato seguente: ru=returnUrl&cx=SignInContext&rm=rememberMeSet&id=uniqueId.

  • Il ru valore è impostato sul valore del returnUrl parametro passato al metodo e specifica l'URL che il modulo deve indirizzare il browser a eseguire l'autenticazione riuscita. Questo è l'unico valore archiviato nella stringa wctx utilizzata da WSFAM. Il modulo chiama il metodo per estrarre questo valore dal parametro wctx durante l'elaborazione GetReturnUrlFromResponse di una risposta di accesso WS-Federation. Non deve essere confuso con il parametro del messaggio wreply, specificato dalla Reply proprietà e che fornisce l'indirizzo in corrispondenza del quale il servizio token di sicurezza (STS) deve indirizzarne la risposta.

  • Il cx parametro è impostato sul valore della SignInContext proprietà. Questa proprietà viene esposta per consentire di impostare qualsiasi contesto definito dall'applicazione che deve essere archiviato nella stringa wctx; Tuttavia, WSFAM non espone un metodo per estrarre questo valore nella risposta. Se il valore è necessario per l'applicazione, è necessario specificare il codice per analizzare la stringa wctx e leggere questo valore durante l'elaborazione della risposta. È possibile eseguire questa operazione eseguendo l'override del GetReturnUrlFromResponse metodo.

  • rm Né il valore, impostato sul valore del rememberMeSet parametro, né il id parametro, impostato sul valore del uniqueId parametro vengono usati da WSFAM. Questi valori possono essere impostati su qualsiasi valore.

Il CreateSignInRequest metodo viene chiamato dal RedirectToIdentityProvider metodo .

Si applica a

Vedi anche