SessionSecurityToken Sınıf

Tanım

Bir oturumla ilişkili verileri içeren bir güvenlik belirteci tanımlar.Defines a security token that contains data associated with a session.

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

Açıklamalar

Oturum belirteci, ClaimsPrincipal bir oturumla ilişkili kullanıcının yanı sıra oturumu tanımlayan diğer parametreleri (örneğin, oturum başlatma ve bitiş zamanları) depolar.A session token stores the ClaimsPrincipal of the user that is associated with a session as well as other parameters that define the session; for example the session start and end times.

Pasif senaryolarda, WSFederationAuthenticationModule SessionAuthenticationModule ClaimsPrincipal kimliği doğrulanmış kullanıcıyı temsil eden öğesinden bir oturum belirteci oluşturmak için kimlik doğrulama ardışık düzeninde (Sam) öğesine çağrı yapılır.In passive scenarios, the WSFederationAuthenticationModule calls into the SessionAuthenticationModule (SAM) from the authentication pipeline to create a session token from the ClaimsPrincipal that represents the authenticated user. SAM, SessionSecurityTokenHandler belirtecini oluşturmak ve bir tanımlama bilgisine seri hale getirmek için (ve sonraki isteklerde bir tanımlama bilgisinden belirteç serisini kaldırmak için) yapılandırılmış öğesini kullanır.The SAM uses its configured SessionSecurityTokenHandler to create the token and to serialize it into a cookie (and to deserialize the token from a cookie on subsequent requests). SAM, CookieHandler tanımlama BILGISINI HTTP yanıtına geri yazmak için yapılandırılmış sınıfının bir örneğini kullanır.The SAM uses an instance of its configured CookieHandler class to write the cookie back to the HTTP Response. Bu tanımlama bilgisi daha sonra istemciye ve sonraki isteklere döndürülür. bir güvenlik belirtecini yeniden almak için kimlik sağlayıcıya geri dönüş yapmak yerine, istemci tanımlama bilgisini sunabilir.This cookie is then returned to the client and on subsequent requests the client can present the cookie rather than making a round trip back to the identity provider to re-obtain a security token. Oturumların WıF ile nasıl çalıştığı hakkında daha fazla bilgi için bkz. WIF oturum yönetimi.For more information about how sessions operate with WIF, see WIF Session Management. Web grubu senaryolarında oturumları kullanma hakkında daha fazla bilgi için bkz. WIF ve Web grupları.For information about using sessions in Web farm scenarios, see WIF and Web Farms.

Bir oturum belirteci, başvuru modunda çalışabilir ya da değil.A session token can operate in either reference mode or not. Oturum belirteci başvuru modunda çalışmıyor ise, belirtecin tamamı istemcide depolanan oturum tanımlama bilgisine serileştirilir.If the session token is not operating in reference mode, the entire token is serialized into the session cookie that is stored on the client. Seri hale getirilmiş oturum belirteci çok büyük olabilir ve bu nedenle, istemcide depolanan tanımlama bilgisinin de oldukça boyutlandırılabilir hale getirilebilir.The serialized session token can be quite large and thus the cookie stored on the client can also be quite sizeable. Başvuru modunda, tüm oturum belirtecini tanımlama bilgisine serileştirmek yerine, belirteç bir oturum güvenlik belirteci önbelleğinde depolanır ve yalnızca belirteci önbellekten almak için gereken anahtarı oluşturmak için kullanılan bilgiler tanımlama bilgisinde depolanır.In reference mode, rather than serializing the entire session token into the cookie, the token is stored in a session security token cache and only the information used to generate the key necessary to retrieve the token from the cache is stored in the cookie. Bu, tanımlama bilgisinin boyutunu büyük ölçüde azaltabilir.This can greatly reduce the size of the cookie. Oturum belirteci önbelleği öğesinden türetilmiş bir sınıf tarafından uygulanır SessionSecurityTokenCache ve önbellek anahtarı sınıf tarafından uygulanır SessionSecurityTokenCacheKey .The session token cache is implemented by a class derived from SessionSecurityTokenCache and the cache key is implemented by the SessionSecurityTokenCacheKey class. ContextIdVe KeyGeneration Özellikleri, SessionSecurityTokenCacheKey sınıfında önbellek anahtarını oluşturmak için kullanılır.The ContextId and KeyGeneration properties are used in the SessionSecurityTokenCacheKey class to generate the cache key.

