<add><add>

Добавляет указанный обработчик маркеров безопасности в коллекцию обработчиков маркеров.Adds the specified security token handler to the token handler collection.

<configuration> <configuration>
   <System. identityModel >   <system.identityModel>
     <identityConfiguration >     <identityConfiguration>
       <securityTokenHandlers >       <securityTokenHandlers>
         <добавить >        <add>

СинтаксисSyntax

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

Атрибуты и элементыAttributes and Elements

В следующих разделах описаны атрибуты, дочерние и родительские элементы.The following sections describe attributes, child elements, and parent elements.

АтрибутыAttributes

АтрибутAttribute ОписаниеDescription
типtype Имя типа CLR обработчика токенов, который необходимо добавить.The CLR type name of the token handler to be added. Дополнительные сведения об указании атрибута type см. в разделе ссылки на пользовательские типы.For more information about how to specify the type attribute, see Custom Type References.

Дочерние элементыChild Elements

ЭлементElement ОписаниеDescription
<samlSecurityTokenRequirement ><samlSecurityTokenRequirement> Предоставляет конфигурацию для класса SamlSecurityTokenHandler, класса Saml2SecurityTokenHandler или производного класса любого из этих классов.Provides configuration for the SamlSecurityTokenHandler class, the Saml2SecurityTokenHandler class, or a derived class of either of these classes.
<Сессионтокенрекуиремент ><sessionTokenRequirement> Предоставляет конфигурацию для класса SessionSecurityTokenHandler или производных классов.Provides configuration for the SessionSecurityTokenHandler class or derived classes.
<Усернамесекурититокенхандлеррекуиремент ><userNameSecurityTokenHandlerRequirement> Предоставляет конфигурацию для класса MembershipUserNameSecurityTokenHandler или производных классов.Provides configuration for the MembershipUserNameSecurityTokenHandler class or derived classes.
<x509SecurityTokenHandlerRequirement ><x509SecurityTokenHandlerRequirement> Предоставляет необязательную конфигурацию для класса X509SecurityTokenHandler или производных классов.Provides optional configuration for the X509SecurityTokenHandler class or derived classes.

Родительские элементыParent Elements

ЭлементElement ОписаниеDescription
<securityTokenHandlers ><securityTokenHandlers> Указывает коллекцию обработчиков маркеров безопасности, зарегистрированных в конечной точке.Specifies a collection of security token handlers that are registered with the endpoint.

ЗаметкиRemarks

Элемент <add> может принимать один дочерний элемент, указывающий конфигурацию для обработчика маркеров.The <add> element can take a single child element that specifies the configuration for the token handler. Это зависит от того, поддерживает ли этот компонент класс обработчика, на который ссылается атрибут type элемента <add>.This is dependent on whether the handler class referenced through the type attribute of the <add> element provides support for this feature. Классы обработчиков маркеров, которые предоставляют эту функцию, должны предоставлять конструктор, принимающий объект XmlElement.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 )  
    {  
    }  
}  

Некоторые из встроенных классов обработчиков маркеров безопасности предоставляют эту функцию.Several of the built-in security token handler classes do provide this functionality. Этими классами являются SamlSecurityTokenHandler, Saml2SecurityTokenHandler, MembershipUserNameSecurityTokenHandler, X509SecurityTokenHandlerи SessionSecurityTokenHandler.These classes are SamlSecurityTokenHandler, Saml2SecurityTokenHandler, MembershipUserNameSecurityTokenHandler, X509SecurityTokenHandler, and SessionSecurityTokenHandler.

Важно!

Коллекция обработчиков маркеров может содержать только один обработчик любого заданного типа.The token handler collection can only contain a single handler of any given type. Это означает, например, что если нужно добавить в коллекцию обработчик, производный от класса Saml2SecurityTokenHandler, необходимо сначала удалить Saml2SecurityTokenHandler, который существует по умолчанию, из коллекции.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. Можно использовать элемент <Remove > для удаления одного обработчика из коллекции или использовать <Clear > для удаления всех обработчиков из коллекции.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.

Параметры, заданные для обработчика, переопределяют эквивалентные параметры, указанные в коллекции обработчика маркеров в элементе <секурититокенхандлерконфигуратион > , и те, которые указаны на уровне службы в элементе <identityConfiguration > .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.

ПримерExample

В следующем XML-коде показано использование элементов <add> и <remove> для замены обработчика токенов сеанса по умолчанию обработчиком пользовательского маркера сеанса.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. XML взят из примера ClaimsAwareWebFarm.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>