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

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

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

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

Примеры

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

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

Комментарии

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

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

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

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

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