WSFederationAuthenticationModule.RedirectToIdentityProvider Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> unitPublic 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
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:
Richiama il VerifyProperties metodo per assicurarsi che una richiesta di accesso valida possa essere emessa dal modulo.
Richiama il CreateSignInRequest metodo per creare la richiesta di accesso dalle proprietà configurate nel modulo.
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.
