MachineKeySessionSecurityTokenHandler Sınıf
Tanım
Ö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.
Bir yapılandırma dosyasındaki ASP.NET <machineKey> öğesinde belirtilen imzalama ve şifreleme anahtarlarını kullanarak oturum belirteçlerini işler.
public ref class MachineKeySessionSecurityTokenHandler : System::IdentityModel::Tokens::SessionSecurityTokenHandlerpublic class MachineKeySessionSecurityTokenHandler : System.IdentityModel.Tokens.SessionSecurityTokenHandlertype MachineKeySessionSecurityTokenHandler = class
inherit SessionSecurityTokenHandlerPublic Class MachineKeySessionSecurityTokenHandler
Inherits SessionSecurityTokenHandler- Devralma
Ö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şleyicisi 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 verilerini 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, MachineKeySessionSecurityTokenHandler sınıfı, yapılandırma dosyasındaki öğesinde MachineKeyTransform belirtilen şifreleme malzemesini kullanarak oturum tanımlama bilgisi verilerini koruyan sınıfını kullanır<machineKey>. 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. 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 MachineKeySessionSecurityTokenHandler ekleyerek kullanacak şekilde yapılandırın. Böyle bir işleyici varsa, önce belirteç işleyici koleksiyonundan (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
| Name | Description |
|---|---|
| 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 yeni bir örneğini başlatır. |
Özellikler
| Name | Description |
|---|---|
| CanValidateToken |
Bu işleyicinin türünde SessionSecurityTokenbelirteç doğrulamayı destekleyip desteklemediğini gösteren bir değer alır. (Devralındığı yer: SessionSecurityTokenHandler) |
| CanWriteToken |
Bu işleyicinin türünde SessionSecurityTokenbelirteçler yazıp yazamayacağını gösteren 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
| Name | Description |
|---|---|
| ApplyTransforms(Byte[], Boolean) |
Özelliği tarafından Transforms belirtilen dönüştürmeleri belirtilen tanımlama bilgisini kodlamak veya kodunu çözmek için 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 çıkarılamayacağını gösteren 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 |
| CanWriteKeyIdentifierClause(SecurityKeyIdentifierClause) |
Belirtilen anahtar tanımlayıcı yan tümcesinin bu örnek tarafından serileştirilip serileştirilemeyeceğini gösteren 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() |
Geçerli örneğin Type alır. (Devralındığı yer: Object) |
| LoadCustomConfiguration(XmlNodeList) |
XML'den özel yapılandırma yükler. (Devralındığı yer: SessionSecurityTokenHandler) |
| MemberwiseClone() |
Geçerli Objectbasit 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'nin seri durumdan çıkarılarak türetilen sınıf tarafından işlenen bir belirtece başvuran bir anahtar tanımlayıcı yan tümcesi kullanılı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 çıkar. (Devralındığı yer: SecurityTokenHandler) |
| ReadToken(XmlReader, SecurityTokenResolver) |
SessionSecurityToken Belirtilen XML okuyucuyu ve belirteç çözümleyicisini kullanarak öğesini okur. (Devralındığı yer: SessionSecurityTokenHandler) |
| ReadToken(XmlReader) |
Belirtilen XML okuyucuyu kullanarak öğesini SessionSecurityToken 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 bir dize 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 ValidFrom özellikleri denetlenerek ValidTo 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 için serileştirir. Anahtar tanımlayıcı yan tümcesi, türetilmiş 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üretilmiş 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) |
