SecurityTokenHandler 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.

Güvenlik belirteci işleyicileri için soyut temel sınıf.

public ref class SecurityTokenHandler abstract : System::IdentityModel::Configuration::ICustomIdentityConfiguration

public abstract class SecurityTokenHandler : System.IdentityModel.Configuration.ICustomIdentityConfiguration

type SecurityTokenHandler = class
    interface ICustomIdentityConfiguration

Public MustInherit Class SecurityTokenHandler
Implements ICustomIdentityConfiguration

Devralma: Object
SecurityTokenHandler

Türetilmiş: System.IdentityModel.Tokens.EncryptedSecurityTokenHandler

System.IdentityModel.Tokens.KerberosSecurityTokenHandler

System.IdentityModel.Tokens.RsaSecurityTokenHandler

System.IdentityModel.Tokens.Saml2SecurityTokenHandler

System.IdentityModel.Tokens.SamlSecurityTokenHandler

Diğer…

Uygulamalar: ICustomIdentityConfiguration

Örnekler

tüm SecurityTokenHandler konu başlıklarındaki kod örnekleri Custom Token örneğinden alınmıştır. Bu örnek, Basit Web Belirteçlerinin (SWT) işlenmesini sağlayan özel sınıflar sağlar. Bu örnek ve WIF için kullanılabilen diğer örnekler ve bunların nereden indirileceği hakkında bilgi için bkz. WIF Kod Örneği Dizini. Aşağıdaki XML, SWT belirteç işleyicisinin belirteç işleyicileri koleksiyonuna nasıl ekleneceğini gösterir.

<system.identityModel>
  <identityConfiguration saveBootstrapContext="true">
    <issuerTokenResolver type="SimpleWebToken.CustomIssuerTokenResolver, SimpleWebToken">
      <AddAudienceKeyPair  symmetricKey="wAVkldQiFypTQ+kdNdGWCYCHRcee8XmXxOvgmak8vSY=" audience="http://localhost:19851/" />
    </issuerTokenResolver>
    <issuerNameRegistry type="RelyingParty.TrustedIssuerNameRegistry, RelyingParty"/>
    <audienceUris>
      <add value="http://localhost:19851/"/>
    </audienceUris>
    <securityTokenHandlers>
      <add type="SimpleWebToken.SimpleWebTokenHandler, SimpleWebToken" />
    </securityTokenHandlers>
  </identityConfiguration>
</system.identityModel>

Açıklamalar

SecurityTokenHandler sınıfı, tüm güvenlik belirteci işleyicilerinin türetildiği temel sınıftır. Güvenlik belirteci işleyicisi şu işlemden sorumludur:

Belirteçte yer alan talepleri işlemek ve bir ClaimsIdentity nesnesine paketlemek için tasarlandığı türün güvenlik belirteçlerini (SecurityToken) doğrulama.
İşlenmek üzere tasarlandığı türdeki güvenlik belirteçlerini seri hale getirme ve seri durumdan çıkarma.
<wsse:SecurityTokenReference> öğeleri işlemek için tasarlandığı türdeki belirteçlere başvuran anahtar tanımlayıcı yan tümcelerini (SecurityKeyIdentifierClause) seri hale getirme ve seri durumdan çıkarma.
SecurityTokenService sınıfının uygulamaları tarafından geçirilen bir SecurityTokenDescriptor nesnesinden güvenlik belirteçleri oluşturma.
SecurityTokenService sınıfının uygulamaları için bir güvenlik belirtecinden anahtar tanımlayıcı yan tümceleri oluşturma.

Windows Identity Foundation (WIF), aşağıdaki güvenlik belirteci işleyicilerini kutudan çıkarır:

Bu sınıfların çoğu, sınıfın tasarlandığı belirteçlerin işlenmesine özgü işlevleri uygulayan ek üyeleri kullanıma sunar. Çoğu durumda, doğrudan SecurityTokenHandler sınıfından değil, bu sınıflardan birinden türetmek daha iyi olabilir.

Güvenlik belirteci işleyicisi,ekleme , kaldırma veya bir yapılandırma dosyasındaki securityTokenHandlers öğesi altındaki öğelerini temizleme belirterek belirteç işleyici koleksiyonundan eklenebilir veya kaldırılabilir. İşleyici koleksiyonunun yapılandırma ayarlarını içeren SecurityTokenHandlerConfiguration nesnesine Configuration özelliği üzerinden erişilebilir ve belirteç işleyicisinin üyesi olduğu işleyici koleksiyonuna ContainingCollection özelliğinden erişilebilir. İşleyicinizin aldığı özel yapılandırma öğelerini işlemek için LoadCustomConfiguration yöntemini geçersiz kılabilirsiniz.

SecurityTokenHandler sınıfı diğer birkaç özelliği ve yöntemi kullanıma sunar. Uygulamayı seçtiğiniz işlevselliğe bağlı olarak, bu üyelerin bazılarını veya tümünü geçersiz kılabilirsiniz.

