Condividi tramite


CookieAuthenticationOptions Classe

Definizione

Opzioni di configurazione per CookieAuthenticationMiddleware.

public ref class CookieAuthenticationOptions : Microsoft::AspNetCore::Builder::AuthenticationOptions, Microsoft::Extensions::Options::IOptions<Microsoft::AspNetCore::Builder::CookieAuthenticationOptions ^>
public class CookieAuthenticationOptions : Microsoft.AspNetCore.Builder.AuthenticationOptions, Microsoft.Extensions.Options.IOptions<Microsoft.AspNetCore.Builder.CookieAuthenticationOptions>
type CookieAuthenticationOptions = class
    inherit AuthenticationOptions
    interface IOptions<CookieAuthenticationOptions>
Public Class CookieAuthenticationOptions
Inherits AuthenticationOptions
Implements IOptions(Of CookieAuthenticationOptions)
Ereditarietà
CookieAuthenticationOptions
Implementazioni

Costruttori

CookieAuthenticationOptions()

Crea un'istanza di opzioni inizializzate con i valori predefiniti.

Proprietà

AccessDeniedPath

La proprietà AccessDeniedPath informa il middleware che deve modificare un codice di stato non consentito in uscita 403 in un reindirizzamento 302 nel percorso specificato.

AuthenticationScheme

AuthenticationScheme nelle opzioni corrisponde al nome logico per uno schema di autenticazione specifico. È possibile che venga assegnato un valore diverso per utilizzare più volte lo stesso tipo di middleware di autenticazione nella stessa pipeline.

(Ereditato da AuthenticationOptions)
AutomaticAuthenticate

Se true il middleware di autenticazione modifica l'utente della richiesta in arrivo. Se false il middleware di autenticazione fornirà solo l'identità quando viene indicata in modo esplicito da AuthenticationScheme.

(Ereditato da AuthenticationOptions)
AutomaticChallenge

Se true il middleware di autenticazione deve gestire la richiesta automatica. Se false il middleware di autenticazione altererà solo le risposte quando indicato in modo esplicito da AuthenticationScheme.

(Ereditato da AuthenticationOptions)
ClaimsIssuer

Ottiene o imposta l'autorità emittente che deve essere usata per le attestazioni create

(Ereditato da AuthenticationOptions)
CookieDomain

Determina il dominio usato per creare il cookie. Non viene fornita per impostazione predefinita.

CookieHttpOnly

Determina se il browser deve consentire l'accesso al cookie da parte del codice JavaScript sul lato client. Il valore predefinito è true. Questo significa che il cookie verrà passato solo alle richieste HTTP e non è reso disponibile per lo script nella pagina.

CookieManager

Componente usato per ottenere i cookie dalla richiesta o per impostarli sulla risposta.

Per impostazione predefinita verrà usato ChunkingCookieManager.

CookieName

Determina il nome del cookie utilizzato per rendere permanente l'identità. Il valore predefinito è ". AspNetCore.Cookies". Questo valore deve essere modificato se si modifica il nome di AuthenticationScheme, soprattutto se il sistema usa il middleware di autenticazione cookie più volte.

CookiePath

Determina il percorso usato per creare il cookie. Il valore predefinito è "/" per la massima compatibilità del browser.

CookieSecure

Determina se il cookie deve essere trasmesso solo alla richiesta HTTPS. Il valore predefinito è limitare il cookie alle richieste HTTPS se la pagina che esegue SignIn è anche HTTPS. Se si dispone di una pagina di accesso HTTPS e parti del sito sono HTTP, potrebbe essere necessario modificare questo valore.

DataProtectionProvider

Se questa impostazione verrà usata dal cookieAuthenticationMiddleware per la protezione dei dati.

Description

Informazioni aggiuntive sul tipo di autenticazione reso disponibile per l'applicazione.

(Ereditato da AuthenticationOptions)
Events

Il provider potrebbe essere assegnato a un'istanza di un oggetto creato dall'applicazione al momento dell'avvio. Il middleware chiama i metodi nel provider che forniscono il controllo dell'applicazione in determinati punti in cui si sta verificando l'elaborazione. Se non viene specificata, viene fornita un'istanza predefinita che non ha alcun effetto quando vengono chiamati i metodi.

ExpireTimeSpan

Controlla il periodo di tempo in cui il cookie resterà valido dal punto in cui è stato creato. Le informazioni sulla scadenza si trovano nel ticket del cookie protetto. A causa di ciò un cookie scaduto verrà ignorato anche se viene passato al server dopo che il browser lo avrebbe dovuto eliminare.

LoginPath

La proprietà LoginPath informa il middleware che deve modificare un codice di stato Unauthorized 401 in uscita in un codice di reindirizzamento 302 nel percorso di accesso specificato. L'URL corrente che ha generato il codice 401 viene aggiunto a LoginPath come parametro della stringa di query denominato da ReturnUrlParameter. Una volta che una richiesta a LoginPath concede una nuova identità SignIn, viene usato il valore ReturnUrlParameter per reindirizzare nuovamente il browser
all'URL che ha causato il codice di stato non autorizzato originale.

LogoutPath

Se viene fornita la proprietà LogoutPath dal middleware, verrà reindirizzata una richiesta di tale percorso in base a ReturnUrlParameter.

ReturnUrlParameter

ReturnUrlParameter determina il nome del parametro della stringa di query aggiunto dal middleware quando un codice di stato Unauthorized 401 viene modificato in un codice di reindirizzamento 302 nel percorso di accesso. Questo è anche il parametro della stringa di query ricercato quando arriva una richiesta nel percorso di accesso o di disconnessione, al fine di tornare all'URL originale dopo l'esecuzione dell'azione.

SessionStore

Un contenitore facoltativo in cui archiviare l'identità tra le varie richieste. Quando usato, al cliente viene inviato un solo identificatore di sessione, che può essere usato per attenuare i potenziali problemi comportati dalle identità molto grandi.

SlidingExpiration

La proprietà SlidingExpiration viene impostata su true per indicare al middleware di riemettere un nuovo cookie con una nuova ora di scadenza ogni volta che elabora una richiesta che ha superato la metà nella finestra di scadenza.

SystemClock

For testing purposes only.

SystemClock

For testing purposes only.

(Ereditato da AuthenticationOptions)
TicketDataFormat

La proprietà TicketDataFormat viene utilizzata per proteggere e annullare la protezione dell'identità e di altre proprietà archiviate nel valore del cookie. Se non viene fornito un gestore dati predefinito viene creato usando il servizio protezione dati contenuto in IApplicationBuilder.Properties. Il servizio di protezione dei dati predefinito si basa sulla chiave del computer durante l'esecuzione in ASP.NET e in DPAPI durante l'esecuzione in un processo diverso.

Implementazioni dell'interfaccia esplicita

IOptions<CookieAuthenticationOptions>.Value

Opzioni di configurazione per CookieAuthenticationMiddleware.

Si applica a