WSFederationAuthenticationModule.RedirectToIdentityProvider Metodo

Definizione

Spazio dei nomi:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Reindirizza l'utente al servizio token di sicurezza (STS) specificato dalla proprietà Issuer per ottenere un token di sicurezza utilizzando il protocollo 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)

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. Per altre informazioni, vedere il metodo CreateSignInRequest(String, String, Boolean).

returnUrl

String

URL cui deve tornare il modulo dopo l'autenticazione.

persist

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.

Eccezioni

InvalidOperationException

Issuer è null o una stringa vuota.

-oppure-

Realm è null o una stringa vuota.

-oppure-

La proprietà Current è null o vuota.

-oppure-

La proprietà Response del contesto restituita da Current è null o vuota.

Commenti

Il RedirectToIdentityProvider metodo viene chiamato dal SignIn metodo quando la richiesta viene rilasciata da una pagina Web presentata dalla relying party (RP) o dal OnEndRequest delegato del gestore eventi per eseguire un reindirizzamento passivo al provider di identità in caso di errore di autorizzazione.

I parametri passati al metodo vengono usati per creare il parametro del messaggio wctx. L'unico parametro significativo è il returnUrl parametro . In questo modo viene specificato l'URL che l'RP deve indirizzare il browser al completamento dell'autenticazione. 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 metodo esegue quanto segue:

1. Richiama il VerifyProperties metodo per assicurarsi che una richiesta di accesso valida possa essere emessa dal modulo.

2. Richiama il CreateSignInRequest metodo per creare la richiesta di accesso dalle proprietà configurate nel modulo.

3. Richiama il metodo per generare l'evento OnRedirectingToIdentityProviderRedirectingToIdentityProvider . È possibile annullare il reindirizzamento o modificare il messaggio di richiesta di accesso nel gestore eventi per questo evento.