MachineKeySessionSecurityTokenHandler Sınıf

Başvuru

Tanım

Ad Alanı:: System.IdentityModel.Services.Tokens

Bütünleştirilmiş Kod:: System.IdentityModel.Services.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.

Oturum belirteçlerini, yapılandırma dosyasındaki ASP.NET <machineKey> öğesinde belirtilen imzalama ve şifreleme anahtarlarını kullanarak işler.

public ref class MachineKeySessionSecurityTokenHandler : System::IdentityModel::Tokens::SessionSecurityTokenHandler

public class MachineKeySessionSecurityTokenHandler : System.IdentityModel.Tokens.SessionSecurityTokenHandler

type MachineKeySessionSecurityTokenHandler = class
    inherit SessionSecurityTokenHandler

Public Class MachineKeySessionSecurityTokenHandler
Inherits SessionSecurityTokenHandler

Devralma: Object

SecurityTokenHandler

SessionSecurityTokenHandler
MachineKeySessionSecurityTokenHandler

Örnekler

Aşağıdaki XML, imzalama ve şifreleme anahtarlarını açıkça belirtmek için yapılandırmada ASP.NET <machineKey> öğesinin nasıl kullanılacağını gösterir. <machineKey> öğesi, yapılandırma dosyasındaki öğesinin <system.web> altında belirtilir.

<machineKey compatibilityMode="Framework45" decryptionKey="CC510D … 8925E6" validationKey="BEAC8 … 6A4B1DE" />

Aşağıdaki XML, öğesinin belirteç işleyici koleksiyonuna nasıl ekleneceğini MachineKeySessionSecurityTokenHandler gösterir. Varsayılan SessionSecurityTokenHandler değer ilk olarak koleksiyondan kaldırılır. Belirteç işleyicileri securityTokenHandlers> öğesi altında< yapılandırılır.

<securityTokenHandlers>  
  <remove type="System.IdentityModel.Tokens.SessionSecurityTokenHandler, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
  <add type="System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
</securityTokenHandlers>

Açıklamalar

Varsayılan olarak sınıfı, SessionSecurityTokenHandler oturum belirtecini ProtectedDataCookieTransform korumak için Data Protection API'sini (DPAPI) kullanan sınıfını kullanır. DPAPI, kullanıcı veya makine kimlik bilgilerini kullanarak koruma sağlar ve anahtar verileri kullanıcı profilinde depolar. Bu, bir bilgisayarda imzalanan ve şifrelenen oturum belirtecinin farklı bir bilgisayarda doğrulanamayacağı veya şifresinin çözülemeyeceği anlamına gelir.

Buna karşılık sınıfı, MachineKeySessionSecurityTokenHandler yapılandırma dosyasındaki öğesinde <machineKey> belirtilen şifreleme malzemesini kullanarak oturum tanımlama bilgisi verilerini koruyan sınıfını kullanırMachineKeyTransform. Bu, aynı anahtarların (ve oturum belirteçlerinin) birden çok bilgisayarda kullanılabileceğini gösterir. Bu özellikle bir uygulama bir web grubuna dağıtıldığında önemlidir. Bir web grubunda dağıtılan uygulamaları korumak için Windows Identity Foundation'ı kullanma hakkında daha fazla bilgi için bkz. WIF ve Web Grupları.

Uygulamayı belirteç işleyici koleksiyonuna ekleyerek uygulamasını kullanacak MachineKeySessionSecurityTokenHandler şekilde yapılandırın. Böyle bir işleyici varsa, belirteç işleyici koleksiyonundan önce öğesini (veya sınıfından SessionSecurityTokenHandler türetilen herhangi bir işleyiciyi) kaldırmanız SessionSecurityTokenHandler gerekir. Bunun nedeni MachineKeySessionSecurityTokenHandler , ve belirteç işleyicisi koleksiyonunun SessionSecurityTokenHandler herhangi bir türde birden çok işleyici içerememesidir.

Oluşturucular

