IssuerNameRegistry.GetIssuerName Метод

Определение

Пространство имен:

System.IdentityModel.Tokens

Сборка:

System.IdentityModel.dll

При переопределении в производном классе возвращает имя поставщика для указанного токена безопасности.

Перегрузки

GetIssuerName(SecurityToken)	При переопределении в производном классе возвращает имя поставщика указанного токена безопасности.
GetIssuerName(SecurityToken, String)	При переопределении в производном классе возвращает имя поставщика указанного токена безопасности. Указанное имя издателя может учитываться при определении возвращаемого имени издателя.

Комментарии

Вызывается из конвейера обработки обработчиком маркеров безопасности, обрабатывающим маркер. Метод должен возвращать уникальное имя издателя в контексте приложения RP.

GetIssuerName(SecurityToken)

При переопределении в производном классе возвращает имя поставщика указанного токена безопасности.

public:
 abstract System::String ^ GetIssuerName(System::IdentityModel::Tokens::SecurityToken ^ securityToken);

public abstract string GetIssuerName (System.IdentityModel.Tokens.SecurityToken securityToken);

abstract member GetIssuerName : System.IdentityModel.Tokens.SecurityToken -> string

Public MustOverride Function GetIssuerName (securityToken As SecurityToken) As String

Параметры

securityToken

SecurityToken

Токен безопасности, для которого требуется вернуть имя издателя.

Возвращаемое значение

String

Имя издателя.

Примеры

В следующем коде GetIssuerName показан метод для реестра имен издателя. Полный пример приведен в 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.");
}

Комментарии

Реализации должны возвращать непустую и непустую строку для идентификации распознанного издателя или пустую строку для идентификации нераспознанного издателя.

Вызывается из конвейера обработки обработчиком маркеров безопасности, обрабатывающим маркер. Метод должен возвращать уникальное имя издателя в контексте приложения RP.

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

• SecurityTokenHandler

GetIssuerName(SecurityToken, String)

При переопределении в производном классе возвращает имя поставщика указанного токена безопасности. Указанное имя издателя может учитываться при определении возвращаемого имени издателя.

public:
 virtual System::String ^ GetIssuerName(System::IdentityModel::Tokens::SecurityToken ^ securityToken, System::String ^ requestedIssuerName);

public virtual string GetIssuerName (System.IdentityModel.Tokens.SecurityToken securityToken, string requestedIssuerName);

abstract member GetIssuerName : System.IdentityModel.Tokens.SecurityToken * string -> string
override this.GetIssuerName : System.IdentityModel.Tokens.SecurityToken * string -> string

Public Overridable Function GetIssuerName (securityToken As SecurityToken, requestedIssuerName As String) As String

Параметры

securityToken

SecurityToken

Токен безопасности, для которого требуется вернуть имя издателя.

requestedIssuerName

String

Имя издателя, которые следует учитывать в запросе.

Возвращаемое значение

String

Имя издателя.

Комментарии

Реализация по умолчанию игнорирует requestedIssuerName параметр и просто вызывает IssuerNameRegistry.GetIssuerName(SecurityToken) метод .

Вызывается из конвейера обработки обработчиком маркеров безопасности, обрабатывающим маркер. Метод должен возвращать уникальное имя издателя в контексте приложения RP.

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

• SecurityTokenHandler