Condividi tramite

WSFederationAuthenticationModule.CreateSignInRequest Metodo

Definizione

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

Crea un messaggio di richiesta di accesso WS-Federation usando i parametri 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

WSFAM salva questo valore nel parametro wctx nella richiesta di accesso WS-Federation; Tuttavia, il modulo non lo usa durante l'elaborazione delle richieste di accesso o delle risposte di accesso. È possibile impostarlo su qualsiasi valore. Non è necessario che sia univoco.

returnUrl
String

URL a cui deve essere restituito il modulo al momento dell'autenticazione.

rememberMeSet
Boolean

WSFAM salva questo valore nel parametro wctx nella richiesta di accesso WS-Federation; Tuttavia, il modulo non lo usa durante l'elaborazione delle richieste di accesso o delle risposte di accesso. È possibile impostarlo true o false.

Restituisce

SignInRequestMessage

Messaggio di richiesta di accesso WS-Federation.

Eccezioni

InvalidOperationException

La Issuer proprietà è null o una stringa vuota.

oppure

La Realm proprietà è null o una stringa vuota.

Commenti

Crea una richiesta di accesso WS-Federation rappresentata da un SignInRequestMessage oggetto . Le proprietà del nuovo SignInRequestMessage oggetto vengono impostate nel modo seguente:

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

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

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

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

  • Il ru valore viene impostato sul valore del returnUrl parametro passato al metodo e specifica l'URL che il modulo deve indirizzare il browser al completamento dell'autenticazione. Questo è l'unico valore archiviato nella stringa wctx utilizzata da WSFAM. Il modulo chiama il GetReturnUrlFromResponse metodo per estrarre questo valore dal parametro wctx durante l'elaborazione 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 punto di ripristino a cui il servizio token di sicurezza (STS) deve indirizzare 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 fornire il codice per analizzare la stringa wctx e leggere questo valore durante l'elaborazione della risposta. A tale scopo, è possibile eseguire l'override del GetReturnUrlFromResponse metodo .

  • Né il rm valore, impostato sul valore del rememberMeSet parametro, né il id parametro , che viene 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