IssuerNameRegistry Класс

Определение

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

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

type IssuerNameRegistry = class
    interface ICustomIdentityConfiguration

Public MustInherit Class IssuerNameRegistry
Implements ICustomIdentityConfiguration

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

Object

IssuerNameRegistry

Производный

System.IdentityModel.Tokens.ConfigurationBasedIssuerNameRegistry

Реализации

ICustomIdentityConfiguration

Примеры

В следующем коде показана IssuerNameRegistry реализация класса , который принимает только издателей, использующих сертификаты с субъектом "CN=localhost".

using System.IdentityModel.Tokens;

namespace System.IdentityModel.Samples
{
    /// <summary>
    /// This class verifies that the issuer is trusted, and provides the issuer name.
    /// </summary>
    public class TrustedIssuerNameRegistry : IssuerNameRegistry
    {
        /// <summary>
        /// Gets the issuer name of the given security token,
        /// if it is the X509SecurityToken of 'localhost'.
        /// </summary>
        /// <param name="securityToken">The issuer's security token</param>
        /// <returns>A string that represents the issuer name</returns>
        /// <exception cref="SecurityTokenException">If the issuer is not trusted.</exception>
        public override string GetIssuerName(SecurityToken securityToken)
        {
            X509SecurityToken x509Token = securityToken as X509SecurityToken;
            if (x509Token != null)
            {
                if (String.Equals(x509Token.Certificate.SubjectName.Name, "CN=localhost"))
                {
                    return x509Token.Certificate.SubjectName.Name;
                }
            }

            throw new SecurityTokenException("Untrusted issuer.");
        }
    }
}

Ниже показан XML-код, необходимый для настройки приложения с реестром имен доверенных издателей.

<system.identityModel>  
  <identityConfiguration>  
    <issuerNameRegistry type="System.IdentityModel.Samples.TrustedIssuerNameRegistry, MyApp" />  
  </identityConfiguration>  
</system.identityModel>  

Комментарии

Реестр имен издателя используется для связывания мнемонического имени с криптографическим материалом, необходимым для проверки подписей маркеров, созданных соответствующим издателем. Затем это имя используется для задания Issuer свойства или OriginalIssuer утверждения. Методы, предоставляемые классом IssuerNameRegistry , вызываются из конвейера обработчиком маркера безопасности, обрабатывающим маркер. Маркеры, подписанные материалом, который не сопоставлен реестром имен издателя, удаляются как ненадежные. Имя, возвращаемое реестром имен издателя, должно быть уникальным в контексте приложения RP.

В коде можно указать используемый реестр имен издателя, задав SecurityTokenHandlerConfiguration.IssuerNameRegistry свойство . В файле конфигурации можно указать реестр имен издателя<, указав элемент issuerNameRegistry> в элементе< securityTokenHandlerConfiguration>.

Windows Identity Foundation (WIF) предоставляет реализацию IssuerNameRegistry класса по умолчанию ConfigurationBasedIssuerNameRegistry : класс . При использовании этой реализации можно указать список доверенных издателей в файле конфигурации приложения RP в <элементе trustedIssuers> , который является дочерним элементом <issuerNameRegistry> элемента, если ConfigurationBasedIssuerNameRegistryна класс ссылается атрибут этого элемента type . В элементе каждое <trustedIssuers> имя издателя сопоставляется с сертификатом X.509, который следует использовать для проверки его подписи.

Чтобы создать пользовательский реестр имен издателя, необходимо переопределить IssuerNameRegistry.GetIssuerName(SecurityToken) метод . Этот метод возвращает имя издателя для указанного маркера безопасности. При необходимости можно переопределить IssuerNameRegistry.GetIssuerName(SecurityToken, String) метод , чтобы предоставить механизм указания при получении имен издателей, и GetWindowsIssuerName метод , если вы хотите указать имя издателя для маркеров Windows, отличное от DefaultIssuer. Переопределите метод , чтобы включить инициализацию LoadCustomConfiguration реестра имен издателя из файла конфигурации.

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

Методы

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

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

• ConfigurationBasedIssuerNameRegistry
• SecurityTokenHandler
• <issuerNameRegistry>