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 de token de seguridad para los tokens procesados por esa clase. Normalmente, un servicio de token de seguridad (STS) llama 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
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 no adjunta.
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 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 de 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 un objeto que no sea 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 referencias a tokens de seguridad adjuntos y no conectados. Las referencias adjuntas hacen referencia a tokens de seguridad contenidos en el encabezado de seguridad de un mensaje SOAP y referencias no adjuntas a tokens de seguridad que no se incluyen en el encabezado de seguridad de un mensaje SOAP. Estas referencias suelen afirmar la autenticidad del token de seguridad emitido.