SecurityTokenHandler.CreateSecurityTokenReference Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Cuando se reemplaza en una clase derivada, crea la referencia del token de seguridad para tokens procesados por esa clase. Un servicio de token de seguridad (STS) llama normalmente a este método.
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
El token para el que se va a crear la referencia.
- attached
- Boolean
true si se debe crear una referencia adjunta; false si se debe crear una referencia sin adjuntar.
Devoluciones
Cláusula de identificador de clave que hace referencia al token especificado.
Ejemplos
En el código siguiente se muestra cómo invalidar el CreateSecurityTokenReference método para crear una cláusula de identificador de clave a partir del token especificado. El código se toma del Custom Token ejemplo. En este ejemplo se proporcionan clases personalizadas que permiten el procesamiento de tokens web simples (SWT). Para obtener información sobre este ejemplo y otros ejemplos disponibles para WIF y dónde descargarlos, consulte Índice de ejemplo de código WIF.
public override SecurityKeyIdentifierClause CreateSecurityTokenReference(SecurityToken token, bool attached)
{
return token.CreateKeyIdentifierClause<LocalIdKeyIdentifierClause>();
}
Comentarios
De forma predeterminada, este método produce una NotImplementedException excepción.
Las clases derivadas invalidan este método para devolver una cláusula de identificador de clave (SecurityKeyIdentifierClause) que se puede usar para crear un <wsse:SecurityTokenReference> elemento para el token especificado.
Se llama desde implementaciones de la SecurityTokenService clase .
Normalmente, SecurityKeyIdentifierClause no es necesario usar , excepto cuando se crea un servicio de token de seguridad personalizado. Cuando un servicio de token de seguridad devuelve un token de seguridad, el token de seguridad emitido contiene las referencias a los tokens de seguridad adjuntas y no adjuntas. Las referencias adjuntas hacen referencia a los tokens de seguridad que están contenidos dentro del encabezado de seguridad de un mensaje SOAP y las referencias no adjuntas hacen referencia a tokens de seguridad que no están incluidos dentro del encabezado de seguridad de un mensaje SOAP. Normalmente, estas referencias afirman la autenticidad del token de seguridad emitido.
