Share via


CookieAuthenticationOptions Sınıf

Tanım

için CookieAuthenticationOptionsyapılandırma seçenekleri.

public ref class CookieAuthenticationOptions : Microsoft::AspNetCore::Authentication::AuthenticationSchemeOptions
public class CookieAuthenticationOptions : Microsoft.AspNetCore.Authentication.AuthenticationSchemeOptions
type CookieAuthenticationOptions = class
    inherit AuthenticationSchemeOptions
Public Class CookieAuthenticationOptions
Inherits AuthenticationSchemeOptions
Devralma
CookieAuthenticationOptions

Oluşturucular

CookieAuthenticationOptions()

Varsayılan değerlerle başlatılan seçeneklerin bir örneğini oluşturma

Özellikler

AccessDeniedPath

AccessDeniedPath özelliği, ForbidAsync işlenirken yeniden yönlendirme hedefi için işleyici tarafından kullanılır.

ClaimsIssuer

Oluşturulan talepler için kullanılması gereken vereni alır veya ayarlar

(Devralındığı yer: AuthenticationSchemeOptions)
Cookie

Tanımlama bilgisini oluşturmak için kullanılan ayarları belirler.

CookieDomain
Geçersiz.

Bu özellik kullanımdan kaldırıldı ve gelecekteki bir sürümde kaldırılacak. Önerilen alternatif üzerindedir Cookie.

Tanımlama bilgisini oluşturmak için kullanılan etki alanını belirler. Varsayılan olarak sağlanmaz.

CookieHttpOnly
Geçersiz.
Geçersiz.

Bu özellik kullanımdan kaldırıldı ve gelecekteki bir sürümde kaldırılacak. Önerilen alternatif üzerindedir Cookie.

Tarayıcının tanımlama bilgisine istemci tarafı javascript tarafından erişilmesine izin verilip verirseniz belirler. Varsayılan değer true'dur; bu da tanımlama bilgisinin yalnızca http isteklerine geçirileceği ve sayfada betik için kullanılabilir hale getirilmediği anlamına gelir.

CookieManager

İstekten tanımlama bilgilerini almak veya yanıtta ayarlamak için kullanılan bileşen.

ChunkingCookieManager varsayılan olarak kullanılır.

CookieName
Geçersiz.
Geçersiz.

Bu özellik kullanımdan kaldırıldı ve gelecekteki bir sürümde kaldırılacak. Önerilen alternatif üzerindedir Cookie.

Kimliği kalıcı hale getirmek için kullanılan tanımlama bilgisi adını belirler. Varsayılan değer " şeklindedir. AspNetCore.Cookies". AuthenticationScheme adını değiştirirseniz, özellikle sisteminiz tanımlama bilgisi kimlik doğrulama işleyicisini birden çok kez kullanıyorsa bu değer değiştirilmelidir.

CookiePath
Geçersiz.

Bu özellik kullanımdan kaldırıldı ve gelecekteki bir sürümde kaldırılacak. Önerilen alternatif üzerindedir Cookie.

Tanımlama bilgisini oluşturmak için kullanılan yolu belirler. En yüksek tarayıcı uyumluluğu için varsayılan değer "/" değeridir.

CookieSecure
Geçersiz.

Bu özellik kullanımdan kaldırıldı ve gelecekteki bir sürümde kaldırılacak. Önerilen alternatif üzerindedir Cookie.

Tanımlama bilgisinin yalnızca HTTPS isteğinde iletilip aktarılmaması gerektiğini belirler. Varsayılan ayar, SignIn'i yapan sayfa da HTTPS ise tanımlama bilgisini HTTPS istekleriyle sınırlamaktır. HTTPS oturum açma sayfanız varsa ve sitenizin bazı bölümleri HTTP ise bu değeri değiştirmeniz gerekebilir.

DataProtectionProvider

Ayarlanırsa bu, cookieAuthenticationHandler tarafından veri koruması için kullanılır.

Events

Sağlayıcı, başlangıç zamanında uygulama tarafından oluşturulan bir nesnenin örneğine atanabilir. İşleyici, işlemenin gerçekleştiği belirli noktalarda uygulama denetimi sağlayan sağlayıcıda yöntemleri çağırır. Sağlanmazsa, yöntemler çağrıldığında hiçbir şey içermeyen bir varsayılan örnek sağlanır.

EventsType

Ayarlanırsa, özellik yerine Events örneğini almak için hizmet türü olarak kullanılır.

(Devralındığı yer: AuthenticationSchemeOptions)
ExpireTimeSpan

Tanımlama bilgisinde depolanan kimlik doğrulama biletinin oluşturulduğu noktadan itibaren ne kadar süre geçerli kalacağını denetler. Süre sonu bilgileri korumalı tanımlama bilgisi biletinde depolanır. Bu nedenle, tarayıcı tarafından temizlendikten sonra sunucuya geçirilse bile süresi dolmuş bir tanımlama bilgisi yoksayılır.

Bu, tarayıcının tanımlama bilgisini ne kadar süreyle tutacağını belirten değerinden Expiresayrıdır.

ForwardAuthenticate

Ayarlanırsa, bu şemanın AuthenticateAsync çağrılarını iletmesi gereken hedef düzeni belirtir. Örneğin Context.AuthenticateAsync("ThisScheme") => Context.AuthenticateAsync("ForwardAuthenticateValue"); İletmeyi devre dışı bırakmak ve normal işlemeye izin vermek için hedefi geçerli şemaya ayarlayın.

