SecurityTokenHandler Sınıf

Tanım

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
SecurityTokenHandler
Türetilmiş
Uygulamalar

Örnekler

Tüm konulardaki SecurityTokenHandler kod örnekleri örnekten Custom Token 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 nesneye 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.

  • Öğelere ve öğelerden 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 <wsse:SecurityTokenReference> çıkarma.

  • Sınıfın uygulamaları tarafından geçirilen bir SecurityTokenDescriptor nesneden güvenlik belirteçleri SecurityTokenService oluşturma.

  • Sınıfın uygulamaları için bir güvenlik belirtecinden anahtar tanımlayıcı yan tümceleri SecurityTokenService oluşturma.

Windows Identity Foundation (WIF), aşağıdaki güvenlik belirteci işleyicilerini kullanıma hazır olarak döndürü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 sınıftan değil, bu sınıflardan SecurityTokenHandler birinden türetmek daha iyi olabilir.

Bir güvenlik belirteci işleyicisi, yapılandırma dosyasındaki securityTokenHandlers> öğesinin altındaki< öğeleriekleme>, kaldırma veya temizleme belirterek belirteç işleyici koleksiyonundan eklenebilir veya kaldırılabilir.<<><> SecurityTokenHandlerConfiguration İşleyici koleksiyonunun yapılandırma ayarlarını içeren nesneye 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 yöntemini geçersiz kılabilirsiniz LoadCustomConfiguration .

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

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

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şlevi uygulayan yöntemlerle eşleştirmektedir:

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

Yöntemi DetectReplayedToken , 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ı belirten değerini döndürür false. yöntemini geçersiz kılabilir ve yeniden oynatılan belirteçleri algılamak için mantık sağlayabilirsiniz.

Oluşturucular

SecurityTokenHandler()

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

Özellikler

CanValidateToken

İşleyicinin güvenlik belirteçlerini doğrulamayı destekleyip desteklemediğini belirten bir değer alır.

CanWriteToken

İşleyicinin güvenlik belirteçlerini seri hale getirip getiremeyeceğini belirten bir değer alır.

Configuration

Geçerli örnek için yapılandırma sağlayan nesneyi alır veya ayarlar SecurityTokenHandlerConfiguration .

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 seri durumdan çıkarılamayacağını belirten 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ı belirten 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 belirten 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()

Type Geçerli örneğini 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 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.

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.

ReadToken(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 türün belirtecine seri durumdan çıkartır.

ReadToken(XmlReader, SecurityTokenResolver)

Türetilmiş bir sınıfta geçersiz kılındığında, belirtilen XML okuyucusu tarafından başvuruda bulunan XML'yi, belirtilen belirteç çözümleyicisi kullanılarak türetilmiş sınıf tarafından işlenen türdeki bir belirtece seri durumdan çıkartır.

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.

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üretilen 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'ye serileştirir. Anahtar tanımlayıcı yan tümcesi türetilen 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üretilen 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üretilen sınıf tarafından işlenen türden olmalıdır.

Şunlara uygulanır

Ayrıca bkz.