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 otrzymanego 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

Można dodać program obsługi zdarzeń, aby zmodyfikować token sesji, zanim zostanie użyty do ustawienia podmiotu zabezpieczeń wątku i jest zapisywany 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 programu obsługi zdarzeń podczas przetwarzania komunikatu odpowiedzi logowania WS-Federation ("wsignin1.0") odebranego z usługi tokenu zabezpieczającego (STS). Jest on zgłaszany tuż po zdeserializowanym tokenie zabezpieczającym z wresult lub parametru wresultptr w komunikacie odpowiedzi logowania został zweryfikowany, a przed ustawieniem podmiotu HttpContext.Currentzabezpieczeń oświadczeń na Thread.CurrentPrincipal (i we User właściwości ).

Ważna

Aby obsługiwać sesje w trybie referencyjnym, firma Microsoft zaleca udostępnienie programu obsługi dla WSFederationAuthenticationModule.SessionSecurityTokenCreated zdarzenia 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 tylko przez ustawienie SessionAuthenticationModule.IsReferenceMode właściwości w module uwierzytelniania sesji.