CookieAuthenticationOptions Kelas

Definisi

Ruang nama:

Microsoft.AspNetCore.Builder

Rakitan:

Microsoft.AspNetCore.Authentication.Cookies.dll

Paket:

Microsoft.AspNetCore.Authentication.Cookies v1.1.0

Opsi konfigurasi untuk 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)

Warisan

Object

AuthenticationOptions

CookieAuthenticationOptions

Penerapan

IOptions<CookieAuthenticationOptions>

Konstruktor

CookieAuthenticationOptions()

Membuat instans opsi yang diinisialisasi dengan nilai default

Properti

AccessDeniedPath	Properti AccessDeniedPath menginformasikan middleware bahwa ia harus mengubah kode status Terlarang 403 keluar menjadi pengalihan 302 ke jalur yang diberikan.
AuthenticationScheme	AuthenticationScheme dalam opsi sesuai dengan nama logis untuk skema autentikasi tertentu. Nilai yang berbeda dapat ditetapkan untuk menggunakan jenis middleware autentikasi yang sama lebih dari sekali dalam alur. (Diperoleh dari AuthenticationOptions)
AutomaticAuthenticate	Jika benar, middleware autentikasi mengubah pengguna permintaan yang masuk. Jika salah, middleware autentikasi hanya akan memberikan identitas ketika secara eksplisit ditunjukkan oleh AuthenticationScheme. (Diperoleh dari AuthenticationOptions)
AutomaticChallenge	Jika benar, middleware autentikasi harus menangani tantangan otomatis. Jika false middleware autentikasi hanya akan mengubah respons ketika secara eksplisit ditunjukkan oleh AuthenticationScheme. (Diperoleh dari AuthenticationOptions)
ClaimsIssuer	Mendapatkan atau menetapkan penerbit yang harus digunakan untuk klaim apa pun yang dibuat (Diperoleh dari AuthenticationOptions)
CookieDomain	Menentukan domain yang digunakan untuk membuat cookie. Tidak disediakan secara default.
CookieHttpOnly	Menentukan apakah browser harus mengizinkan cookie diakses oleh javascript sisi klien. Defaultnya adalah true, yang berarti cookie hanya akan diteruskan ke permintaan http dan tidak tersedia untuk skrip di halaman.
CookieManager	Komponen yang digunakan untuk mendapatkan cookie dari permintaan atau mengaturnya pada respons. ChunkingCookieManager akan digunakan secara default.
CookieName	Menentukan nama cookie yang digunakan untuk mempertahankan identitas. Nilai defaultnya adalah ". AspNetCore.Cookies". Nilai ini harus diubah jika Anda mengubah nama AuthenticationScheme, terutama jika sistem Anda menggunakan middleware autentikasi cookie beberapa kali.
CookiePath	Menentukan jalur yang digunakan untuk membuat cookie. Nilai defaultnya adalah "/" untuk kompatibilitas browser tertinggi.
CookieSecure	Menentukan apakah cookie hanya boleh ditransmisikan pada permintaan HTTPS. Defaultnya adalah membatasi cookie ke permintaan HTTPS jika halaman yang melakukan SignIn juga HTTPS. Jika Anda memiliki halaman masuk HTTPS dan bagian situs Anda adalah HTTP, Anda mungkin perlu mengubah nilai ini.
DataProtectionProvider	Jika diatur, ini akan digunakan oleh CookieAuthenticationMiddleware untuk perlindungan data.
Description	Informasi tambahan tentang jenis autentikasi yang tersedia untuk aplikasi. (Diperoleh dari AuthenticationOptions)
Events	Penyedia dapat ditetapkan ke instans objek yang dibuat oleh aplikasi pada waktu mulai. Middleware memanggil metode pada penyedia yang memberikan kontrol aplikasi pada titik-titik tertentu di mana pemrosesan terjadi. Jika tidak disediakan, instans default disediakan yang tidak melakukan apa pun ketika metode dipanggil.
ExpireTimeSpan	Mengontrol berapa banyak waktu cookie akan tetap valid sejak dibuat. Informasi kedaluwarsa ada di tiket cookie yang dilindungi. Karena itu cookie yang kedaluwarsa akan diabaikan bahkan jika diteruskan ke server setelah browser seharusnya membersihkannya
LoginPath	Properti LoginPath menginformasikan middleware bahwa ia harus mengubah kode status 401 Tidak sah keluar menjadi pengalihan 302 ke jalur masuk yang diberikan. Url saat ini yang menghasilkan 401 ditambahkan ke LoginPath sebagai parameter string kueri bernama oleh ReturnUrlParameter. Setelah permintaan ke LoginPath memberikan identitas SignIn baru, nilai ReturnUrlParameter digunakan untuk mengalihkan browser kembali ke url yang menyebabkan kode status asli yang tidak sah.
LogoutPath	Jika LogoutPath disediakan middleware, maka permintaan ke jalur tersebut akan dialihkan berdasarkan ReturnUrlParameter.
ReturnUrlParameter	ReturnUrlParameter menentukan nama parameter string kueri yang ditambahkan oleh middleware ketika kode status 401 Tidak sah diubah menjadi pengalihan 302 ke jalur masuk. Ini juga merupakan parameter string kueri yang dicari ketika permintaan tiba di jalur login atau jalur keluar, untuk kembali ke url asli setelah tindakan dilakukan.
SessionStore	Kontainer opsional untuk menyimpan identitas di seluruh permintaan. Saat digunakan, hanya pengidentifikasi sesi yang dikirim ke klien. Ini dapat digunakan untuk mengurangi potensi masalah dengan identitas yang sangat besar.
SlidingExpiration	SlidingExpiration diatur ke true untuk menginstruksikan middleware untuk mengeluarkan kembali cookie baru dengan waktu kedaluwarsa baru setiap kali memproses permintaan yang lebih dari setengah jalan melalui jendela kedaluwarsa.
SystemClock	Hanya untuk tujuan pengujian. (Diperoleh dari AuthenticationOptions)
TicketDataFormat	TicketDataFormat digunakan untuk melindungi dan membuka proteksi identitas dan properti lain yang disimpan dalam nilai cookie. Jika tidak disediakan, handler data default dibuat menggunakan layanan perlindungan data yang terkandung dalam IApplicationBuilder.Properties. Layanan perlindungan data default didasarkan pada kunci komputer saat berjalan pada ASP.NET, dan pada DPAPI saat berjalan dalam proses yang berbeda.

Implementasi Antarmuka Eksplisit

IOptions<CookieAuthenticationOptions>.Value

Opsi konfigurasi untuk CookieAuthenticationMiddleware.