SessionSecurityToken Sınıf

Başvuru

Tanım

Ad Alanı:: System.IdentityModel.Tokens

Bütünleştirilmiş Kod:: System.IdentityModel.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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: Object

SecurityToken
SessionSecurityToken

Öznitelikler: SerializableAttribute

Uygulamalar: ISerializable

Açıklamalar

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

Pasif senaryolarda, WSFederationAuthenticationModule SessionAuthenticationModule kimlik doğrulama işlem hattından (SAM) çağrısı yapar ve kimliği doğrulanmış kullanıcıyı temsil eden bir oturum belirteci ClaimsPrincipal oluşturur. SAM, belirteci oluşturmak ve bir tanımlama bilgisinde seri hale getirmek (ve sonraki isteklerde bir tanımlama bilgisinden belirteci seri durumdan çıkarmak için) için yapılandırılanını SessionSecurityTokenHandler kullanır. SAM, tanımlama bilgisini HTTP Yanıtına geri yazmak için yapılandırılmış CookieHandler sınıfının bir örneğini kullanır. Bu tanımlama bilgisi daha sonra istemciye döndürülür ve sonraki 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, çerezin 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ında 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 bir 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 sorumlu 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 bootstrap belirtecinden ve belirtilen başlangıç saati ve süre sonu zamanıyla başlatır.
SessionSecurityToken(ClaimsPrincipal, String, String, Nullable<DateTime>, Nullable<DateTime>)	Sınıfın SessionSecurityToken yeni bir örneğini belirtilen sorumludan ve bootstrap belirtecinden ve belirtilen başlangıç saati ve süre sonu zamanıyla başlatır. Yeni belirtecin kapsamı belirtilen uç noktayla belirlenir.
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ın yeni bir örneğini SessionSecurityToken başlatır.
SessionSecurityToken(ClaimsPrincipal, UniqueId, String, String, Nullable<DateTime>, Nullable<DateTime>, SymmetricSecurityKey)	Belirtilen sorumlu, bağlam kimliği, bağlam, uç nokta, başlangıç zamanı, süre sonu ve anahtarı kullanarak sınıfını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ç tarafından temsil edilen tanımlama bilgisinin kalıcı olup olmadığını gösteren 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şturma için tanımlayıcıyı alır.
SecureConversationVersion	Bu oturum güvenlik belirtecini serileştirmek 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 gösteren 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