Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase MachineKeySessionSecurityTokenHandler

.NET Framework (current version)
 

Publicado: octubre de 2016

Procesa los símbolos de sesión mediante claves de cifrado y firma especificadas en ASP.NET <machineKey> elemento en un archivo de configuración.

Espacio de nombres:   System.IdentityModel.Services.Tokens
Ensamblado:  System.IdentityModel.Services (en System.IdentityModel.Services.dll)

System.Object
  System.IdentityModel.Tokens.SecurityTokenHandler
    System.IdentityModel.Tokens.SessionSecurityTokenHandler
      System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler

public class MachineKeySessionSecurityTokenHandler : SessionSecurityTokenHandler

NombreDescripción
System_CAPS_pubmethodMachineKeySessionSecurityTokenHandler()

Inicializa una nueva instancia de la clase MachineKeySessionSecurityTokenHandler.

System_CAPS_pubmethodMachineKeySessionSecurityTokenHandler(TimeSpan)

Inicializa una nueva instancia de la MachineKeySessionSecurityTokenHandler clase que tiene la duración del token predeterminado especificado.

NombreDescripción
System_CAPS_pubpropertyCanValidateToken

Obtiene un valor que indica si este controlador admite la validación de tokens de tipo SessionSecurityToken.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubpropertyCanWriteToken

Obtiene un valor que indica si este controlador puede escribir los tokens de tipo SessionSecurityToken.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubpropertyConfiguration

Obtiene o establece la SecurityTokenHandlerConfiguration objeto que proporciona la configuración de la instancia actual.(Heredado de SecurityTokenHandler).

System_CAPS_pubpropertyContainingCollection

Obtiene la colección de controlador de token que contiene la instancia actual.(Heredado de SecurityTokenHandler).

System_CAPS_pubpropertyCookieElementName

Obtiene el nombre del elemento de la cookie.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubpropertyCookieNamespace

Obtiene el espacio de nombres para el elemento de la cookie.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubpropertyTokenLifetime

Obtiene o establece la duración del token.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubpropertyTokenType

Obtiene el tipo de token que procesa este controlador.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubpropertyTransforms

Obtiene las transformaciones que se aplicarán a la cookie.(Heredado de SessionSecurityTokenHandler).

NombreDescripción
System_CAPS_protmethodApplyTransforms(Byte[], Boolean)

Aplica las transformaciones especificadas por el Transforms propiedad codificar o descodificar la cookie especificada.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubmethodCanReadKeyIdentifierClause(XmlReader)

Devuelve un valor que indica que si el elemento XML que hace referencia el lector XML especificado es una cláusula de identificador de clave que se puede deserializar esta instancia.(Heredado de SecurityTokenHandler).

System_CAPS_pubmethodCanReadToken(String)

Devuelve un valor que indica si se puede deserializar la cadena especificada como un token del tipo procesado por esta instancia.(Heredado de SecurityTokenHandler).

System_CAPS_pubmethodCanReadToken(XmlReader)

Devuelve un valor que indica si el lector está situado en un <wsc:SecurityContextToken> elemento.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubmethodCanWriteKeyIdentifierClause(SecurityKeyIdentifierClause)

Devuelve un valor que indica si se puede serializar la cláusula de identificador de clave especificado por esta instancia.(Heredado de SecurityTokenHandler).

System_CAPS_pubmethodCreateSecurityTokenReference(SecurityToken, Boolean)

Cuando se invalida en una clase derivada, crea la referencia de token de seguridad para tokens procesados por esa clase. Normalmente se llama a este método por un servicio de token de seguridad (STS).(Heredado de SecurityTokenHandler).

System_CAPS_pubmethodCreateSessionSecurityToken(ClaimsPrincipal, String, String, DateTime, DateTime)

Crea un SessionSecurityToken basándose en el rango de notificaciones especificadas principal y el tiempo durante el cual el token es válido.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubmethodCreateToken(SecurityTokenDescriptor)

Crea un token de seguridad basado en el descriptor de token especificado.(Heredado de SessionSecurityTokenHandler).

System_CAPS_protmethodDetectReplayedToken(SecurityToken)

Cuando se invalida en una clase derivada, produce una excepción si el token especificado se ha detectado que está reproduciendo.(Heredado de SecurityTokenHandler).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetTokenTypeIdentifiers()

Obtiene el URI del tipo de token para los tipos de token que pueden ser procesados por este controlador.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodLoadCustomConfiguration(XmlNodeList)

Configuración personalizada de carga desde XML.(Heredado de SessionSecurityTokenHandler).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodReadKeyIdentifierClause(XmlReader)

Cuando se invalida en una clase derivada, deserializa el XML al que hace referencia el lector XML especificado en una cláusula de identificador de clave que hace referencia a un símbolo (token) procesado por la clase derivada.(Heredado de SecurityTokenHandler).

System_CAPS_pubmethodReadToken(Byte[], SecurityTokenResolver)

