WSFederationAuthenticationModule.SessionSecurityTokenCreated Zdarzenie

Definicja

Przestrzeń nazw:

System.IdentityModel.Services

Zestaw:

System.IdentityModel.Services.dll

Występuje, gdy token zabezpieczający sesji został utworzony na podstawie tokenu zabezpieczającego odebranego z usługi tokenu zabezpieczającego (STS).

public:
 event EventHandler<System::IdentityModel::Services::SessionSecurityTokenCreatedEventArgs ^> ^ SessionSecurityTokenCreated;

public event EventHandler<System.IdentityModel.Services.SessionSecurityTokenCreatedEventArgs> SessionSecurityTokenCreated;

member this.SessionSecurityTokenCreated : EventHandler<System.IdentityModel.Services.SessionSecurityTokenCreatedEventArgs> 

Public Event SessionSecurityTokenCreated As EventHandler(Of SessionSecurityTokenCreatedEventArgs) 

Typ zdarzenia

EventHandler<SessionSecurityTokenCreatedEventArgs>

Przykłady

void WSFederationAuthenticationModule_SessionSecurityTokenCreated(object sender, SessionSecurityTokenCreatedEventArgs e)
{
    //Manipulate session token here, for example, changing its expiration value
    System.Diagnostics.Trace.WriteLine("Handling SessionSecurityTokenCreated event");
    System.Diagnostics.Trace.WriteLine("Key valid from: " + e.SessionToken.KeyEffectiveTime);
    System.Diagnostics.Trace.WriteLine("Key expires on: " + e.SessionToken.KeyExpirationTime);
}

Uwagi

Program obsługi zdarzeń można dodać, aby zmodyfikować token sesji, zanim zostanie użyty do ustawienia podmiotu zabezpieczeń wątku i zostanie zapisany w pliku cookie sesji. W procedurze obsługi zdarzeń można uzyskać dostęp do tokenu SessionSecurityTokenCreatedEventArgs.SessionToken sesji za pośrednictwem właściwości . Możesz określić, czy plik cookie sesji ma być zapisywany, ustawiając SessionSecurityTokenCreatedEventArgs.WriteSessionCookie właściwość .

To zdarzenie jest wywoływane z poziomu delegata OnAuthenticateRequest obsługi zdarzeń podczas przetwarzania komunikatu odpowiedzi logowania WS-Federation ("wsignin1.0") odebranego z usługi tokenu zabezpieczającego (STS). Jest zgłaszany tuż po zweryfikowaniu tokenu zabezpieczającego, który został deserializacji z wresult lub parametru wresultptr w komunikacie odpowiedzi logowania został zweryfikowany, a przed ustawieniem podmiotu zabezpieczeń oświadczeń na Thread.CurrentPrincipal obiekcie (i we User właściwości HttpContext.Current).

Ważne

Aby obsługiwać sesje w trybie referencyjnym, firma Microsoft zaleca udostępnienie procedury obsługi zdarzenia WSFederationAuthenticationModule.SessionSecurityTokenCreated w pliku global.asax.cs i ustawienie SessionSecurityToken.IsReferenceMode właściwości na tokenie przekazanym SessionSecurityTokenCreatedEventArgs.SessionToken we właściwości. Zapewni to, że token sesji działa w trybie referencyjnym dla każdego żądania i jest faworyzowany jedynie ustawienie SessionAuthenticationModule.IsReferenceMode właściwości w module uwierzytelniania sesji.