SecurityTokenHandler Класс

Определение

public ref class SecurityTokenHandler abstract : System::IdentityModel::Configuration::ICustomIdentityConfiguration

public abstract class SecurityTokenHandler : System.IdentityModel.Configuration.ICustomIdentityConfiguration

type SecurityTokenHandler = class
    interface ICustomIdentityConfiguration

Public MustInherit Class SecurityTokenHandler
Implements ICustomIdentityConfiguration

Наследование

Object

SecurityTokenHandler

Производный

System.IdentityModel.Tokens.EncryptedSecurityTokenHandler

System.IdentityModel.Tokens.KerberosSecurityTokenHandler

System.IdentityModel.Tokens.RsaSecurityTokenHandler

System.IdentityModel.Tokens.Saml2SecurityTokenHandler

System.IdentityModel.Tokens.SamlSecurityTokenHandler

Подробнее…

Реализации

ICustomIdentityConfiguration

Примеры

Примеры кода во всех разделах SecurityTokenHandler взяты из примера Custom Token. В этом примере представлены пользовательские классы, которые позволяют обрабатывать простые веб-токены (SWT). Сведения об этом примере и других примерах, доступных для WIF и где их скачать, см. в индексе кода WIF. В следующем XML-коде показано, как добавить обработчик маркеров SWT в коллекцию обработчиков маркеров.

<system.identityModel>
  <identityConfiguration saveBootstrapContext="true">
    <issuerTokenResolver type="SimpleWebToken.CustomIssuerTokenResolver, SimpleWebToken">
      <AddAudienceKeyPair  symmetricKey="wAVkldQiFypTQ+kdNdGWCYCHRcee8XmXxOvgmak8vSY=" audience="http://localhost:19851/" />
    </issuerTokenResolver>
    <issuerNameRegistry type="RelyingParty.TrustedIssuerNameRegistry, RelyingParty"/>
    <audienceUris>
      <add value="http://localhost:19851/"/>
    </audienceUris>
    <securityTokenHandlers>
      <add type="SimpleWebToken.SimpleWebTokenHandler, SimpleWebToken" />
    </securityTokenHandlers>
  </identityConfiguration>
</system.identityModel>

Комментарии

Класс SecurityTokenHandler является базовым классом, от которого наследуется все обработчики маркеров безопасности. Обработчик маркеров безопасности отвечает за:

• Проверка маркеров безопасности (SecurityToken) типа, предназначенного для обработки и упаковки утверждений, содержащихся в маркере, в объект ClaimsIdentity.

• Сериализация и десериализация маркеров безопасности типа, предназначенного для обработки.

• Сериализация и десериализация предложений идентификаторов ключей (SecurityKeyIdentifierClause), ссылающихся на маркеры типа, в который он предназначен для обработки и от <wsse:SecurityTokenReference> элементов.

• Создание маркеров безопасности из объекта SecurityTokenDescriptor, передаваемого реализацией класса SecurityTokenService.

• Создание предложений идентификатора ключа из маркера безопасности для реализаций класса SecurityTokenService.

Windows Identity Foundation (WIF) поставляет следующие обработчики маркеров безопасности из поля:

• EncryptedSecurityTokenHandler

• KerberosSecurityTokenHandler

• MachineKeySessionSecurityTokenHandler

• MembershipUserNameSecurityTokenHandler

• RsaSecurityTokenHandler

• Saml2SecurityTokenHandler

• SamlSecurityTokenHandler

• SessionSecurityTokenHandler

• UserNameSecurityTokenHandler

• WindowsUserNameSecurityTokenHandler

• X509SecurityTokenHandler

Большинство этих классов предоставляют дополнительные члены, реализующие функциональные возможности, относящиеся к обработке маркеров, для которых предназначен класс. Во многих случаях лучше наследовать один из этих классов, а не напрямую из класса SecurityTokenHandler.

Обработчик маркеров безопасности можно добавить или удалить из коллекции обработчика маркеров, указав <добавить>, <удалить>или <очистить элементы> в элемент <е securityTokenHandlers> в файле конфигурации. Объект SecurityTokenHandlerConfiguration, содержащий параметры конфигурации для коллекции обработчиков, можно получить через свойство Configuration и коллекцию обработчика, к которому можно получить доступ из свойства ContainingCollection. Вы можете переопределить метод LoadCustomConfiguration для обработки любых пользовательских элементов конфигурации, которые принимает обработчик.

Класс SecurityTokenHandler предоставляет несколько других свойств и методов. В зависимости от возможностей, которые вы решили реализовать, можно переопределить некоторые или все эти элементы.

Необходимо переопределить свойство TokenType и метод GetTokenTypeIdentifiers, чтобы предоставить инфраструктуру WIF сведения о типе маркера безопасности, предназначенного для обработки.

Функции проверки, сериализации и десериализации предоставляются с помощью свойств или методов, указывающих, может ли обработчик выполнять определенную функцию в сочетании с методом или методами, реализующими функциональные возможности. Следующий список связывает свойства или методы, указывающие на функциональные возможности с методами, реализующими эту функциональность:

• Свойство CanValidateToken и метод ValidateToken: проверяет маркер и упаковает утверждения, содержащиеся в маркере, в ClaimsIdentity.

• Свойство CanWriteToken и методы WriteToken: сериализация маркеров.

• Методы CanReadToken и методы ReadToken: десериализация маркеров.

• Метод CanReadKeyIdentifierClause и метод ReadKeyIdentifierClause: предложения идентификатора ключа десериализации.

• Метод CanWriteKeyIdentifierClause и метод WriteKeyIdentifierClause: сериализация предложений идентификатора ключа.

Методы CreateToken и CreateSecurityTokenReference вызываются из конвейера в реализации класса SecurityTokenService.

Метод DetectReplayedToken вызывается инфраструктурой WIF, чтобы определить, был ли полученный маркер уже получен. По умолчанию этот метод возвращает false, указывающий, что маркер еще не получен. Вы можете переопределить метод и предоставить логику для обнаружения повторяемых маркеров.

Конструкторы

Свойства

Методы

Применяется к

См. также раздел

• SecurityToken
• SecurityKeyIdentifier
• SecurityTokenService