SessionSecurityTokenHandler Classe

  • Referência

Definição

Namespace:
System.IdentityModel.Tokens
Assembly:
System.IdentityModel.dll

Um SecurityTokenHandler que processa tokens de segurança do tipo SessionSecurityToken.

public ref class SessionSecurityTokenHandler : System::IdentityModel::Tokens::SecurityTokenHandler
public class SessionSecurityTokenHandler : System.IdentityModel.Tokens.SecurityTokenHandler
type SessionSecurityTokenHandler = class
    inherit SecurityTokenHandler
Public Class SessionSecurityTokenHandler
Inherits SecurityTokenHandler
Herança
Object
SecurityTokenHandler
SessionSecurityTokenHandler
Derivado

Exemplos

O XML a seguir mostra como substituir o manipulador de token de segurança de sessão padrão em uma coleção de manipuladores de token por uma instância da MachineKeySessionSecurityTokenHandler classe na configuração.

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

Comentários

A SessionSecurityTokenHandler classe serializa, desserializa e valida tokens de sessão. Tokens de sessão são tokens do tipo SessionSecurityToken. A SessionSecurityTokenHandler classe serializa os tokens de e para o formato de cookie. Por padrão, a classe serializa tokens em elementos WS-Secure Conversation Feb2005 ou WS-Secure Conversation 1.3 <wsc:SecurityContextToken> . Os tokens de sessão são usados pelo WSFederationAuthenticationModule (WSFAM) e pelo SessionAuthenticationModule (SAM) para armazenar informações sobre uma sessão, isso é principalmente o ClaimsPrincipal associado ao usuário autenticado e aos tempos de início e expiração da sessão.

Em cenários passivos, as WSFederationAuthenticationModule chamadas para o SessionAuthenticationModule (SAM) do pipeline de autenticação para criar um token de sessão do ClaimsPrincipal que representa o usuário autenticado. O SAM usa o configurado SessionSecurityTokenHandler para criar o token e serializá-lo em um cookie (e desserializar o token de um cookie em solicitações subsequentes). O SAM usa uma instância de sua classe configurada CookieHandler para gravar o cookie de volta na resposta HTTP. Em seguida, esse cookie é retornado ao cliente e, em solicitações subsequentes, o cliente pode apresentar o cookie em vez de fazer uma viagem de ida e volta para o provedor de identidade para obter novamente um token de segurança. Para obter mais informações sobre como as sessões operam com o WIF, consulte Gerenciamento de sessão wif.

Observação

O <elemento de configuração securityTokenHandlers> pode ser usado para especificar um SessionSecurityTokenHandler que tenha a responsabilidade de proteger as sessões do aplicativo. Os desenvolvedores devem ter cuidado ao alterar essa configuração, pois um sistema configurado incorretamente pode resultar em comprometimento do aplicativo. Por exemplo, especificar uma coleção derivada SessionSecurityTokenHandler e passar uma coleção de Transformações vazias (CookieTransform) para a base resultaria na serialização da identidade dos usuários em um cookie que não estava protegido. Isso pode permitir que um invasor modifique a identidade e, portanto, altere os privilégios de acesso.

Se o token de sessão estiver no modo de referência, ou seja, sua SessionSecurityToken.IsReferenceMode propriedade será true, o manipulador de token de sessão serializará apenas as propriedades do token de sessão necessárias para regenerar sua chave no SessionSecurityTokenCache. No caso padrão, a SessionSecurityTokenCacheKey classe é usada para representar chaves de cache e o manipulador de token grava as SessionSecurityToken.ContextId propriedades e SessionSecurityToken.KeyGeneration do token. Se o token de sessão não estiver no modo de referência, ou seja, a SessionSecurityToken.IsReferenceMode propriedade será false, então, além das propriedades mencionadas anteriormente, o manipulador invocará o ApplyTransforms método em uma matriz de bytes serializada do token e armazenará o valor resultante no cookie também. Para obter mais detalhes sobre como o token é serializado, consulte o SessionSecurityTokenHandler.WriteToken(XmlWriter, SecurityToken) método .