(Devralındığı yer: AuthenticationSchemeOptions)
ForwardChallenge

Ayarlanırsa, bu şemanın ChallengeAsync çağrılarını iletmesi gereken hedef düzeni belirtir. Örneğin Context.ChallengeAsync("ThisScheme") => Context.ChallengeAsync("ForwardChallengeValue"); İletmeyi devre dışı bırakmak ve normal işlemeye izin vermek için hedefi geçerli şemaya ayarlayın.

(Devralındığı yer: AuthenticationSchemeOptions)
ForwardDefault

Ayarlanırsa, kimlik doğrulama işleyicilerinin varsayılan olarak tüm kimlik doğrulama işlemlerinin iletilmesi gereken bir varsayılan şema belirtir. Varsayılan iletme mantığı önce en belirli ForwardAuthenticate/Challenge/Forbid/SignIn/SignOut ayarını, ardından ForwardDefaultSelector'ı ve ardından ForwardDefault'u denetler. null olmayan ilk sonuç, iletilecek hedef düzen olarak kullanılır.

(Devralındığı yer: AuthenticationSchemeOptions)
ForwardDefaultSelector

Kimlik doğrulama işleyicilerinin tüm kimlik doğrulama işlemlerini varsayılan olarak 'a iletmesi gereken geçerli istek için varsayılan bir düzen seçmek için kullanılır. Varsayılan iletme mantığı önce en belirli ForwardAuthenticate/Challenge/Forbid/SignIn/SignOut ayarını, ardından ForwardDefaultSelector'ı ve ardından ForwardDefault'u denetler. null olmayan ilk sonuç, iletilecek hedef düzen olarak kullanılır.

(Devralındığı yer: AuthenticationSchemeOptions)
ForwardForbid

Ayarlanırsa, bu şemanın ForbidAsync çağrılarını iletmesi gereken hedef düzeni belirtir. Örneğin Context.ForbidAsync("ThisScheme") => Context.ForbidAsync("ForwardForbidValue"); İletmeyi devre dışı bırakmak ve normal işlemeye izin vermek için hedefi geçerli şemaya ayarlayın.

(Devralındığı yer: AuthenticationSchemeOptions)
ForwardSignIn

Ayarlanırsa, bu şemanın SignInAsync çağrılarını iletmesi gereken hedef düzeni belirtir. Örneğin Context.SignInAsync("ThisScheme") => Context.SignInAsync("ForwardSignInValue"); İletmeyi devre dışı bırakmak ve normal işlemeye izin vermek için hedefi geçerli şemaya ayarlayın.

(Devralındığı yer: AuthenticationSchemeOptions)
ForwardSignOut

Ayarlanırsa, bu şemanın SignOutAsync çağrılarını iletmesi gereken hedef düzeni belirtir. Örneğin Context.SignOutAsync("ThisScheme") => Context.SignOutAsync("ForwardSignOutValue"); İletmeyi devre dışı bırakmak ve normal işlemeye izin vermek için hedefi geçerli şemaya ayarlayın.

(Devralındığı yer: AuthenticationSchemeOptions)
LoginPath

LoginPath özelliği, ChallengeAsync işlenirken yeniden yönlendirme hedefi için işleyici tarafından kullanılır. LoginPath'e ReturnUrlParameter tarafından adlandırılan bir sorgu dizesi parametresi olarak eklenen geçerli URL. LoginPath'e yönelik bir istek yeni bir SignIn kimliği verdikten sonra, tarayıcıyı özgün URL'ye geri yönlendirmek için ReturnUrlParameter değeri kullanılır.

LogoutPath

LogoutPath'e işleyici sağlanmışsa, bu yola yönelik bir istek ReturnUrlParameter'ı temel alarak yeniden yönlendirilir.

ReturnUrlParameter

ReturnUrlParameter, bir Sınama sırasında işleyici tarafından eklenen sorgu dizesi parametresinin adını belirler. Bu aynı zamanda, eylem gerçekleştirildikten sonra özgün URL'ye dönmek için oturum açma yoluna veya oturumu kapatma yoluna bir istek geldiğinde aranan sorgu dizesi parametresidir.

SessionStore

İstekler arasında kimliğin depolandığı isteğe bağlı bir kapsayıcı. Kullanıldığında, istemciye yalnızca bir oturum tanımlayıcısı gönderilir. Bu, çok büyük kimliklerle ilgili olası sorunları azaltmak için kullanılabilir.

SlidingExpiration

SlidingExpiration, işleyiciye, sona erme penceresinin ortasından daha uzun olan bir isteği işlediğinde yeni bir sona erme zamanıyla yeni bir tanımlama bilgisini yeniden yayınlamasını istemek için true olarak ayarlanır.

TicketDataFormat

TicketDataFormat, tanımlama bilgisi değerinde depolanan kimliği ve diğer özellikleri korumak ve korumasını silmek için kullanılır. Sağlanmazsa kullanılarak DataProtectionProviderbir tane oluşturulur.

TimeProvider

Test için kullanılır.

(Devralındığı yer: AuthenticationSchemeOptions)

Yöntemler

Validate()

Seçeneklerin geçerli olup olmadığını denetleyin. her şey yolunda değilse bir özel durum oluşturmalıdır.

(Devralındığı yer: AuthenticationSchemeOptions)
Validate(String)

Seçeneklerin belirli bir düzen için geçerli olup olmadığını denetler

(Devralındığı yer: AuthenticationSchemeOptions)

Şunlara uygulanır