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.
Oturum belirteçlerini, yapılandırma dosyasındaki ASP.NET ve şifreleme <machineKey> anahtarlarını kullanarak işleme.
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ı ASP.NET için yapılandırmada ASP.NET <machineKey> öğesinin nasıl kullanılacazı gösterir. öğesi, <machineKey> yapılandırma <system.web> dosyasındaki öğesi altında belirtilir.
<machineKey compatibilityMode="Framework45" decryptionKey="CC510D … 8925E6" validationKey="BEAC8 … 6A4B1DE" />
Aşağıdaki XML, belirteci işleyici MachineKeySessionSecurityTokenHandler koleksiyonuna eklemeyi 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, SessionSecurityTokenHandler sınıfı, oturum belirteci korumak için Veri Koruma API'sini ProtectedDataCookieTransform (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 imzalanmış ve şifrelenmiş bir oturum belirtecin farklı bir bilgisayarda doğrulanamadı veya şifresinin çözülene anlamına gelir.
Buna karşılık sınıfı, yapılandırma dosyasındaki öğesinde belirtilen şifreleme malzemelerini kullanarak oturum tanımlama bilgisi MachineKeySessionSecurityTokenHandler MachineKeyTransform verilerini koruyan <machineKey> sınıfını kullanır. Bu, aynı anahtarların (ve oturum belirteçleri) birden çok bilgisayarda kullanılaly olduğu anlamına gelir. Bu, bir uygulama bir web grubu içinde dağıtıldığında özellikle önemlidir. Bir web grubu içinde dağıtılan uygulamaları korumak için Windows Identity Foundation'ın nasıl kullanılacağı hakkında daha fazla bilgi için bkz. WIF ve Web Farms.
Belirteci işleyici MachineKeySessionSecurityTokenHandler koleksiyonuna ekleyerek uygulamayı kullanmak üzere yapılandırma. Böyle bir işleyici varsa, önce belirteci işleyici koleksiyonundan (veya sınıfından türetilen herhangi SessionSecurityTokenHandler SessionSecurityTokenHandler bir işleyici) kaldırmanız gerekir. Bunun nedeni, MachineKeySessionSecurityTokenHandler ve belirteç SessionSecurityTokenHandler işleyicisi koleksiyonundan türetildi ve herhangi bir türe ait birden çok işleyici içereci içereye sahip olamaz.
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ılır. |
Özellikler
| CanValidateToken |
Bu işleyicinin türünde belirteçlerin doğrulanmasına destek olup olmadığını belirten bir değer SessionSecurityToken alır. (Devralındığı yer: SessionSecurityTokenHandler) |
| CanWriteToken |
Bu işleyicinin türünde belirteçler yazıp yazamıyr olmadığını belirten bir değer SessionSecurityToken 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şlemektedir belirteçlerin türünü alır. (Devralındığı yer: SessionSecurityTokenHandler) |
| Transforms |
Tanımlama bilgisi için uygulanacak dönüştürmeleri alır. (Devralındığı yer: SessionSecurityTokenHandler) |
Yöntemler
| ApplyTransforms(Byte[], Boolean) |
Özelliği tarafından belirtilen dönüştürmeleri belirtilen Transforms 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 seri durumdan çıkarılamayacağını belirten bir değer döndürür. (Devralındığı yer: SecurityTokenHandler) |
| CanReadToken(XmlReader) |
Okuyucunun bir öğeye konum verilip konum olmadığını belirten bir değer |
| 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) |
SessionSecurityTokenBelirteci geçerli olduğu belirtilen talep sorumlusuna ve zaman aralığına göre bir oluşturur. (Devralındığı yer: SessionSecurityTokenHandler) |
| CreateToken(SecurityTokenDescriptor) |
Belirtilen belirteç tanımlayıcısına göre 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şlenmeyecek belirteç türleri için belirteç türü URL'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ırma 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'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ç SessionSecurityToken çözümleyicisini kullanarak bayt akışından 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 belirtecine seri durumdan çıkartır. (Devralındığı yer: SecurityTokenHandler) |
| ReadToken(XmlReader) |
Belirtilen SessionSecurityToken XML okuyucuyu kullanarak okur. (Devralındığı yer: SessionSecurityTokenHandler) |
| ReadToken(XmlReader, SecurityTokenResolver) |
Belirtilen SessionSecurityToken XML okuyucu ve belirteç çözümleyicisini kullanarak dosyasını okur. (Devralındığı yer: SessionSecurityTokenHandler) |
| SetTransforms(IEnumerable<CookieTransform>) |
Tanımlama bilgilerine uygulanacak dönüştürmeleri 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 belirteci ValidFrom ve ValidTo özellikleri denetlenerek belirlenir. Oturum artık geçerli değilse bir özel durum oluşturur. (Devralındığı yer: SessionSecurityTokenHandler) |
| ValidateToken(SecurityToken) |
Belirtilen belirteci doğrular ve talepleri döndürür. (Devralındığı yer: SessionSecurityTokenHandler) |
| ValidateToken(SessionSecurityToken, String) |
Belirtilen oturum belirteci doğrulanır ve talepleri 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 byte dizisine seri hale getirme. (Devralındığı yer: SessionSecurityTokenHandler) |
| WriteToken(XmlWriter, SecurityToken) |
Belirtilen XML yazıcıyı kullanarak belirtilen belirteci seri hale getirme. (Devralındığı yer: SessionSecurityTokenHandler) |