IsReferenceModeÖzelliği, oturum belirtecinin başvuru modunda olup olmadığını belirler.The IsReferenceMode property determines whether the session token is in reference mode or not.

Önemli

Microsoft, başvuru modunda çalışmak için global.asax.cs dosyasında olay için bir işleyici sağlamayı WSFederationAuthenticationModule.SessionSecurityTokenCreated ve özelliği IsReferenceMode içinde geçirilen belirtece ayarlamayı önerir SessionSecurityTokenCreatedEventArgs.SessionToken .To operate in reference mode, Microsoft recommends providing a handler for the WSFederationAuthenticationModule.SessionSecurityTokenCreated event in the global.asax.cs file and setting the IsReferenceMode property on the token passed in the SessionSecurityTokenCreatedEventArgs.SessionToken property. Bu, oturum belirtecinin her istek için başvuru modunda çalışmasını ve yalnızca SessionAuthenticationModule.IsReferenceMode oturum kimlik doğrulama modülündeki özelliği ayarlamak için daha fazla Red olmasını sağlayacaktır.This will ensure that the session token operates in reference mode for every request and is favored over merely setting the SessionAuthenticationModule.IsReferenceMode property on the Session Authentication Module.

SessionSecurityTokenHandlerWIF ile birlikte sunulan sınıf, oturum BELIRTECINI WS-Secure konuşma öğesi olarak serileştirir <wsc:SecurityContextToken> .The SessionSecurityTokenHandler class provided with WIF serializes the session token as a WS-Secure Conversation <wsc:SecurityContextToken> element.

Oluşturucular

SessionSecurityToken(ClaimsPrincipal)

SessionSecurityTokenBelirtilen sorumludan sınıfın yeni bir örneğini başlatır.Initializes a new instance of the SessionSecurityToken class from the specified principal.

SessionSecurityToken(ClaimsPrincipal, String)

SessionSecurityTokenBelirtilen asıl ve önyükleme belirtecinden sınıfının yeni bir örneğini başlatır.Initializes a new instance of the SessionSecurityToken class from the specified principal and bootstrap token.

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

SessionSecurityTokenBelirtilen asıl ve önyükleme belirtecinden sınıfının yeni bir örneğini başlatır ve belirtilen başlangıç ve sona erme zamanına göre.Initializes a new instance of the SessionSecurityToken class from the specified principal and bootstrap token; and with the specified start time and expiration time.

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

SessionSecurityTokenBelirtilen asıl ve önyükleme belirtecinden sınıfının yeni bir örneğini başlatır ve belirtilen başlangıç ve sona erme zamanına göre.Initializes a new instance of the SessionSecurityToken class from the specified principal and bootstrap token; and with the specified start time and expiration time. Yeni belirteç, belirtilen uç noktaya göre kapsamlandırılır.The new token is scoped to the specified endpoint.

SessionSecurityToken(ClaimsPrincipal, TimeSpan)

SessionSecurityTokenBelirtilen sorumludan sınıfın yeni bir örneğini başlatır.Initializes a new instance of the SessionSecurityToken class from the specified principal. Yeni belirteç, UtcNow belirtilen yaşam süresinden itibaren geçerlidir.The new token is valid from UtcNow through the specified lifetime.

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

SessionSecurityTokenBelirtilen asıl, bağlam kimliği, bağlam, uç nokta, geçerli zaman damgası, ömür ve anahtarı kullanarak sınıfının yeni bir örneğini başlatır.Initializes a new instance of the SessionSecurityToken class by using the specified principal, context ID, context, endpoint, valid timestamp, lifetime, and key.

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

