WSFederationAuthenticationModule.RedirectToIdentityProvider Méthode

Définition

Espace de noms:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Redirige l’utilisateur vers le service de jeton de sécurité spécifié par la Issuer propriété pour obtenir un jeton de sécurité à l’aide du protocole 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)

Paramètres

uniqueId

String

WSFAM enregistre cette valeur dans le paramètre wctx dans la demande de connexion WS-Federation ; Toutefois, le module ne l’utilise pas lors du traitement des demandes de connexion ou des réponses de connexion. Vous pouvez le définir sur n’importe quelle valeur. Il n'est pas nécessaire qu'elle soit unique. Pour plus d’informations, consultez la CreateSignInRequest(String, String, Boolean) méthode.

returnUrl

String

URL à laquelle le module doit retourner lors de l’authentification.

persist

Boolean

WSFAM enregistre cette valeur dans le paramètre wctx dans la demande de connexion WS-Federation ; Toutefois, le module ne l’utilise pas lors du traitement des demandes de connexion ou des réponses de connexion. Vous pouvez le définir soit true .false

Exceptions

InvalidOperationException

Issuer est null ou une chaîne vide.

- ou -

Realm est null ou une chaîne vide.

- ou -

La Current propriété est null ou vide.

- ou -

La Response propriété du contexte retourné par Current est null ou vide.

Remarques

La RedirectToIdentityProvider méthode est appelée à partir de la SignIn méthode lorsque la demande est émise à partir d’une page web présentée par la partie de confiance (RP) ou du OnEndRequest délégué du gestionnaire d’événements pour effectuer une redirection passive vers le fournisseur d’identité en cas d’échec d’autorisation.

Les paramètres passés à la méthode sont utilisés pour créer le paramètre de message wctx. Le seul paramètre significatif est le returnUrl paramètre. Cela spécifie l’URL que le fournisseur de ressources doit diriger le navigateur vers la réussite de l’authentification. Il ne doit pas être confondu avec le paramètre de message wreply, qui est spécifié par la Reply propriété et qui fournit l’adresse au niveau du fournisseur de ressources auquel le service de jeton de sécurité (STS) doit diriger sa réponse.

La méthode effectue les opérations suivantes :

1. Appelle la VerifyProperties méthode pour vous assurer qu’une demande de connexion valide peut être émise par le module.

2. Appelle la CreateSignInRequest méthode pour créer la demande de connexion à partir des propriétés configurées sur le module.

3. Appelle la OnRedirectingToIdentityProvider méthode pour déclencher l’événement RedirectingToIdentityProvider . Vous pouvez annuler la redirection ou modifier le message de demande de connexion dans le gestionnaire d’événements pour cet événement.