SecurityTokenHandler.CreateSecurityTokenReference Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Quando sobreposto numa classe derivada, cria-se a referência do token de segurança para tokens processados por essa classe. Este método é normalmente chamado por um serviço de token de segurança (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.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 deve ser criada uma referência anexada; false se deve ser criada uma referência não anexada.
Devoluções
Uma cláusula identificadora de chave que faz referência ao token especificado.
Exemplos
O código seguinte mostra como sobrescrever o CreateSecurityTokenReference método para criar uma cláusula identificadora de chave a partir do token especificado. O código é retirado do Custom Token exemplo. Este exemplo fornece classes personalizadas que permitem o processamento de Simples Web Tokens (SWT). Para informações sobre esta amostra e outras amostras disponíveis para WIF e onde as descarregar, consulte Índice de Exemplos de Código WIF.
public override SecurityKeyIdentifierClause CreateSecurityTokenReference(SecurityToken token, bool attached)
{
return token.CreateKeyIdentifierClause<LocalIdKeyIdentifierClause>();
}
Observações
Por defeito, este método lança uma NotImplementedException exceção.
As classes derivadas sobrepõem-se a este método para devolver uma cláusula identificadora de chave (SecurityKeyIdentifierClause) que pode ser usada para criar um <wsse:SecurityTokenReference> elemento para o token especificado.
Chamadas a partir de implementações da SecurityTokenService classe.
Normalmente, a SecurityKeyIdentifierClause não precisa de ser usada, exceto quando é criado um serviço personalizado de token de segurança. Quando um serviço de token de segurança devolve um token de segurança, o token de segurança emitido contém referências a tokens de segurança anexados e não anexados. Referências anexadas referem-se a tokens de segurança contidos no cabeçalho de segurança de uma mensagem SOAP e referências não anexadas referem-se a tokens de segurança que não estão incluídos no cabeçalho de segurança de uma mensagem SOAP. Estas referências normalmente confirmam a autenticidade do token de segurança emitido.