<add>

Ajoute le gestionnaire de jetons de sécurité spécifié à la collection de gestionnaires de jetons.Adds the specified security token handler to the token handler collection.

<configuration>
  <system.identityModel>
    <identityConfiguration>
      <securityTokenHandlers>
        <add>

SyntaxeSyntax

<system.identityModel>  
  <identityConfiguration>  
    <securityTokenHandlers>  
      <add type=xs:string>  
        <optionalConfigurationElement>  
        </optionalConfigurationElement>  
      </add>  
    </securityTokenHandlers>  
  </identityConfiguration>  
</system.identityModel>  

Attributs et élémentsAttributes and Elements

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

AttributAttribute DescriptionDescription
typetype Nom de type CLR du gestionnaire de jetons à ajouter.The CLR type name of the token handler to be added. Pour plus d’informations sur la spécification de l' type attribut, consultez références de types personnalisés.For more information about how to specify the type attribute, see Custom Type References.

Éléments enfantsChild Elements

ÉlémentElement DescriptionDescription
<samlSecurityTokenRequirement> Fournit la configuration pour la SamlSecurityTokenHandler classe, la Saml2SecurityTokenHandler classe ou une classe dérivée de l’une de ces classes.Provides configuration for the SamlSecurityTokenHandler class, the Saml2SecurityTokenHandler class, or a derived class of either of these classes.
<sessionTokenRequirement> Fournit la configuration pour la SessionSecurityTokenHandler classe ou les classes dérivées.Provides configuration for the SessionSecurityTokenHandler class or derived classes.
<userNameSecurityTokenHandlerRequirement> Fournit la configuration pour la MembershipUserNameSecurityTokenHandler classe ou les classes dérivées.Provides configuration for the MembershipUserNameSecurityTokenHandler class or derived classes.
<x509SecurityTokenHandlerRequirement> Fournit une configuration facultative pour la X509SecurityTokenHandler classe ou les classes dérivées.Provides optional configuration for the X509SecurityTokenHandler class or derived classes.

Éléments parentsParent Elements

ÉlémentElement DescriptionDescription
<securityTokenHandlers> Spécifie une collection de gestionnaires de jetons de sécurité inscrits auprès du point de terminaison.Specifies a collection of security token handlers that are registered with the endpoint.

RemarquesRemarks

L' <add> élément peut accepter un seul élément enfant qui spécifie la configuration du gestionnaire de jetons.The <add> element can take a single child element that specifies the configuration for the token handler. Cela dépend du fait que la classe de gestionnaire référencée par l' type attribut de l' <add> élément assure la prise en charge de cette fonctionnalité.This is dependent on whether the handler class referenced through the type attribute of the <add> element provides support for this feature. Les classes de gestionnaire de jetons qui fournissent cette fonctionnalité doivent exposer un constructeur qui prend un XmlElement objet.Token handler classes that provide this feature must expose a constructor that takes an XmlElement object.

public class CustomTokenHandler : Microsoft.IdentityModel.Tokens.SecurityTokenHandler  
{  
    public CustomTokenHandler( XmlElement customConfig )  
    {  
    }  
}  

Plusieurs des classes de gestionnaires de jetons de sécurité intégrées offrent cette fonctionnalité.Several of the built-in security token handler classes do provide this functionality. Ces classes sont SamlSecurityTokenHandler , Saml2SecurityTokenHandler , MembershipUserNameSecurityTokenHandler , X509SecurityTokenHandler et SessionSecurityTokenHandler .These classes are SamlSecurityTokenHandler, Saml2SecurityTokenHandler, MembershipUserNameSecurityTokenHandler, X509SecurityTokenHandler, and SessionSecurityTokenHandler.

Important

La collection de gestionnaires de jetons ne peut contenir qu’un seul gestionnaire d’un type donné.The token handler collection can only contain a single handler of any given type. Cela signifie, par exemple, que si vous souhaitez ajouter un gestionnaire dérivé de la Saml2SecurityTokenHandler classe à la collection, vous devez d’abord supprimer le Saml2SecurityTokenHandler , qui est présent par défaut, à partir de la collection.This means, for example, that if you want to add a handler that is derived from the Saml2SecurityTokenHandler class to the collection, you must first remove the Saml2SecurityTokenHandler, which is present by default, from the collection. Vous pouvez utiliser l' <remove> élément pour supprimer un gestionnaire unique de la collection ou utiliser l' <clear> élément pour supprimer tous les gestionnaires de la collection.You can use the <remove> element to remove a single handler from the collection or use the <clear> element to remove all handlers from the collection.

Les paramètres spécifiés sur un gestionnaire substituent les paramètres équivalents spécifiés dans la collection de gestionnaires de jetons sous l' <securityTokenHandlerConfiguration> élément et ceux spécifiés au niveau du service sous l' <identityConfiguration> élément.Settings specified on a handler override equivalent settings specified on the token handler collection under the <securityTokenHandlerConfiguration> element and those specified at the service-level under the <identityConfiguration> element.

ExempleExample

Le code XML suivant montre l’utilisation des <add> <remove> éléments et pour remplacer le gestionnaire de jetons de session par défaut par un gestionnaire de jetons de session personnalisé.The following XML shows the use of the <add> and <remove> elements to replace the default session token handler with a custom session token handler. Le code XML est extrait de l' ClaimsAwareWebFarm exemple.The XML is taken from the ClaimsAwareWebFarm sample.

<securityTokenHandlers>  
  <remove type="System.IdentityModel.Tokens.SessionSecurityTokenHandler, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
  <add type="System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
</securityTokenHandlers>