Поделиться через


SecurityTokenHandler.CreateSecurityTokenReference Метод

Определение

При переопределении в производном классе создает ссылку токена безопасности для токенов, обрабатываемых этим классом. Этот метод обычно вызывается службой токенов безопасности (STS).

public:
 virtual System::IdentityModel::Tokens::SecurityKeyIdentifierClause ^ CreateSecurityTokenReference(System::IdentityModel::Tokens::SecurityToken ^ token, bool attached);
public virtual System.IdentityModel.Tokens.SecurityKeyIdentifierClause CreateSecurityTokenReference (System.IdentityModel.Tokens.SecurityToken token, bool attached);
abstract member CreateSecurityTokenReference : System.IdentityModel.Tokens.SecurityToken * bool -> System.IdentityModel.Tokens.SecurityKeyIdentifierClause
override this.CreateSecurityTokenReference : System.IdentityModel.Tokens.SecurityToken * bool -> System.IdentityModel.Tokens.SecurityKeyIdentifierClause
Public Overridable Function CreateSecurityTokenReference (token As SecurityToken, attached As Boolean) As SecurityKeyIdentifierClause

Параметры

token
SecurityToken

Токен, для которого требуется создать ссылку.

attached
Boolean

Значение true, если должна быть создана присоединенная ссылка; значение false, если должна быть создана неприсоединенная ссылка.

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

Предложение идентификатора ключа, ссылающееся на указанный токен.

Примеры

В следующем коде показано, как переопределить CreateSecurityTokenReference метод для создания предложения идентификатора ключа из указанного маркера. Код взят из Custom Token примера. В этом примере представлены пользовательские классы, которые позволяют обрабатывать простые веб-маркеры (SWT). Сведения об этом и других примерах, доступных для WIF, а также о том, где их можно скачать, см. в разделе WiF Code Sample Index.

public override SecurityKeyIdentifierClause CreateSecurityTokenReference(SecurityToken token, bool attached)
{
    return token.CreateKeyIdentifierClause<LocalIdKeyIdentifierClause>();           
}

Комментарии

По умолчанию этот метод создает NotImplementedException исключение.

Производные классы переопределяют этот метод для возврата предложения идентификатора ключа (SecurityKeyIdentifierClause), которое можно использовать для создания <wsse:SecurityTokenReference> элемента для указанного токена.

Вызывается из реализаций SecurityTokenService класса .

Как правило, SecurityKeyIdentifierClause использовать не нужно, кроме как при создании пользовательской службы маркеров безопасности. Когда служба маркеров безопасности возвращает маркер безопасности, выданный маркер безопасности содержит ссылки на прикрепленные и неприкрепленные маркеры безопасности. Прикрепленные ссылки указывают на маркеры безопасности, содержащиеся в заголовке безопасности сообщения SOAP, а неприкрепленные ссылки указывают на маркеры безопасности, не входящие в заголовок безопасности сообщения SOAP. Обычно эти ссылки подтверждают подлинность выданного маркера безопасности.

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