MachineKeySessionSecurityTokenHandler()	MachineKeySessionSecurityTokenHandler sınıfının yeni bir örneğini başlatır.
MachineKeySessionSecurityTokenHandler(TimeSpan)	Belirtilen varsayılan belirteç ömrüne MachineKeySessionSecurityTokenHandler sahip sınıfının yeni bir örneğini başlatır.

Özellikler

CanValidateToken	Bu işleyicinin türünde SessionSecurityTokenbelirteç doğrulamayı destekleyip desteklemediğini belirten bir değer alır. (Devralındığı yer: SessionSecurityTokenHandler)
CanWriteToken	Bu işleyicinin türünde SessionSecurityTokenbelirteçler yazıp yazamayacağını belirten bir değer alır. (Devralındığı yer: SessionSecurityTokenHandler)
Configuration	Geçerli örnek için yapılandırma sağlayan nesneyi alır veya ayarlar SecurityTokenHandlerConfiguration . (Devralındığı yer: SecurityTokenHandler)
ContainingCollection	Geçerli örneği içeren belirteç işleyici koleksiyonunu alır. (Devralındığı yer: SecurityTokenHandler)
CookieElementName	Tanımlama bilgisi öğesinin adını alır. (Devralındığı yer: SessionSecurityTokenHandler)
CookieNamespace	Tanımlama bilgisi öğesinin ad alanını alır. (Devralındığı yer: SessionSecurityTokenHandler)
TokenLifetime	Belirteç ömrünü alır veya ayarlar. (Devralındığı yer: SessionSecurityTokenHandler)
TokenType	Bu işleyicinin işlediği belirteçlerin türünü alır. (Devralındığı yer: SessionSecurityTokenHandler)
Transforms	Tanımlama bilgisine uygulanacak dönüşümleri alır. (Devralındığı yer: SessionSecurityTokenHandler)

Yöntemler

