CookieAuthenticationOptions Sınıf

  • Başvuru

Tanım

Ad Alanı:
Microsoft.AspNetCore.Builder
Bütünleştirilmiş Kod:
Microsoft.AspNetCore.Authentication.Cookies.dll
Paket:
Microsoft.AspNetCore.Authentication.Cookies v1.0.0
Paket:
Microsoft.AspNetCore.Authentication.Cookies v1.1.0

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

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)
Devralma
Object
AuthenticationOptions
CookieAuthenticationOptions
Uygulamalar
IOptions<CookieAuthenticationOptions>

Oluşturucular

CookieAuthenticationOptions()

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

Özellikler

AccessDeniedPath

AccessDeniedPath özelliği, ara yazılımı giden 403 Yasak durum kodunu verilen yola 302 yeniden yönlendirmesine dönüştürmesi gerektiğini bildirir.
AuthenticationScheme

Seçeneklerdeki AuthenticationScheme, belirli bir kimlik doğrulama düzeninin mantıksal adına karşılık gelir. İşlem hattında aynı kimlik doğrulama ara yazılımı türünü birden çok kez kullanmak için farklı bir değer atanabilir.

(Devralındığı yer: AuthenticationOptions)
AutomaticAuthenticate

Doğruysa, kimlik doğrulama ara yazılımı gelen istek kullanıcısını değiştirir. False ise kimlik doğrulama ara yazılımı yalnızca AuthenticationScheme tarafından açıkça belirtildiğinde kimlik sağlar.

(Devralındığı yer: AuthenticationOptions)
AutomaticChallenge

Doğruysa, kimlik doğrulama ara yazılımı otomatik sınamayı işlemelidir. False ise, kimlik doğrulama ara yazılımı yalnızca AuthenticationScheme tarafından açıkça belirtildiğinde yanıtları değiştirir.

(Devralındığı yer: AuthenticationOptions)
ClaimsIssuer

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

(Devralındığı yer: AuthenticationOptions)
CookieDomain

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

Tarayıcının tanımlama bilgisine istemci tarafı javascript tarafından erişilmesine izin verilip verirseniz belirler. Varsayılan değer true'dır; 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

Kimliği kalıcı hale getirmek için kullanılan tanımlama bilgisi adını belirler. Varsayılan değer "'dir. AspNetCore.Cookies". AuthenticationScheme adını değiştirirseniz, özellikle sisteminiz tanımlama bilgisi kimlik doğrulaması ara yazılımını birden çok kez kullanıyorsa bu değer değiştirilmelidir.
CookiePath

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

Tanımlama bilgisinin yalnızca HTTPS isteğinde iletilip aktarılmadığını belirler. Varsayılan ayar, Oturum Açma işlemini 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, veri koruması için CookieAuthenticationMiddleware tarafından kullanılır.
Description

Uygulamanın kullanımına sunulan kimlik doğrulama türü hakkında ek bilgiler.

(Devralındığı yer: AuthenticationOptions)
Events

Sağlayıcı, başlatma sırasında uygulama tarafından oluşturulan bir nesnenin örneğine atanabilir. Ara yazılım, işlemenin gerçekleştiği belirli noktalarda uygulama denetimi sağlayan sağlayıcıdaki 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.
ExpireTimeSpan

Tanımlama bilgisinin oluşturulduğu noktadan itibaren ne kadar süre geçerli kalacağını denetler. Süre sonu bilgileri korumalı tanımlama bilgisi biletinde yer alır. Bu nedenle, tarayıcı temizlendikten sonra sunucuya geçirilse bile süresi dolmuş bir tanımlama bilgisi yoksayılır
LoginPath

LoginPath özelliği, ara yazılımı giden bir 401 Yetkisiz durum kodunu verilen oturum açma yoluna 302 yeniden yönlendirmesi olarak değiştirmesi gerektiğini bildirir. 401'i oluşturan geçerli URL, LoginPath'e ReturnUrlParameter tarafından adlandırılan bir sorgu dizesi parametresi olarak eklenir. LoginPath isteği yeni bir SignIn kimliği verildiğinde, tarayıcıyı yeniden yönlendirmek için ReturnUrlParameter değeri kullanılır
özgün yetkisiz durum koduna neden olan URL'ye.
LogoutPath

LogoutPath'e ara yazılım sağlanmışsa, bu yola yönelik bir istek ReturnUrlParameter'a göre yeniden yönlendirilir.
ReturnUrlParameter

ReturnUrlParameter, 401 Yetkisiz durum kodu oturum açma yoluna 302 yeniden yönlendirmesi olarak değiştirildiğinde ara yazılım 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, ara yazılıma, son kullanma süresinin yarısından daha uzun olan bir isteği işlediğinde yeni bir sona erme süresiyle yeni bir tanımlama bilgisi verme talimatı vermek için true olarak ayarlanır.
SystemClock

Yalnızca test amaçlıdır.
SystemClock

Yalnızca test amaçlıdır.

(Devralındığı yer: AuthenticationOptions)
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, IApplicationBuilder.Properties içinde yer alan veri koruma hizmeti kullanılarak bir varsayılan veri işleyicisi oluşturulur. Varsayılan veri koruma hizmeti, ASP.NET üzerinde çalışırken makine anahtarını ve farklı bir işlemde çalışırken DPAPI'yi temel alır.

Belirtik Arabirim Kullanımları

IOptions<CookieAuthenticationOptions>.Value

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

Şunlara uygulanır