SessionSecurityTokenHandler.ReadToken Method

Definition

Overloads

ReadToken(XmlReader)

Lit le SessionSecurityToken à l'aide du lecteur XML spécifié.Reads the SessionSecurityToken using the specified XML reader.

ReadToken(Byte[], SecurityTokenResolver)

Lit le SessionSecurityToken d'un flux d'octets à l'aide du programme de résolution de jetons spécifié.Reads the SessionSecurityToken from a stream of bytes by using the specified token resolver.

ReadToken(XmlReader, SecurityTokenResolver)

Lit le SessionSecurityToken à l'aide du lecteur XML et du programme de résolution de jeton spécifiés.Reads the SessionSecurityToken using the specified XML reader and token resolver.

Remarks

Important

L’appel de cette méthode avec des données non approuvées est un risque de sécurité.Calling this method with untrusted data is a security risk. Appelez cette méthode avec des données approuvées uniquement.Call this method only with trusted data. Pour plus d’informations, consultez Validation des données.For more information, see Data Validation.

L’implémentation par défaut désérialise le jeton à partir d’un élément WS-Secure Conversation Feb2005 ou WS-Secure Conversation 1,3 <wsc:SecurityContextToken>.The default implementation deserializes the token from either a WS-Secure Conversation Feb2005 or WS-Secure Conversation 1.3 <wsc:SecurityContextToken> element.

ReadToken(XmlReader)

Lit le SessionSecurityToken à l'aide du lecteur XML spécifié.Reads the SessionSecurityToken using the specified XML reader.

public:
 override System::IdentityModel::Tokens::SecurityToken ^ ReadToken(System::Xml::XmlReader ^ reader);
public override System.IdentityModel.Tokens.SecurityToken ReadToken (System.Xml.XmlReader reader);
override this.ReadToken : System.Xml.XmlReader -> System.IdentityModel.Tokens.SecurityToken
Public Overrides Function ReadToken (reader As XmlReader) As SecurityToken

Parameters

reader
XmlReader

XmlReader sur le SecurityToken entrant.The XmlReader over the incoming SecurityToken.

Returns

SecurityToken

Jeton de sécurité de session qui a été lu, instance SessionSecurityToken.The session security token that was read, an instance of SessionSecurityToken.

Exceptions

reader a la valeur null.reader is null.

Le lecteur n'est pas positionné sur un SessionSecurityToken ou SessionSecurityToken ne peut pas être lu.The reader is not positioned at a SessionSecurityToken or the SessionSecurityToken cannot be read.

Remarks

Important

L’appel de cette méthode avec des données non approuvées est un risque de sécurité.Calling this method with untrusted data is a security risk. Appelez cette méthode avec des données approuvées uniquement.Call this method only with trusted data. Pour plus d’informations, consultez Validation des données.For more information, see Data Validation.

Le lecteur doit être positionné sur un Feb2005 de conversation WS-Secure, ou sur un élément de <wsc:SecurityContextToken> conversation WS-Secure 1,3.The reader must be positioned at either a WS-Secure Conversation Feb2005 or a WS-Secure Conversation 1.3 <wsc:SecurityContextToken> element.

L’implémentation par défaut appelle la méthode SessionSecurityTokenHandler.ReadToken(XmlReader, SecurityTokenResolver) à l’aide d’un programme de résolution de jetons par défaut.The default implementation invokes the SessionSecurityTokenHandler.ReadToken(XmlReader, SecurityTokenResolver) method using a default token resolver.

ReadToken(Byte[], SecurityTokenResolver)

Lit le SessionSecurityToken d'un flux d'octets à l'aide du programme de résolution de jetons spécifié.Reads the SessionSecurityToken from a stream of bytes by using the specified token resolver.

public:
 virtual System::IdentityModel::Tokens::SecurityToken ^ ReadToken(cli::array <System::Byte> ^ token, System::IdentityModel::Selectors::SecurityTokenResolver ^ tokenResolver);
public virtual System.IdentityModel.Tokens.SecurityToken ReadToken (byte[] token, System.IdentityModel.Selectors.SecurityTokenResolver tokenResolver);
override this.ReadToken : byte[] * System.IdentityModel.Selectors.SecurityTokenResolver -> System.IdentityModel.Tokens.SecurityToken
Public Overridable Function ReadToken (token As Byte(), tokenResolver As SecurityTokenResolver) As SecurityToken

Parameters

token
Byte[]