SessionSecurityTokenBelirtilen sorumluyu, bağlam Kimliğini, bağlamı, uç noktayı, başlangıç saatini, sona erme saatini ve anahtarı kullanarak sınıfının yeni bir örneğini başlatır.Initializes a new instance of the SessionSecurityToken class by using the specified principal, context ID, context, endpoint, start time, expiration time, and key.

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

SessionSecurityTokenBelirtilen asıl, bağlam kimliği, bağlam, uç nokta, ömür ve anahtarı kullanarak sınıfının yeni bir örneğini başlatır.Initializes a new instance of the SessionSecurityToken class by using the specified principal, context ID, context, endpoint, lifetime, and key.

SessionSecurityToken(SerializationInfo, StreamingContext)

SessionSecurityToken sınıfının yeni bir örneğini serileştirilmiş verilerle başlatır.Initializes a new instance of the SessionSecurityToken class with serialized data.

Özellikler

ClaimsPrincipal

Oturumla ilişkili olan talep sorumlusunu alır.Gets the claims principal associated with the session.

Context

Kullanıcı tarafından belirtilen bağlam değerini alır.Gets a user specified context value.

ContextId

Oturum bağlam tanımlayıcısını alır.Gets the session context identifier.

EndpointId

Bu belirtecin kapsama sahip olduğu uç noktanın KIMLIĞINI alır.Gets the ID of the endpoint to which this token is scoped.

Id

Bu belirtecin benzersiz tanımlayıcısını alır.Gets the unique identifier of this token.

IsPersistent

Bu belirteçle temsil edilen tanımlama bilgisinin kalıcı olup olmadığını gösteren bir değer alır veya ayarlar.Gets or sets a value that indicates whether the cookie represented by this token is persistent.

IsReferenceMode

Oturum güvenlik belirtecinin başvuru modunda çalışıp çalışmadığını gösteren bir değer alır veya ayarlar.Gets or sets a value that indicates whether the session security token is operating in reference mode.

KeyEffectiveTime

Bu belirteçteki anahtarın geçerli olduğu anında zaman alır.Gets the time instant from which the key in this token is valid.

KeyExpirationTime

Bu belirteçteki anahtarın artık geçerli olmadığı anında zaman alır.Gets the time instant after which the key in this token is no longer valid.

KeyGeneration

Bu belirteçteki anahtar üretimi için tanımlayıcıyı alır.Gets the identifier for the key generation in this token.

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.Gets a URI that identifies the version of WS-Secure Conversation that is used to serialize this session security token.

SecurityKeys

Bu oturumla ilişkili anahtarları alır.Gets the keys associated with this session. Bu genellikle tek bir anahtardır.This is usually a single key.

ValidFrom

Belirtecin geçerli olduğu anında zaman alır.Gets the time instant from which the token is valid.

ValidTo

Belirtecin artık geçerli olmadığı anında zaman alır.Gets the time instant after which the token is no longer valid.

Yöntemler

CanCreateKeyIdentifierClause<T>()

Bu güvenlik belirtecinin belirtilen anahtar tanımlayıcısını oluşturma yeteneğine sahip olup olmadığını gösteren bir değer alır.Gets a value that indicates whether this security token is capable of creating the specified key identifier.

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

Belirtilen anahtar tanımlayıcı yan tümcesini oluşturur.Creates the specified key identifier clause.

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

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

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

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

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

SerializationInfoOturum güvenlik belirtecini seri hale getirmek için gereken bilgileri ayarlar.Sets the SerializationInfo with information necessary to serialize the session security token.

GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

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

Bu örnek iç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.Returns a value that indicates whether the key identifier for this instance can be resolved to the specified key identifier.

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

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

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

Belirtilen anahtar tanımlayıcı yan tümcesinin anahtarını alır.Gets the key for the specified key identifier clause.

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

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)

Şunlara uygulanır

Ayrıca bkz.