SecurityTokenHandler.CreateSecurityTokenReference Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.SecurityKeyIdentifierClausePublic Overridable Function CreateSecurityTokenReference (token As SecurityToken, attached As Boolean) As SecurityKeyIdentifierClauseParâ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
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.