Flux d'octets qui contient le jeton.The stream of bytes that contains the token.

tokenResolver
SecurityTokenResolver

Programme de résolution du jeton à employer.The token resolver to use.

Returns

SecurityToken

Le SessionSecurityToken qui a été lu.The SessionSecurityToken that was read.

Remarks

Important

L’appel de cette méthode avec des données non approuvées est un risque de sécurité.Calling this method with untrusted data is a security risk. Appelez cette méthode avec des données approuvées uniquement.Call this method only with trusted data. Pour plus d’informations, consultez Validation des données.For more information, see Data Validation.

L’implémentation par défaut crée un XmlDictionaryReader sur le jeton et appelle la méthode SessionSecurityTokenHandler.ReadToken(XmlReader, SecurityTokenResolver).The default implementation creates an XmlDictionaryReader over the token and invokes the SessionSecurityTokenHandler.ReadToken(XmlReader, SecurityTokenResolver) method.

ReadToken(XmlReader, SecurityTokenResolver)

Lit le SessionSecurityToken à l'aide du lecteur XML et du programme de résolution de jeton spécifiés.Reads the SessionSecurityToken using the specified XML reader and token resolver.

public:
 override System::IdentityModel::Tokens::SecurityToken ^ ReadToken(System::Xml::XmlReader ^ reader, System::IdentityModel::Selectors::SecurityTokenResolver ^ tokenResolver);
public override System.IdentityModel.Tokens.SecurityToken ReadToken (System.Xml.XmlReader reader, System.IdentityModel.Selectors.SecurityTokenResolver tokenResolver);
override this.ReadToken : System.Xml.XmlReader * System.IdentityModel.Selectors.SecurityTokenResolver -> System.IdentityModel.Tokens.SecurityToken
Public Overrides Function ReadToken (reader As XmlReader, tokenResolver As SecurityTokenResolver) As SecurityToken

Parameters

reader
XmlReader

XmlReader sur le SecurityToken entrant.The XmlReader over the incoming SecurityToken.

tokenResolver
SecurityTokenResolver

SecurityTokenResolver qui peut être utilisé pour corriger SessionSecurityToken.A SecurityTokenResolver that can used to resolve the SessionSecurityToken.

Returns

SecurityToken

Jeton de sécurité de session qui a été lu, instance SessionSecurityToken.The session security token that was read, an instance of SessionSecurityToken.

Exceptions

reader a la valeur null.reader is null.

-ou--or- tokenResolver a la valeur null.tokenResolver is null.

Le lecteur n'est pas positionné sur un SessionSecurityToken ou SessionSecurityToken ne peut pas être lu.The reader is not positioned at a SessionSecurityToken or the SessionSecurityToken cannot be read.

Remarks

Important

L’appel de cette méthode avec des données non approuvées est un risque de sécurité.Calling this method with untrusted data is a security risk. Appelez cette méthode avec des données approuvées uniquement.Call this method only with trusted data. Pour plus d’informations, consultez Validation des données.For more information, see Data Validation.

Le lecteur doit être positionné sur un Feb2005 de conversation WS-Secure, ou sur un élément de <wsc:SecurityContextToken> conversation WS-Secure 1,3.The reader must be positioned at either a WS-Secure Conversation Feb2005 or a WS-Secure Conversation 1.3 <wsc:SecurityContextToken> element.

Si le matériel de jeton est mis en cache, il est lu à partir du cache de jeton, qui est une instance de la classe SessionSecurityTokenCache.If the token material is cached, it is read from the token cache, which is an instance of the SessionSecurityTokenCache class. Dans le cas contraire, le matériau de jeton est lu à partir de l’élément enfant de l’élément <wsc:SecurityContextToken> spécifié par les propriétés CookieElementName et CookieNamespace et la méthode ApplyTransforms est appelée pour décoder le cookie.Otherwise, the token material is read from the child element of the <wsc:SecurityContextToken> element that is specified by the CookieElementName and CookieNamespace properties and the ApplyTransforms method is invoked to decode the cookie.

Pour plus d’informations sur la façon dont les jetons de session sont sérialisés dans un élément <SecurityContextToken, consultez la méthode SessionSecurityTokenHandler.WriteToken(XmlWriter, SecurityToken).For more information about how session tokens are serialized into a <SecurityContextToken element, see the SessionSecurityTokenHandler.WriteToken(XmlWriter, SecurityToken) method.

Applies to