WSFederationAuthenticationModule.RedirectToIdentityProvider Méthode

Définition

Espace de noms:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Redirige l'utilisateur vers le service d'émission de jeton de sécurité spécifié par la propriété Issuer 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

Le module WSFAM enregistre cette valeur du 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 lui affecter n'importe quelle valeur. Il n'est pas nécessaire qu'elle soit unique. Pour plus d'informations, voir la méthode CreateSignInRequest(String, String, Boolean).

returnUrl

String

URL à laquelle le module doit retourner la valeur lors de l'authentification.

persist

Boolean

Le module WSFAM enregistre cette valeur du 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 lui affecter la valeur true ou false.

Exceptions

InvalidOperationException

Issuer est soit null soit une chaîne vide.

- ou -

Realm est soit null soit une chaîne vide.

- ou -

La propriété Current est null ou vide.

- ou -

La propriété Response du contexte retourné par Current a la valeur null ou est 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 délégué du OnEndRequest 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 à laquelle le fournisseur de ressources doit diriger le navigateur après l’authentification réussie. 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 rp vers laquelle 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 s’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.