SessionAuthenticationModule.SessionSecurityTokenReceived Olay

Tanım

Ad Alanı:

System.IdentityModel.Services

Bütünleştirilmiş Kod:

System.IdentityModel.Services.dll

Oturum güvenlik belirteci bir tanımlama bilgisinden okunduğunda gerçekleşir.

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) 

Olay Türü

EventHandler<SessionSecurityTokenReceivedEventArgs>

Örnekler

Aşağıdaki kod, bir ASP.NET web uygulamasının SessionSecurityTokenReceived global.asax.cs dosyasında uygulanan olayın işleyicisini gösterir. İşleyiciyi olaya da eklemeniz gerekir. Genel bakış konusunda daha eksiksiz bir örnek gösterilmiştir SessionAuthenticationModule .

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

Açıklamalar

OlaySessionSecurityTokenReceived, oturum tanımlama bilgisinden bir oturum belirteci (SessionSecurityToken) başarıyla okunduktan sonra yönteminin içinden OnAuthenticateRequest oluşturulur.

İşlem hattı boyunca daha fazla geçirilmeden ve istekte bulunan varlığın (kullanıcı) kimliğini doğrulamak için kullanılmadan önce oturum belirtecinin özelliklerini değiştirmek için bu olayı kullanabilirsiniz. En yaygın senaryolardan biri, sessionTokenRequirement> öğesinin özniteliği aracılığıyla yapılandırmada ayarlanan oturum süre sonu süresini geçersiz kılmak için oturumun< sona erme süresini (özelliği aracılığıyla SessionSecurityToken.ValidTolifetime erişilebilir) değiştirmeyi içerir. Her istekte bu özelliği değiştirerek bir kayan oturum uygulayabilirsiniz; yani, kullanıcı siteye her eriştiğinde yaşam süresinin uzatıldığı bir oturumdur.

Bir olay işleyicisinde belirteci özelliği aracılığıyla SessionSecurityTokenReceivedEventArgs.SessionToken erişebilirsiniz. Belirteci değiştirdikten sonra, olarak ayarlayarak SessionSecurityTokenReceivedEventArgs.ReissueCookietruetanımlama bilgisine geri yazılmasını sağlayabilirsiniz. Son olarak, SessionSecurityTokenReceived olay iptal edilebilir bir olaydır ve özelliğini isteğin CancelSessionSecurityTokenReceivedEventArgs daha fazla işlenmesini durduracak şekilde ayarlayabilirsiniz.