Bagikan melalui


CookieAuthenticationOptions Kelas

Definisi

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
CookieAuthenticationOptions

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