<cookieHandler><cookieHandler>

Configura il CookieHandler che il SessionAuthenticationModule (SAM) viene utilizzato per leggere e scrivere i cookie.Configures the CookieHandler that the SessionAuthenticationModule (SAM) uses to read and write cookies.

<IdentityModel ><system.identityModel.services>
<federationConfiguration ><federationConfiguration>
<cookieHandler ><cookieHandler>

SintassiSyntax

<system.identityModel.services>  
  <federationConfiguration>  
    <cookieHandler name=xs:string  
        path=Path  
        mode="Chunked||Custom||Default"  
        persistentSessionLifetime=xs:string  
        hideFromScript=xs:boolean  
        requireSSL=xs:boolean  
        domain=xs:string  
      <chunkedCookieHandler size=xs:int />  
      <customCookieHandler type="MyNamespace.MyCustomCookieHandler, MyAssembly" />  
    </cookieHandler>  
  </federationConfiguration>  
</system.identityModel.services>  

Attributi ed elementiAttributes and Elements

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.The following sections describe attributes, child elements, and parent elements.

AttributiAttributes

AttributoAttribute DescrizioneDescription
namename Specifica il nome di base per i cookie scritti.Specifies the base name for any cookies written. Il valore predefinito è "FedAuth".The default is "FedAuth".
pathpath Specifica il valore di percorso per i cookie scritti.Specifies the path value for any cookies written. Il valore predefinito è "AppDomainAppVirtualPath".The default is "HttpRuntime.AppDomainAppVirtualPath".
modalitàmode Uno del CookieHandlerMode valori che specifica il tipo di gestore di cookie utilizzato per il modulo SAM.One of the CookieHandlerMode values that specifies the kind of cookie handler used by the SAM. Possono essere utilizzati i valori seguenti:The following values may be used:

-"Default", ovvero lo stesso come "Chunked".- "Default" — The same as "Chunked".
-"Chunked", ovvero viene utilizzata un'istanza di ChunkedCookieHandler classe.- "Chunked" — Uses an instance of the ChunkedCookieHandler class. Questo gestore cookie assicura che singoli cookie non superi una dimensione massima del set.This cookie handler ensures that individual cookies do not exceed a set maximum size. Per ottenere questo risultato potenzialmente "suddivisione in blocchi" un cookie logico in un numero di cookie in transito.It accomplishes this by potentially "chunking" one logical cookie into a number of cookies on-the-wire.
-"Custom", ovvero viene utilizzata un'istanza di una classe personalizzata derivata da CookieHandler.- "Custom" — Uses an instance of a custom class derived from CookieHandler. Fa riferimento la classe derivata di <customCookieHandler> elemento figlio.The derived class is referenced by the <customCookieHandler> child element.

Il valore predefinito è "Default".The default is "Default".
persistentSessionLifetimepersistentSessionLifetime Specifica la durata delle sessioni permanenti.Specifies the lifetime of persistent sessions. Se è zero, le sessioni temporanee vengono sempre utilizzate.If zero, transient sessions are always used. Il valore predefinito è "0:0:0", che specifica una sessione temporanea.The default value is "0:0:0", which specifies a transient session. Il valore massimo è "365:0:0", che specifica una sessione di 365 giorni.The maximum value is "365:0:0", which specifies a session of 365 days. Il valore deve essere specificato in base alla restrizione seguente: <xs:pattern value="([0-9.]+:){0,1}([0-9]+:){0,1}[0-9.]+" />, dove il valore più a sinistra specifica giorni, il valore medio, se presente, specifica le ore e il valore più a destra, se presente, specifica i minuti.The value should be specified according to the following restriction: <xs:pattern value="([0-9.]+:){0,1}([0-9]+:){0,1}[0-9.]+" />, where the leftmost value specifies days, the middle value (if present) specifies hours, and the rightmost value (if present) specifies minutes.
RequireSslrequireSsl Specifica se il flag "Secure" viene generato per i cookie scritti.Specifies whether the "Secure" flag is emitted for any cookies written. Se questo valore è impostato, i cookie di sessione di accesso sarà disponibili solo tramite HTTPS.If this value is set, the sign-in session cookies will only be available over HTTPS. Il valore predefinito è "true".The default is "true".
hideFromScripthideFromScript Controlla se il flag "HttpOnly" viene generato per i cookie scritti.Controls whether the "HttpOnly" flag is emitted for any cookies written. Alcuni browser rispetta questo flag da impedisce l'accesso al valore di cookie di script sul lato client.Certain web browsers honor this flag by keeping client-side script from accessing the cookie value. Il valore predefinito è "true".The default is "true".
dominiodomain Il valore di dominio per i cookie scritti.The domain value for any cookies written. Il valore predefinito è "".The default is "".

Elementi figlioChild Elements

ElementoElement DescrizioneDescription
<chunkedCookieHandler ><chunkedCookieHandler> Configura il ChunkedCookieHandler.Configures the ChunkedCookieHandler. Questo elemento può essere presente solo se il mode attributo del <cookieHandler> elemento è "Default" o "Chunked".This element may only be present if the mode attribute of the <cookieHandler> element is "Default" or "Chunked".
<customCookieHandler ><customCookieHandler> Imposta il tipo di gestore cookie personalizzati.Sets the custom cookie handler type. Questo elemento deve essere presentano se la mode attributo del <cookieHandler> elemento è "Personalizzato".This element must be present if the mode attribute of the <cookieHandler> element is "Custom". Non può essere presente per tutti gli altri valori del mode attributo.It cannot be present for any other values of the mode attribute. Il tipo personalizzato deve essere derivato dalla CookieHandler classe.The custom type must be derived from the CookieHandler class.

Elementi padreParent Elements

ElementoElement DescrizioneDescription
<federationConfiguration><federationConfiguration> Contiene le impostazioni che configurano il WSFederationAuthenticationModule (WSFAM) e SessionAuthenticationModule (SAM).Contains the settings that configure the WSFederationAuthenticationModule (WSFAM) and the SessionAuthenticationModule (SAM).

NoteRemarks

Il CookieHandler è responsabile della lettura e scrittura cookie non elaborati a HTTP del livello di protocollo.The CookieHandler is responsible for reading and writing raw cookies at the HTTP protocol level. È possibile configurare un ChunkedCookieHandler o un gestore di cookie personalizzato derivato dalla CookieHandler classe.You can configure either a ChunkedCookieHandler or a custom cookie handler derived from the CookieHandler class.

Per configurare un gestore di cookie in blocchi, impostare l'attributo mode "Chunked" o "Default".To configure a chunked cookie handler, set the mode attribute to "Chunked" or "Default". Le dimensioni del blocco predefinito sono 2000 byte, ma è possibile specificare facoltativamente una dimensione di blocco diverso includendo un <chunkedCookieHandler> elemento figlio.The default chunk size is 2000 bytes, but you may optionally specify a different chunk size by including a <chunkedCookieHandler> child element.

Per configurare un gestore personalizzato cookie, impostare l'attributo mode su "Custom".To configure a custom cookie handler, set the mode attribute to "Custom". È necessario specificare anche un <customCookieHandler> elemento figlio che fa riferimento al tipo di gestore personalizzato.You must also specify a <customCookieHandler> child element that references the type of your custom handler.

Il <cookieHandler> elemento è rappresentato dalla CookieHandlerElement classe.The <cookieHandler> element is represented by the CookieHandlerElement class. Il gestore di cookie che è stato specificato nella configurazione è disponibile il CookieHandler proprietà del FederationConfiguration oggetto impostato sul FederatedAuthentication.FederationConfiguration proprietà.The cookie handler that was specified in configuration is available from the CookieHandler property of the FederationConfiguration object set on the FederatedAuthentication.FederationConfiguration property.

EsempioExample

Il codice XML seguente viene illustrato un <cookieHandler> elemento.The following XML shows a <cookieHandler> element. In questo esempio, in quanto il mode attributo non è specificato, il gestore di cookie predefinito da utilizzare per il modulo SAM.In this example, because the mode attribute is not specified, the default cookie handler will be used by the SAM. Si tratta di un'istanza di ChunkedCookieHandler classe.This is an instance of the ChunkedCookieHandler class. Poiché il <chunkedCookieHandler> elemento figlio non viene specificato, le dimensioni del blocco predefinito verranno utilizzata.Because the <chunkedCookieHandler> child element is not specified, the default chunk size will be used. HTTPS non è necessario perché il requireSsl è impostato l'attributo false.HTTPS will not be required because the requireSsl attribute is set false.

Avviso

In questo esempio, HTTPS non è necessario scrivere i cookie di sessione.In this example, HTTPS is not required to write session cookies. In questo modo il requireSsl attributo la <cookieHandler> è impostato su false.This is because the requireSsl attribute on the <cookieHandler> element is set to false. Questa impostazione non è consigliata per la maggior parte degli ambienti di produzione, come possono presentare un rischio per la sicurezza.This setting is not recommended for most production environments as it may present a security risk.

<cookieHandler requireSsl="false" />  

Vedere ancheSee Also

CookieHandler
ChunkedCookieHandler
SessionAuthenticationModule