SessionAuthenticationModule.OnAuthenticateRequest(Object, EventArgs) Metode

Definisi

Ruang nama:

System.IdentityModel.Services

Rakitan:

System.IdentityModel.Services.dll

AuthenticateRequest Menangani peristiwa dari alur ASP.NET.

protected:
 virtual void OnAuthenticateRequest(System::Object ^ sender, EventArgs ^ eventArgs);

protected virtual void OnAuthenticateRequest (object sender, EventArgs eventArgs);

abstract member OnAuthenticateRequest : obj * EventArgs -> unit
override this.OnAuthenticateRequest : obj * EventArgs -> unit

Protected Overridable Sub OnAuthenticateRequest (sender As Object, eventArgs As EventArgs)

Parameter

sender

Object

Sumber untuk peristiwa tersebut. Ini akan menjadi HttpApplication objek.

eventArgs

EventArgs

Data untuk peristiwa tersebut.

Pengecualian

InvalidOperationException

Tidak ada handler token sesi yang valid yang dikonfigurasi. (Tidak ada SessionSecurityTokenHandler yang dikonfigurasi di SecurityTokenHandlers properti.)

Keterangan

Metode ini melakukan hal berikut:

1. TryReadSessionTokenFromCookie Memanggil metode untuk membaca SessionSecurityToken dari cookie sesi, jika ada.

2. Jika token keamanan sesi tidak dapat dibaca (kemungkinan besar karena sesi belum dibuat), kembalikan.

3. OnSessionSecurityTokenReceived Memanggil metode untuk menaikkan SessionSecurityTokenReceived peristiwa. Ini memberikan kesempatan bagi token yang dibaca dari cookie untuk dimodifikasi atau agar permintaan dibatalkan. Handler juga dapat menentukan bahwa token harus diterbitkan kembali, dengan mengatur SessionSecurityTokenReceivedEventArgs.ReissueCookie properti .

4. Jika token akan diterbitkan kembali, menghapusnya dari cache dan memanggil OnSessionSecurityTokenCreated metode untuk menaikkan SessionSecurityTokenCreated peristiwa. Ini memberikan kesempatan bagi token untuk kembali dimodifikasi. Perilaku penerbitan ulang juga dapat dimodifikasi dengan mengatur SessionSecurityTokenCreatedEventArgs.WriteSessionCookie properti di penanganan aktivitas.

5. Memanggil AuthenticateSessionSecurityToken metode untuk mengautentikasi pengguna. Jika berhasil, ini memiliki efek mengatur Thread.CurrentPrincipal properti ke prinsipal yang terkandung dalam SessionSecurityToken.ClaimsPrincipal properti token masuk.

6. Jika sesi telah kedaluwarsa, panggil SignOut metode .

Metode OnAuthenticateRequest ditambahkan ke handler untuk HttpApplication.AuthenticateRequest peristiwa dalam InitializeModule metode .