SessionSecurityTokenHandler Classe

Definição

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

System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler

Exemplos

O XML seguinte mostra como substituir o handler de token de segurança de sessão por defeito numa coleção de tokens por uma instância da MachineKeySessionSecurityTokenHandler classe em 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>

Observações

A SessionSecurityTokenHandler classe serializa, desserializa e valida tokens de sessão. Os tokens de sessão são tokens do tipo SessionSecurityToken. A SessionSecurityTokenHandler classe serializa os tokens para e desde o formato de cookie. Por defeito, a classe serializa os 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ção sobre uma sessão, sendo isto principalmente o ClaimsPrincipal associado ao utilizador autenticado e os tempos de início e expiração da sessão.

Em cenários passivos, as WSFederationAuthenticationModule chamadas para o SessionAuthenticationModule (SAM) a partir do pipeline de autenticação criam um token de sessão a partir do ClaimsPrincipal que representa o utilizador autenticado. O SAM utiliza a sua configuração SessionSecurityTokenHandler para criar o token e serializá-lo num cookie (e para desserializar o token de um cookie em pedidos subsequentes). O SAM utiliza uma instância da sua classe configurada CookieHandler para escrever o cookie de volta na Resposta HTTP. Este cookie é então devolvido ao cliente e, em pedidos subsequentes, este pode apresentar o cookie em vez de fazer uma viagem de ida e volta ao fornecedor de identidade para recuperar um token de segurança. Para mais informações sobre como as sessões funcionam com a WIF, consulte Gestão de Sessões da WIF.

Se o token de sessão estiver em modo de referência, ou seja, a sua SessionSecurityToken.IsReferenceMode propriedade for true, o handler do token de sessão só serializa as propriedades do token de sessão necessárias para regenerar a sua chave no SessionSecurityTokenCache. No caso padrão, a SessionSecurityTokenCacheKey classe é usada para representar chaves de cache, e o gestor do token escreve as SessionSecurityToken.ContextId propriedades e SessionSecurityToken.KeyGeneration do token. Se o token de sessão não estiver em modo de referência, ou seja, a SessionSecurityToken.IsReferenceMode propriedade for false, então, além das propriedades mencionadas anteriormente, o handler invoca o ApplyTransforms método num array de bytes serializado a partir do token e armazena também o valor resultante no cookie. Para mais detalhes sobre como o token é serializado, consulte o SessionSecurityTokenHandler.WriteToken(XmlWriter, SecurityToken) método.

A Transforms propriedade recebe a lista de transformações que são aplicadas ao token de sessão no ApplyTransforms método. Todas as transformadas derivam da CookieTransform classe. No caso padrão, os DeflateCookieTransform e os ProtectedDataCookieTransform são aplicados. Utiliza ProtectedDataCookieTransform a API de Proteção de Dados (DPAPI) para proteger o material de cookies. O DPAPI utiliza uma chave específica para o computador em que está a correr nos seus algoritmos de proteção. Por esta razão, o tratador padrão de tokens de sessão não é utilizável em cenários de Web farm porque, nesses cenários, tokens escritos num computador podem precisar de ser lidos noutro computador. Pode usar várias estratégias para contornar este problema. Por exemplo, você pode:

• Substitua o padrão SessionSecurityTokenHandler pelo MachineKeySessionSecurityTokenHandler. O MachineKeySessionSecurityTokenHandler permite-lhe especificar chaves de assinatura e encriptação sob o elemento ASP.NET <machineKey> no ficheiro de configuração.

• Fornecer um handler para o FederatedAuthentication.FederationConfigurationCreated evento no ficheiro global.asax.cs e substituir o handler de token de sessão por defeito por uma instância de SessionSecurityTokenHandler que tenha uma lista de transformações que inclua o RsaSignatureCookieTransform e o RsaEncryptionCookieTransform. Podes criar a nova instância invocando um dos construtores que recebe uma lista de transformações.

• Derive uma transformação personalizada a partir da CookieTransform classe base e use o método acima para a incluir na lista de transformações a aplicar.

• Deriva um gestor personalizado de tokens e SessionSecurityTokenHandler implementa o teu próprio mecanismo.

Para mais informações sobre a utilização de sessões em cenários de Webfarms, consulte WIF e Web Farms.

O SessionSecurityTokenHandler está incluído na coleção de handlers de tokens por defeito; no entanto, pode substituí-lo por um handler de token de sessão personalizado, especificando primeiro um <elemento remove> sob o <elemento securityTokenHandlers> para remover o handler por defeito da coleção e depois adicionando o seu handler de token personalizado usando o <elemento add> . Por defeito, pode especificar a vida útil padrão do token incluindo o <elemento sessionTokenRequirement> por baixo do <add> elemento. Podes desenhar um gestor de token personalizado para tomar elementos de configuração personalizados sob o <add> elemento, sobrescrevendo o LoadCustomConfiguration método para fornecer a lógica para os processar.

Ver também

• SessionSecurityTokenCache
• SessionSecurityToken
• MachineKeySessionSecurityTokenHandler
• CookieTransform
• <sessionTokenRequirement>
• WIF e Fazendas Web
• Gestão de Sessões WIF