SessionAuthenticationModule.SessionSecurityTokenReceived Kejadian

Definisi

Ruang nama:

System.IdentityModel.Services

Rakitan:

System.IdentityModel.Services.dll

Terjadi ketika token keamanan sesi telah dibaca dari cookie.

public:
 event EventHandler<System::IdentityModel::Services::SessionSecurityTokenReceivedEventArgs ^> ^ SessionSecurityTokenReceived;

public event EventHandler<System.IdentityModel.Services.SessionSecurityTokenReceivedEventArgs> SessionSecurityTokenReceived;

member this.SessionSecurityTokenReceived : EventHandler<System.IdentityModel.Services.SessionSecurityTokenReceivedEventArgs> 

Public Event SessionSecurityTokenReceived As EventHandler(Of SessionSecurityTokenReceivedEventArgs) 

Jenis Acara

EventHandler<SessionSecurityTokenReceivedEventArgs>

Contoh

Kode berikut menunjukkan handler untuk peristiwa yang SessionSecurityTokenReceived diterapkan dalam file global.asax.cs aplikasi web ASP.NET. Anda juga harus menambahkan handler ke kejadian. Contoh yang lebih lengkap ditampilkan dalam SessionAuthenticationModule topik gambaran umum.

void SessionAuthenticationModule_SessionSecurityTokenReceived(object sender, SessionSecurityTokenReceivedEventArgs e)
{
    System.Diagnostics.Trace.WriteLine("Handling SessionSecurityTokenReceived event");
}

Keterangan

Peristiwa SessionSecurityTokenReceived dimunculkan dari dalam OnAuthenticateRequest metode setelah token sesi (SessionSecurityToken) berhasil dibaca dari cookie sesi.

Anda dapat menggunakan peristiwa ini untuk memodifikasi properti token sesi sebelum diteruskan lebih lanjut di sepanjang alur dan digunakan untuk mengautentikasi entitas yang membuat permintaan (pengguna). Salah satu skenario paling umum melibatkan modifikasi waktu kedaluwarsa sesi (dapat diakses melalui SessionSecurityToken.ValidTo properti ) untuk mengganti waktu kedaluwarsa sesi yang diatur dalam konfigurasi melalui lifetime atribut <elemen sessionTokenRequirement> . Dengan memodifikasi properti ini pada setiap permintaan, Anda dapat menerapkan sesi geser; yaitu, sesi di mana masa pakai diperpanjang setiap kali pengguna mengakses situs.

Dalam penanganan aktivitas, Anda dapat mengakses token melalui SessionSecurityTokenReceivedEventArgs.SessionToken properti . Setelah memodifikasi token, Anda dapat memastikan bahwa token ditulis kembali ke cookie dengan mengatur ke SessionSecurityTokenReceivedEventArgs.ReissueCookietrue. Terakhir, SessionSecurityTokenReceived peristiwa tersebut adalah peristiwa yang dapat dibatalkan, dan Anda dapat mengatur Cancel properti SessionSecurityTokenReceivedEventArgs untuk membatalkan pemrosesan permintaan lebih lanjut.