SecurityTokenHandler.CreateSecurityTokenReference Método

  • Referencia

Definición

Espacio de nombres:
System.IdentityModel.Tokens
Ensamblado:
System.IdentityModel.dll

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.SecurityKeyIdentifierClause
Public Overridable Function CreateSecurityTokenReference (token As SecurityToken, attached As Boolean) As SecurityKeyIdentifierClause

Pará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

SecurityKeyIdentifierClause

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.

Se aplica a