A Transforms propriedade obtém a lista de transformações que são aplicadas ao token de sessão no ApplyTransforms método . Todas as transformações derivam da CookieTransform classe . No caso padrão, o DeflateCookieTransform e o ProtectedDataCookieTransform são aplicados. O ProtectedDataCookieTransform usa a API de Proteção de Dados (DPAPI) para proteger o material de cookie. O DPAPI usa uma chave específica para o computador no qual está em execução em seus algoritmos de proteção. Por esse motivo, o manipulador de token de sessão padrão não é utilizável em cenários de web farm porque, nesses cenários, os tokens gravados em um computador podem precisar ser lidos em outro computador. Você pode usar muitas estratégias para contornar esse problema. Por exemplo, você pode:

Para obter mais informações sobre como usar sessões em cenários de web farm, consulte WIF e Web Farms.

O SessionSecurityTokenHandler está incluído na coleção de manipuladores de token padrão; no entanto, você pode substituí-lo por um manipulador de token de sessão personalizado especificando primeiro um <elemento remove> sob o <elemento securityTokenHandlers> para remover o manipulador padrão da coleção e, em seguida, adicionar seu manipulador de token personalizado usando o <elemento add> . Por padrão, você pode especificar o tempo de vida do token padrão incluindo o <elemento sessionTokenRequirement> no <add> elemento . Você pode criar um manipulador de token personalizado para usar elementos de configuração personalizados sob o <add> elemento substituindo o LoadCustomConfiguration método para fornecer a lógica para processá-los.

Construtores

SessionSecurityTokenHandler()

Inicializa uma nova instância da classe SessionSecurityTokenHandler que usa as transformações de cookie e tempo de vida do token padrão.
SessionSecurityTokenHandler(ReadOnlyCollection<CookieTransform>)

Inicializa uma nova instância da classe SessionSecurityTokenHandler que usa as transformações de cookie especificadas.
SessionSecurityTokenHandler(ReadOnlyCollection<CookieTransform>, TimeSpan)

Inicializa uma nova instância da classe SessionSecurityTokenHandler que usa as transformações de cookie e tempo de vida do token especificados.

Campos

DefaultCookieTransforms

A coleção somente leitura que contém a lista de transformações padrão a serem aplicadas a cookies, o DeflateCookieTransform e o ProtectedDataCookieTransform.
DefaultLifetime

Uma constante que especifica o tempo de vida padrão de cookies, dez horas.

Propriedades

CanValidateToken

Obtém um valor que indica se esse manipulador é compatível com a validação de tokens do tipo SessionSecurityToken.
CanWriteToken

Obtém um valor que indica se esse manipulador é capaz de gravar tokens do tipo SessionSecurityToken.
Configuration

Obtém ou define o objeto SecurityTokenHandlerConfiguration que fornece a configuração para a instância atual.

(Herdado de SecurityTokenHandler)
ContainingCollection

Obtém a coleção de manipuladores de token que contém a instância atual.

(Herdado de SecurityTokenHandler)
CookieElementName

Obtém o nome do elemento de cookie.
CookieNamespace

Obtém o namespace do elemento de cookie.
DefaultTokenLifetime

Obtém o tempo de vida de token padrão.
TokenLifetime

Obtém ou define o tempo de vida do token.
TokenType

Obtém o tipo dos tokens que esse manipulador processa.
Transforms

Obtém as transformações que serão aplicadas ao cookie.

Métodos

ApplyTransforms(Byte[], Boolean)

Aplica as transformações especificadas pela propriedade Transforms para codificar ou decodificar o cookie especificado.
CanReadKeyIdentifierClause(XmlReader)

Retorna um valor que indica que se o elemento XML consultado pelo leitor de XML especificado é uma cláusula de identificador de chave que pode ser desserializada por esta instância.

(Herdado de SecurityTokenHandler)
CanReadToken(String)

Retorna um valor que indica se a cadeia de caracteres especificada pode ser desserializada como um token do tipo processado por esta instância.

