Share via

WSFederationAuthenticationModule.CreateSignInRequest Méthode

  • Référence

Définition

Espace de noms:
System.IdentityModel.Services
Assembly:
System.IdentityModel.Services.dll

Crée un message de demande de connexion WS-Federation à l'aide des paramètres WS-Federation configurés sur le module.

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

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.

returnUrl
String

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

rememberMeSet
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.

Retours

SignInRequestMessage

Message de demande de connexion WS-Federation.

Exceptions

InvalidOperationException

La propriété Issuer a la valeur null ou est une chaîne vide.

- ou -

La propriété Realm a la valeur null ou est une chaîne vide.

Remarques

Crée une demande de connexion WS-Federation représentée par un SignInRequestMessage objet . Les propriétés du nouvel SignInRequestMessage objet sont définies comme suit :

  • La Context propriété (paramètre wctx) est définie sur une valeur créée à l’aide des paramètres de la méthode .

  • La CurrentTime propriété (paramètre wct) est définie sur l’heure actuelle.

  • Toutes les autres propriétés sont définies à l’aide des propriétés équivalentes de la instance actuelle.

Les paramètres passés à la méthode sont utilisés pour créer le paramètre de message wctx. Il s’agit d’une chaîne au format suivant : ru=returnUrl&cx=SignInContext&rm=rememberMeSet&id=uniqueId.

  • La ru valeur est définie sur la valeur du returnUrl paramètre passé à la méthode et spécifie l’URL que le module doit diriger le navigateur vers une authentification réussie. Il s’agit de la seule valeur stockée dans la chaîne wctx utilisée par le WSFAM. Le module appelle la GetReturnUrlFromResponse méthode pour extraire cette valeur du paramètre wctx lors du traitement d’une réponse de connexion WS-Federation. 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 lequel le service de jeton de sécurité (STS) doit diriger sa réponse.

  • Le cx paramètre est défini sur la valeur de la SignInContext propriété . Cette propriété est exposée pour vous permettre de définir n’importe quel contexte défini par l’application qui doit être stocké dans la chaîne wctx ; Toutefois, WSFAM n’expose pas de méthode pour extraire cette valeur dans la réponse. Si la valeur est nécessaire à votre application, vous devez fournir le code pour analyser la chaîne wctx et lire cette valeur lors du traitement de la réponse. Pour ce faire, vous pouvez remplacer la GetReturnUrlFromResponse méthode .

  • Ni la rm valeur, qui est définie sur la valeur du rememberMeSet paramètre, ni le id paramètre, qui est défini sur la valeur du uniqueId paramètre ne sont utilisés par WSFAM. Celles-ci peuvent être définies sur n’importe quelle valeur.

La CreateSignInRequest méthode est appelée à partir de la RedirectToIdentityProvider méthode .

S’applique à

Voir aussi