WIF altyapısına sınıfınızın işlemek üzere tasarlandığı güvenlik belirtecinin türü hakkında bilgi sağlamak için TokenType özelliğini ve GetTokenTypeIdentifiers yöntemini geçersiz kılmalısınız.

Doğrulama, serileştirme ve seri durumdan çıkarma işlevselliği, işleyicinin işlevi uygulayan yöntem veya yöntemlerle birlikte belirli bir işlevi gerçekleştirip gerçekleştiremeyeceğini gösteren özellikler veya yöntemler aracılığıyla kullanıma sunulur. Aşağıdaki liste, işlevselliği gösteren özellikleri veya yöntemleri bu işlevselliği uygulayan yöntemlerle eşleştirmektedir:

CanValidateToken özelliği ve ValidateToken yöntemi: Belirteci doğrular ve belirteçte yer alan talepleri bir ClaimsIdentityiçinde paketler.
CanWriteToken özelliği ve WriteToken yöntemleri: Belirteç serileştirme.
CanReadToken yöntemleri ve ReadToken yöntemleri: Belirteç seri durumdan çıkarma.
CanReadKeyIdentifierClause yöntemi ve ReadKeyIdentifierClause yöntemi: Anahtar tanımlayıcı yan tümcelerini seri durumdan çıkarma.
CanWriteKeyIdentifierClause yöntemi ve WriteKeyIdentifierClause yöntemi: Anahtar tanımlayıcı yan tümcelerini seri hale getirme.

CreateToken ve CreateSecurityTokenReference yöntemleri, SecurityTokenService sınıfının uygulamalarında işlem hattından çağrılır.

DetectReplayedToken yöntemi, belirtilen belirtecin zaten alınıp alınmadığını belirlemek için WIF altyapısı tarafından çağrılır. Varsayılan olarak bu yöntem, belirtecin henüz alınmadığını gösteren falsedöndürür. yöntemini geçersiz kılabilir ve yeniden oynatılan belirteçleri algılamak için mantık sağlayabilirsiniz.

Oluşturucular

SecurityTokenHandler()

SecurityTokenHandler sınıfını başlatmak için türetilmiş sınıflardaki oluşturuculardan çağrılır.

Özellikler

CanValidateToken	İşleyicinin güvenlik belirteçlerinin doğrulamasını destekleyip desteklemediğini gösteren bir değer alır.
CanWriteToken	İşleyicinin güvenlik belirteçlerini serileştirip serileştiremeyeceğini gösteren bir değer alır.
Configuration	Geçerli örnek için yapılandırma sağlayan SecurityTokenHandlerConfiguration nesnesini alır veya ayarlar.
ContainingCollection	Geçerli örneği içeren belirteç işleyici koleksiyonunu alır.
TokenType	Türetilmiş bir sınıfta geçersiz kılındığında, bu örnek tarafından işlenen güvenlik belirtecinin türünü alır.

Yöntemler

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.
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.
CanReadToken(XmlReader)	Belirtilen XML okuyucusu tarafından başvuruda bulunılan XML öğesinin bu örnek tarafından işlenen türün belirteci olarak okunup okunamayacağını gösteren bir değer döndürür.
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.
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.
CreateToken(SecurityTokenDescriptor)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen belirteç tanımlayıcısını kullanarak bir güvenlik belirteci oluşturur. Bu yöntem bir güvenlik belirteci hizmeti (STS) tarafından çağrılır.
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.
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()	Türetilmiş bir sınıfta geçersiz kılındığında, türetilmiş sınıf tarafından işlenen türün belirtecini tanımlamak için isteklerde kullanılan URI kümesini döndürür.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
LoadCustomConfiguration(XmlNodeList)	Türetilmiş bir sınıfta geçersiz kılındığında XML'den özel yapılandırma yükler.
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.
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.
ReadToken(XmlReader, SecurityTokenResolver)	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, belirtilen belirteç çözümleyicisi kullanılarak türetilmiş sınıf tarafından işlenen türdeki bir belirtecin seri durumdan çıkarılır.
ReadToken(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 türün belirtecine seri durumdan çıkarılır.
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.
TraceTokenValidationSuccess(SecurityToken)	İzleme etkinleştirildiğinde güvenlik belirteçlerinin başarılı bir şekilde doğrulanması olayını izler.
ValidateToken(SecurityToken)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen güvenlik belirtecini doğrular. Belirteç, türetilmiş sınıf tarafından işlenen türden olmalıdır.
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.
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.
WriteToken(XmlWriter, SecurityToken)	Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen güvenlik belirtecini XML olarak serileştirir. Belirteç, türetilmiş sınıf tarafından işlenen türden olmalıdır.

Şunlara uygulanır

Aracılığıyla paylaş