Lee el SessionSecurityToken de una secuencia de bytes mediante el uso de la resolución del token especificada.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubmethodReadToken(String)

Cuando se invalida en una clase derivada, deserializa la cadena especificada para un token del tipo procesado por la clase derivada.(Heredado de SecurityTokenHandler).

System_CAPS_pubmethodReadToken(XmlReader)

Lee el SessionSecurityToken utilizando el lector XML especificado.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubmethodReadToken(XmlReader, SecurityTokenResolver)

Lee el SessionSecurityToken utilizar la resolución de lector y el token XML especificada.(Heredado de SessionSecurityTokenHandler).

System_CAPS_protmethodSetTransforms(IEnumerable<CookieTransform>)

Establece las transformaciones que se aplicarán a las cookies.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

System_CAPS_protmethodTraceTokenValidationFailure(SecurityToken, String)

Realiza un seguimiento del evento de error durante la validación de tokens de seguridad cuando está habilitado el seguimiento.(Heredado de SecurityTokenHandler).

System_CAPS_protmethodTraceTokenValidationSuccess(SecurityToken)

Realiza un seguimiento de la validación correcta de los eventos de tokens de seguridad cuando está habilitado el seguimiento.(Heredado de SecurityTokenHandler).

System_CAPS_protmethodValidateSession(SessionSecurityToken)

Determina si la sesión asociada con el token especificado es válida aún. Validez se determina mediante la comprobación de la ValidFrom y ValidTo Propiedades del token especificado. Se produce una excepción si la sesión ya no es válida.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubmethodValidateToken(SecurityToken)

Valida el token especificado y devuelve sus notificaciones.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubmethodValidateToken(SessionSecurityToken, String)

Valida el token de sesión especificado y devuelve sus notificaciones.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubmethodWriteKeyIdentifierClause(XmlWriter, SecurityKeyIdentifierClause)

Cuando se invalida en una clase derivada, serializa la cláusula de identificador de clave especificado en XML. La cláusula de identificador de clave debe ser del tipo compatible con la clase derivada.(Heredado de SecurityTokenHandler).

System_CAPS_pubmethodWriteToken(SecurityToken)

Cuando se invalida en una clase derivada, serializa el token de seguridad especificado en una cadena. El token debe ser del tipo procesado por la clase derivada.(Heredado de SecurityTokenHandler).

System_CAPS_pubmethodWriteToken(SessionSecurityToken)

Serializa el token especificado en una matriz de bytes.(Heredado de SessionSecurityTokenHandler).

System_CAPS_pubmethodWriteToken(XmlWriter, SecurityToken)

Serializa el token especificado utilizando el escritor XML especificado.(Heredado de SessionSecurityTokenHandler).

De forma predeterminada, la SessionSecurityTokenHandler clase utiliza la ProtectedDataCookieTransform (clase), que usa la API de protección de datos (DPAPI) para proteger el token de sesión. La DPAPI proporciona protección mediante las credenciales de usuario o de equipo y almacena los datos claves en el perfil de usuario. Esto significa que un token de sesión firmados y cifrados en un equipo no puede validarse o descifrar en un equipo diferente.

Por el contrario, la MachineKeySessionSecurityTokenHandler clase utiliza la MachineKeyTransform (clase), que protege los datos de la cookie de sesión mediante el material criptográfico especificado en el <machineKey> elemento en el archivo de configuración. Esto significa que las mismas claves (y símbolos de sesión) pueden utilizarse en varios equipos. Esto es especialmente importante cuando se implementa una aplicación en una granja de servidores web. Para obtener más información acerca de cómo usar Windows Identity Foundation para proteger las aplicaciones que se implementan en una granja de servidores web, consulte WIF y granjas de servidores web.

Configurar la aplicación para utilizar el MachineKeySessionSecurityTokenHandler agregándolo a la colección de controlador de token. Primero debe quitar la SessionSecurityTokenHandler (o cualquier controlador derivado de la SessionSecurityTokenHandler clase) de la colección si hay un controlador de este tipo de controlador de token. Esto es porque MachineKeySessionSecurityTokenHandler deriva de SessionSecurityTokenHandler y una colección de controlador de token no puede contener varios controladores de un tipo dado.

El siguiente XML muestra cómo usar ASP.NET <machineKey> elemento de configuración para especificar explícitamente las claves de firma y cifrado. El <machineKey> se especifica en el <system.web> elemento en un archivo de configuración.

<machineKey compatibilityMode="Framework45" decryptionKey="CC510D … 8925E6" validationKey="BEAC8 … 6A4B1DE" />

El siguiente XML muestra cómo agregar el MachineKeySessionSecurityTokenHandler a una colección de controlador de token. El valor predeterminado SessionSecurityTokenHandler en primer lugar se quita de la colección. Controladores de tokens configurados en el <securityTokenHandlers> elemento.

<securityTokenHandlers>
  <remove type="System.IdentityModel.Tokens.SessionSecurityTokenHandler, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  <add type="System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
</securityTokenHandlers>

.NET Framework
Disponible desde 4.5

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: