CookieAuthenticationOptions Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Opsi konfigurasi untuk CookieAuthenticationOptions.
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
- Warisan
Konstruktor
CookieAuthenticationOptions() |
Membuat instans opsi yang diinisialisasi dengan nilai default |
Properti
AccessDeniedPath |
Properti AccessDeniedPath digunakan oleh handler untuk target pengalihan saat menangani ForbidAsync. |
ClaimsIssuer |
Mendapatkan atau menetapkan penerbit yang harus digunakan untuk klaim apa pun yang dibuat (Diperoleh dari AuthenticationSchemeOptions) |
Cookie |
Menentukan pengaturan yang digunakan untuk membuat cookie. |
CookieDomain |
Kedaluwarsa.
Properti ini kedaluarsa dan akan dihapus dalam versi mendatang. Alternatif yang disarankan adalah pada Cookie. Menentukan domain yang digunakan untuk membuat cookie. Tidak disediakan secara default. |
CookieHttpOnly |
Kedaluwarsa.
Kedaluwarsa.
Properti ini kedaluarsa dan akan dihapus dalam versi mendatang. Alternatif yang disarankan adalah pada Cookie. 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 |
Kedaluwarsa.
Kedaluwarsa.
Properti ini kedaluarsa dan akan dihapus dalam versi mendatang. Alternatif yang disarankan adalah pada Cookie. 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 handler autentikasi cookie beberapa kali. |
CookiePath |
Kedaluwarsa.
Properti ini kedaluarsa dan akan dihapus dalam versi mendatang. Alternatif yang disarankan adalah pada Cookie. Menentukan jalur yang digunakan untuk membuat cookie. Nilai defaultnya adalah "/" untuk kompatibilitas browser tertinggi. |
CookieSecure |
Kedaluwarsa.
Properti ini kedaluarsa dan akan dihapus dalam versi mendatang. Alternatif yang disarankan adalah pada Cookie. 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 CookieAuthenticationHandler untuk perlindungan data. |
Events |
Penyedia dapat ditetapkan ke instans objek yang dibuat oleh aplikasi pada waktu mulai. Handler 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. |
EventsType |
Jika diatur, akan digunakan sebagai jenis layanan untuk mendapatkan instans Peristiwa alih-alih properti . (Diperoleh dari AuthenticationSchemeOptions) |
ExpireTimeSpan |
Mengontrol berapa banyak waktu tiket autentikasi yang disimpan dalam cookie akan tetap valid sejak dibuat. Informasi kedaluwarsa disimpan dalam tiket cookie yang dilindungi. Karena itu cookie yang kedaluwarsa akan diabaikan bahkan jika diteruskan ke server setelah browser seharusnya membersihkannya. Ini terpisah dari nilai Expires, yang menentukan berapa lama browser akan menyimpan cookie. |
ForwardAuthenticate |
Jika diatur, ini menentukan skema target tempat skema ini harus meneruskan panggilan AuthenticateAsync. Misalnya Context.AuthenticateAsync("ThisScheme") => Context.AuthenticateAsync("ForwardAuthenticateValue"); Atur target ke skema saat ini untuk menonaktifkan penerusan dan memungkinkan pemrosesan normal. (Diperoleh dari AuthenticationSchemeOptions) |
ForwardChallenge |
Jika diatur, ini menentukan skema target tempat skema ini harus meneruskan panggilan ChallengeAsync. Misalnya Context.ChallengeAsync("ThisScheme") => Context.ChallengeAsync("ForwardChallengeValue"); Atur target ke skema saat ini untuk menonaktifkan penerusan dan memungkinkan pemrosesan normal. (Diperoleh dari AuthenticationSchemeOptions) |
ForwardDefault |
Jika diatur, ini menentukan skema default yang harus diteruskan oleh penangan autentikasi ke semua operasi autentikasi secara default. Logika penerusan default akan memeriksa pengaturan ForwardAuthenticate/Challenge/Forbid/SignIn/SignOut yang paling spesifik terlebih dahulu, diikuti dengan memeriksa ForwardDefaultSelector, diikuti oleh ForwardDefault. Hasil bukan null pertama akan digunakan sebagai skema target untuk diteruskan. (Diperoleh dari AuthenticationSchemeOptions) |
ForwardDefaultSelector |
Digunakan untuk memilih skema default untuk permintaan saat ini yang harus diteruskan oleh penangan autentikasi ke semua operasi autentikasi secara default. Logika penerusan default akan memeriksa pengaturan ForwardAuthenticate/Challenge/Forbid/SignIn/SignOut yang paling spesifik terlebih dahulu, diikuti dengan memeriksa ForwardDefaultSelector, diikuti oleh ForwardDefault. Hasil bukan null pertama akan digunakan sebagai skema target untuk diteruskan. (Diperoleh dari AuthenticationSchemeOptions) |
ForwardForbid |
Jika diatur, ini menentukan skema target tempat skema ini harus meneruskan panggilan ForbidAsync. Misalnya Context.ForbidAsync("ThisScheme") => Context.ForbidAsync("ForwardForbidValue"); Atur target ke skema saat ini untuk menonaktifkan penerusan dan memungkinkan pemrosesan normal. (Diperoleh dari AuthenticationSchemeOptions) |
ForwardSignIn |
Jika diatur, ini menentukan skema target tempat skema ini harus meneruskan panggilan SignInAsync. Misalnya Context.SignInAsync("ThisScheme") => Context.SignInAsync("ForwardSignInValue"); Atur target ke skema saat ini untuk menonaktifkan penerusan dan memungkinkan pemrosesan normal. (Diperoleh dari AuthenticationSchemeOptions) |
ForwardSignOut |
Jika diatur, ini menentukan skema target tempat skema ini harus meneruskan panggilan SignOutAsync. Misalnya Context.SignOutAsync("ThisScheme") => Context.SignOutAsync("ForwardSignOutValue"); Atur target ke skema saat ini untuk menonaktifkan penerusan dan memungkinkan pemrosesan normal. (Diperoleh dari AuthenticationSchemeOptions) |
LoginPath |
Properti LoginPath digunakan oleh handler untuk target pengalihan saat menangani ChallengeAsync. Url saat ini yang ditambahkan ke LoginPath sebagai parameter string kueri yang dinamai oleh ReturnUrlParameter. Setelah permintaan ke LoginPath memberikan identitas SignIn baru, nilai ReturnUrlParameter digunakan untuk mengalihkan browser kembali ke url asli. |
LogoutPath |
Jika LogoutPath disediakan handler, maka permintaan ke jalur tersebut akan dialihkan berdasarkan ReturnUrlParameter. |
ReturnUrlParameter |
ReturnUrlParameter menentukan nama parameter string kueri yang ditambahkan oleh handler selama Tantangan. 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 handler untuk menerbitkan ulang cookie baru dengan waktu kedaluwarsa baru setiap kali memproses permintaan yang lebih dari setengah jalan melalui jendela kedaluwarsa. |
TicketDataFormat |
TicketDataFormat digunakan untuk melindungi dan membuka proteksi identitas dan properti lain yang disimpan dalam nilai cookie. Jika tidak disediakan, akan dibuat menggunakan DataProtectionProvider. |
TimeProvider |
Digunakan untuk pengujian. (Diperoleh dari AuthenticationSchemeOptions) |
Metode
Validate() |
Periksa apakah opsinya valid. Harus melemparkan pengecualian jika semuanya tidak baik-baik saja. (Diperoleh dari AuthenticationSchemeOptions) |
Validate(String) |
Memeriksa apakah opsi valid untuk skema tertentu (Diperoleh dari AuthenticationSchemeOptions) |
Berlaku untuk
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk