SessionSecurityToken Sınıf

Tanım

Oturumla ilişkili verileri içeren bir güvenlik belirteci tanımlar.

public ref class SessionSecurityToken : System::IdentityModel::Tokens::SecurityToken, System::Runtime::Serialization::ISerializable
[System.Serializable]
public class SessionSecurityToken : System.IdentityModel.Tokens.SecurityToken, System.Runtime.Serialization.ISerializable
[<System.Serializable>]
type SessionSecurityToken = class
    inherit SecurityToken
    interface ISerializable
Public Class SessionSecurityToken
Inherits SecurityToken
Implements ISerializable
Devralma
SessionSecurityToken
Öznitelikler
Uygulamalar

Açıklamalar

Oturum belirteci, oturumu tanımlayan diğer parametrelerin yanı sıra oturum başlangıç ve bitiş saatleri gibi bir oturumla ilişkilendirilmiş kullanıcının öğesini depolar ClaimsPrincipal .

Pasif senaryolarda, WSFederationAuthenticationModuleSessionAuthenticationModule kimliği doğrulanmış kullanıcıyı temsil eden bir oturum belirteci oluşturmak için kimlik doğrulama işlem hattından ClaimsPrincipal (SAM) çağrısı yapar. SAM, belirteci oluşturmak ve bir tanımlama bilgisinde seri hale getirmek (ve sonraki isteklerde belirteci bir tanımlama bilgisinden seri durumdan çıkarmak için) için yapılandırılan SessionSecurityTokenHandler kullanır. SAM, tanımlama bilgisini HTTP Yanıtına geri yazmak için yapılandırılan CookieHandler sınıfının bir örneğini kullanır. Bu tanımlama bilgisi daha sonra istemciye döndürülür ve izleyen isteklerde istemci, kimlik sağlayıcısına bir güvenlik belirtecini yeniden almak için gidiş dönüş yapmak yerine tanımlama bilgisini sunabilir. Oturumların WIF ile nasıl çalıştığı hakkında daha fazla bilgi için bkz. WIF Oturum Yönetimi. Web grubu senaryolarında oturumları kullanma hakkında bilgi için bkz. WIF ve Web Grupları.

Oturum belirteci başvuru modunda çalışabilir veya çalışmayabilir. Oturum belirteci başvuru modunda çalışmıyorsa, belirtecin tamamı istemcide depolanan oturum tanımlama bilgisinde seri hale getirilir. Serileştirilmiş oturum belirteci oldukça büyük olabilir ve bu nedenle istemcide depolanan tanımlama bilgisi de oldukça büyük olabilir. Başvuru modunda, oturum belirtecinin tamamını tanımlama bilgisine seri hale getirmek yerine belirteç bir oturum güvenlik belirteci önbelleğinde depolanır ve yalnızca önbellekten belirteci almak için gereken anahtarı oluşturmak için kullanılan bilgiler tanımlama bilgisinde depolanır. Bu, tanımlama bilgisinin boyutunu büyük ölçüde azaltabilir. Oturum belirteci önbelleği, öğesinden SessionSecurityTokenCache türetilen bir sınıf tarafından uygulanır ve önbellek anahtarı sınıfı tarafından SessionSecurityTokenCacheKey uygulanır. ContextId ve KeyGeneration özellikleri, önbellek anahtarını oluşturmak için sınıfında kullanılırSessionSecurityTokenCacheKey.

IsReferenceMode özelliği oturum belirtecinin başvuru modunda olup olmadığını belirler.

Önemli

Başvuru modunda çalışmak için Microsoft, global.asax.cs dosyasındaki olay için WSFederationAuthenticationModule.SessionSecurityTokenCreated bir işleyici sağlamayı IsReferenceMode ve özelliğine geçirilen belirteçte özelliğini ayarlamayı SessionSecurityTokenCreatedEventArgs.SessionToken önerir. Bu, oturum belirtecinin her istek için başvuru modunda çalıştığından ve yalnızca Oturum Kimlik Doğrulama Modülü'nde özelliğin ayarlanmasından SessionAuthenticationModule.IsReferenceMode yana olmasını sağlar.

SessionSecurityTokenHandler WIF ile sağlanan sınıf, oturum belirtecini WS-Secure Konuşma <wsc:SecurityContextToken> öğesi olarak serileştirir.

Oluşturucular

SessionSecurityToken(ClaimsPrincipal)

Belirtilen sorumludan sınıfının yeni bir örneğini SessionSecurityToken başlatır.

SessionSecurityToken(ClaimsPrincipal, String)

Belirtilen sorumludan ve bootstrap belirtecinden sınıfının yeni bir örneğini SessionSecurityToken başlatır.

SessionSecurityToken(ClaimsPrincipal, String, Nullable<DateTime>, Nullable<DateTime>)

