SecurityTokenHandler.CreateSecurityTokenReference Método

Definição

Namespace:

System.IdentityModel.Tokens

Assembly:

System.IdentityModel.dll

Quando substituído em uma classe derivada, cria a referência de token de segurança para tokens processados por essa classe. Este método é geralmente chamado por um STS (serviço de token de segurança).

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

Parâmetros

token

SecurityToken

O token para o qual a referência deve ser criada.

attached

Boolean

true se uma referência anexada deve ser criada; false se uma referência desanexada deve ser criada.

Retornos

SecurityKeyIdentifierClause

Uma cláusula de identificador de chave que referencia o token especificado.

Exemplos

O código a seguir mostra como substituir o CreateSecurityTokenReference método para criar uma cláusula de identificador de chave do token especificado. O código é obtido do Custom Token exemplo. Este exemplo fornece classes personalizadas que permitem o processamento de SWT (Tokens Web Simples). Para obter informações sobre este exemplo e outros exemplos disponíveis para WIF e onde baixá-los, consulte Índice de exemplo de código WIF.

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

Comentários

Por padrão, esse método gera uma NotImplementedException exceção.

Classes derivadas substituem esse método para retornar uma cláusula de identificador de chave (SecurityKeyIdentifierClause) que pode ser usada para criar um <wsse:SecurityTokenReference> elemento para o token especificado.

Chamado de implementações da SecurityTokenService classe .

Normalmente, um SecurityKeyIdentifierClause não precisa ser usado, exceto quando um serviço de token de segurança personalizado é criado. Quando um serviço de token de segurança retorna um token de segurança, o token de segurança emitido contém referências a tokens de segurança anexados e desanexados. Referências anexadas referem-se a tokens de segurança contidos no cabeçalho de segurança de uma mensagem SOAP e referências desanexadas referenciam tokens de segurança que não estão incluídos no cabeçalho de segurança de uma mensagem SOAP. Essas referências normalmente afirmam a autenticidade do token de segurança emitido.