IssuerNameRegistry.GetIssuerName Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
При переопределении в производном классе возвращает имя поставщика для указанного токена безопасности.
Перегрузки
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
Токен безопасности, для которого требуется вернуть имя издателя.
Возвращаемое значение
Имя издателя.
Примеры
В следующем коде 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.
См. также раздел
Применяется к
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
Имя издателя, которые следует учитывать в запросе.
Возвращаемое значение
Имя издателя.
Комментарии
Реализация по умолчанию игнорирует requestedIssuerName
параметр и просто вызывает IssuerNameRegistry.GetIssuerName(SecurityToken) метод .
Вызывается из конвейера обработки обработчиком маркеров безопасности, обрабатывающим маркер. Метод должен возвращать уникальное имя издателя в контексте приложения RP.