ApplyTransforms(Byte[], Boolean)	Belirtilen tanımlama bilgisini kodlamak veya kodunu çözmek için özelliği tarafından Transforms belirtilen dönüşümleri uygular. (Devralındığı yer: SessionSecurityTokenHandler)
CanReadKeyIdentifierClause(XmlReader)	Belirtilen XML okuyucusu tarafından başvuruda bulunılan XML öğesinin bu örnek tarafından seri durumdan çıkarılabilen bir anahtar tanımlayıcı yan tümcesi olup olmadığını gösteren bir değer döndürür. (Devralındığı yer: SecurityTokenHandler)
CanReadToken(String)	Belirtilen dizenin bu örnek tarafından işlenen türün belirteci olarak seri durumdan çıkarılıp seri durumdan çıkarılamayacağını belirten bir değer döndürür. (Devralındığı yer: SecurityTokenHandler)
CanReadToken(XmlReader)	Okuyucunun bir öğeye konumlandırılıp konumlandırılmadığını gösteren bir `<wsc:SecurityContextToken>` değer döndürür. (Devralındığı yer: SessionSecurityTokenHandler)
CanWriteKeyIdentifierClause(SecurityKeyIdentifierClause)	Belirtilen anahtar tanımlayıcı yan tümcesinin bu örnek tarafından serileştirilip serileştirilemeyeceğini belirten bir değer döndürür. (Devralındığı yer: SecurityTokenHandler)
CreateSecurityTokenReference(SecurityToken, Boolean)	Türetilmiş bir sınıfta geçersiz kılındığında, bu sınıf tarafından işlenen belirteçler için güvenlik belirteci başvurusu oluşturur. Bu yöntem genellikle bir güvenlik belirteci hizmeti (STS) tarafından çağrılır. (Devralındığı yer: SecurityTokenHandler)
CreateSessionSecurityToken(ClaimsPrincipal, String, String, DateTime, DateTime)	Belirtecin geçerli olduğu belirtilen talep sorumlusunu ve zaman aralığını temel alan bir SessionSecurityToken oluşturur. (Devralındığı yer: SessionSecurityTokenHandler)
CreateToken(SecurityTokenDescriptor)	Belirtilen belirteç tanımlayıcısını temel alan bir güvenlik belirteci oluşturur. (Devralındığı yer: SessionSecurityTokenHandler)
DetectReplayedToken(SecurityToken)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen belirteç yeniden yürütülüyor olarak algılanırsa bir özel durum oluşturur. (Devralındığı yer: SecurityTokenHandler)
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)
GetTokenTypeIdentifiers()	Bu işleyici tarafından işlenebilen belirteç türleri için belirteç türü URI'lerini alır. (Devralındığı yer: SessionSecurityTokenHandler)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
LoadCustomConfiguration(XmlNodeList)	XML'den özel yapılandırmayı yükler. (Devralındığı yer: SessionSecurityTokenHandler)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ReadKeyIdentifierClause(XmlReader)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen XML okuyucusu tarafından başvuruda bulunan XML'yi, türetilmiş sınıf tarafından işlenen bir belirteçe başvuran bir anahtar tanımlayıcı yan tümcesine seri durumdan çıkartır. (Devralındığı yer: SecurityTokenHandler)
ReadToken(Byte[], SecurityTokenResolver)	Belirtilen belirteç çözümleyicisini SessionSecurityToken kullanarak bayt akışından öğesini okur. (Devralındığı yer: SessionSecurityTokenHandler)
ReadToken(String)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen dizeyi türetilmiş sınıf tarafından işlenen türün belirtecine seri durumdan çıkartır. (Devralındığı yer: SecurityTokenHandler)
ReadToken(XmlReader)	Belirtilen XML okuyucuyu kullanarak okur SessionSecurityToken . (Devralındığı yer: SessionSecurityTokenHandler)
ReadToken(XmlReader, SecurityTokenResolver)	SessionSecurityToken Belirtilen XML okuyucuyu ve belirteç çözümleyicisini kullanarak okur. (Devralındığı yer: SessionSecurityTokenHandler)
SetTransforms(IEnumerable<CookieTransform>)	Tanımlama bilgilerine uygulanacak dönüşümleri ayarlar. (Devralındığı yer: SessionSecurityTokenHandler)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
TraceTokenValidationFailure(SecurityToken, String)	İzleme etkinleştirildiğinde güvenlik belirteçlerinin doğrulanması sırasında hata olayını izler. (Devralındığı yer: SecurityTokenHandler)
TraceTokenValidationSuccess(SecurityToken)	İzleme etkinleştirildiğinde güvenlik belirteçlerinin başarılı bir şekilde doğrulanması olayını izler. (Devralındığı yer: SecurityTokenHandler)
ValidateSession(SessionSecurityToken)	Belirtilen belirteçle ilişkili oturumun hala geçerli olup olmadığını belirler. Geçerlilik, belirtilen belirtecin ve ValidTo özellikleri denetlenerek ValidFrom belirlenir. Oturum artık geçerli değilse bir özel durum oluşturulur. (Devralındığı yer: SessionSecurityTokenHandler)
ValidateToken(SecurityToken)	Belirtilen belirteci doğrular ve taleplerini döndürür. (Devralındığı yer: SessionSecurityTokenHandler)
ValidateToken(SessionSecurityToken, String)	Belirtilen oturum belirtecini doğrular ve taleplerini döndürür. (Devralındığı yer: SessionSecurityTokenHandler)
WriteKeyIdentifierClause(XmlWriter, SecurityKeyIdentifierClause)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen anahtar tanımlayıcı yan tümcesini XML'ye serileştirir. Anahtar tanımlayıcı yan tümcesi türetilen sınıf tarafından desteklenen türde olmalıdır. (Devralındığı yer: SecurityTokenHandler)
WriteToken(SecurityToken)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen güvenlik belirtecini bir dizeye serileştirir. Belirteç, türetilen sınıf tarafından işlenen türden olmalıdır. (Devralındığı yer: SecurityTokenHandler)
WriteToken(SessionSecurityToken)	Belirtilen belirteci bir bayt dizisine serileştirir. (Devralındığı yer: SessionSecurityTokenHandler)
WriteToken(XmlWriter, SecurityToken)	Belirtilen XML yazıcısını kullanarak belirtilen belirteci serileştirir. (Devralındığı yer: SessionSecurityTokenHandler)

Şunlara uygulanır