(Herdado de SecurityTokenHandler)
CanReadToken(XmlReader)

Retorna um valor que indica se o leitor está posicionado em um elemento <wsc:SecurityContextToken>.
CanWriteKeyIdentifierClause(SecurityKeyIdentifierClause)

Retorna um valor que indica se a cláusula de identificador de chave especificada pode ser serializada por esta instância.

(Herdado de SecurityTokenHandler)
CreateSecurityTokenReference(SecurityToken, Boolean)

Quando substituído em uma classe derivada, cria a referência de token de segurança para tokens processados por essa classe. Este método é geralmente chamado por um STS (serviço de token de segurança).

(Herdado de SecurityTokenHandler)
CreateSessionSecurityToken(ClaimsPrincipal, String, String, DateTime, DateTime)

Cria um SessionSecurityToken com base na entidade de declarações e intervalo de tempo especificados durante o qual o token é válido.
CreateToken(SecurityTokenDescriptor)

Cria um token de segurança com base no descritor de token especificado.
DetectReplayedToken(SecurityToken)

Quando substituído em uma classe derivada, gera uma exceção se o token especificado é detectado como sendo reproduzido.

(Herdado de SecurityTokenHandler)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetTokenTypeIdentifiers()

Obtém os URIs de tipo de token para os tipos de token que podem ser processados por esse manipulador.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
LoadCustomConfiguration(XmlNodeList)

Carrega a configuração personalizada do XML.
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
ReadKeyIdentifierClause(XmlReader)

Quando substituído em uma classe derivada, desserializa o XML referenciado pelo leitor de XML especificado para uma cláusula de identificador de chave que referencia um token processado pela classe derivada.

(Herdado de SecurityTokenHandler)
ReadToken(Byte[], SecurityTokenResolver)

Lê o SessionSecurityToken de um fluxo de bytes usando o resolvedor de token especificado.
ReadToken(String)

Quando substituído em uma classe derivada, desserializa a cadeia de caracteres especificada para um token do tipo processado pela classe derivada.

(Herdado de SecurityTokenHandler)
ReadToken(XmlReader)

Lê o SessionSecurityToken usando o leitor de XML especificado.
ReadToken(XmlReader, SecurityTokenResolver)

Lê o SessionSecurityToken usando o resolvedor de token e o leitor XML especificado.
SetTransforms(IEnumerable<CookieTransform>)

Define as transformações que serão aplicadas aos cookies.
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
TraceTokenValidationFailure(SecurityToken, String)

Rastreia o evento de falha durante a validação dos tokens de segurança quando o rastreamento está habilitado.

(Herdado de SecurityTokenHandler)
TraceTokenValidationSuccess(SecurityToken)

Rastreia a validação bem-sucedida do evento de tokens de segurança quando o rastreamento está habilitado.

(Herdado de SecurityTokenHandler)
ValidateSession(SessionSecurityToken)

Determina se a sessão associada ao token especificado ainda é válida. A validade é determinada verificando as propriedades ValidFrom e ValidTo do token especificado. Uma exceção é gerada se a sessão não for mais válida.
ValidateToken(SecurityToken)

Valida o token especificado e retorna suas declarações.
ValidateToken(SessionSecurityToken, String)

Valida o token de sessão especificado e retorna suas declarações.
WriteKeyIdentifierClause(XmlWriter, SecurityKeyIdentifierClause)

Quando substituído em uma classe derivada, serializa a cláusula de identificador de chave especificado no XML. A cláusula do identificador de chave deve ser do tipo com suporte na classe derivada.

(Herdado de SecurityTokenHandler)
WriteToken(SecurityToken)

Quando substituído em uma classe derivada, serializa o token de segurança especificado em uma cadeia de caracteres. O token deve ser do tipo processado pela classe derivada.

(Herdado de SecurityTokenHandler)
WriteToken(SessionSecurityToken)

Serializa o token especificado em uma matriz de bytes.
WriteToken(XmlWriter, SecurityToken)

Serializa o token especificado usando o gravador XML especificado.

Aplica-se a

Confira também