Sınıfın SessionSecurityToken yeni bir örneğini belirtilen sorumludan ve önyükleme belirtecinden ve belirtilen başlangıç saati ve süre sonu süresiyle başlatır.

SessionSecurityToken(ClaimsPrincipal, String, String, Nullable<DateTime>, Nullable<DateTime>)

Sınıfın SessionSecurityToken yeni bir örneğini belirtilen sorumludan ve önyükleme belirtecinden ve belirtilen başlangıç saati ve süre sonu süresiyle başlatır. Yeni belirtecin kapsamı belirtilen uç nokta olarak belirlenmiştir.

SessionSecurityToken(ClaimsPrincipal, TimeSpan)

Belirtilen sorumludan sınıfının yeni bir örneğini SessionSecurityToken başlatır. Yeni belirteç, belirtilen yaşam süresi boyunca geçerli UtcNow olur.

SessionSecurityToken(ClaimsPrincipal, UniqueId, String, String, DateTime, TimeSpan, SymmetricSecurityKey)

Belirtilen sorumlu, bağlam kimliği, bağlam, uç nokta, geçerli zaman damgası, yaşam süresi ve anahtarı kullanarak sınıfın yeni bir örneğini SessionSecurityToken başlatır.

SessionSecurityToken(ClaimsPrincipal, UniqueId, String, String, Nullable<DateTime>, Nullable<DateTime>, SymmetricSecurityKey)

Belirtilen sorumluyu, bağlam kimliğini, bağlamı, uç noktayı, başlangıç saatini, süre sonunu ve anahtarı kullanarak sınıfın yeni bir örneğini SessionSecurityToken başlatır.

SessionSecurityToken(ClaimsPrincipal, UniqueId, String, String, TimeSpan, SymmetricSecurityKey)

Belirtilen sorumlu, bağlam kimliği, bağlam, uç nokta, yaşam süresi ve anahtarı kullanarak sınıfının yeni bir örneğini SessionSecurityToken başlatır.

SessionSecurityToken(SerializationInfo, StreamingContext)

SessionSecurityToken sınıfının yeni bir örneğini serileştirilmiş verilerle başlatır.

Özellikler

ClaimsPrincipal

Oturumla ilişkili talep sorumlusunu alır.

Context

Kullanıcı tarafından belirtilen bağlam değerini alır.

ContextId

Oturum bağlamı tanımlayıcısını alır.

EndpointId

Bu belirtecin kapsamına alınan uç noktanın kimliğini alır.

Id

Bu belirtecin benzersiz tanımlayıcısını alır.

IsPersistent

Bu belirteçle temsil edilen tanımlama bilgisinin kalıcı olup olmadığını belirten bir değer alır veya ayarlar.

IsReferenceMode

Oturum güvenlik belirtecinin başvuru modunda çalışıp çalışmadığını belirten bir değer alır veya ayarlar.

KeyEffectiveTime

Bu belirteçteki anahtarın geçerli olduğu zamanı anında alır.

KeyExpirationTime

Bu belirteçteki anahtarın artık geçerli olmadığı süreyi anında alır.

KeyGeneration

Bu belirteçteki anahtar oluşturmanın tanımlayıcısını alır.

SecureConversationVersion

Bu oturum güvenlik belirtecini seri hale getirmek için kullanılan WS-Secure Konuşma sürümünü tanımlayan bir URI alır.

SecurityKeys

Bu oturumla ilişkili anahtarları alır. Bu genellikle tek bir anahtardır.

ValidFrom

Belirtecin geçerli olduğu zamanı anında alır.

ValidTo

Belirtecin artık geçerli olmadığı süreyi anında alır.

Yöntemler

CanCreateKeyIdentifierClause<T>()

Bu güvenlik belirtecinin belirtilen anahtar tanımlayıcısını oluşturup oluşturamadığını gösteren bir değer alır.

(Devralındığı yer: SecurityToken)
CreateKeyIdentifierClause<T>()

Belirtilen anahtar tanımlayıcı yan tümcesini oluşturur.

(Devralındığı yer: SecurityToken)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetObjectData(SerializationInfo, StreamingContext)

oturum güvenlik belirtecini SerializationInfo seri hale getirmek için gereken bilgilerle öğesini ayarlar.

GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MatchesKeyIdentifierClause(SecurityKeyIdentifierClause)

Bu örneğin anahtar tanımlayıcısının belirtilen anahtar tanımlayıcısına çözümlenip çözümlenemeyeceğini belirten bir değer döndürür.

(Devralındığı yer: SecurityToken)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ResolveKeyIdentifierClause(SecurityKeyIdentifierClause)

Belirtilen anahtar tanımlayıcı yan tümcesinin anahtarını alır.

(Devralındığı yer: SecurityToken)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Şunlara uygulanır

Ayrıca bkz.