SecurityTokenHandler Sınıf

Tanım

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 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:

• EncryptedSecurityTokenHandler

• KerberosSecurityTokenHandler

• MachineKeySessionSecurityTokenHandler

• MembershipUserNameSecurityTokenHandler

• RsaSecurityTokenHandler

• Saml2SecurityTokenHandler

• SamlSecurityTokenHandler

• SessionSecurityTokenHandler

• UserNameSecurityTokenHandler

• WindowsUserNameSecurityTokenHandler

• X509SecurityTokenHandler

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:

• CanValidateToken özelliği ve ValidateToken yöntemi: Belirteci doğrular ve belirtecin içerdiği talepleri içine ClaimsIdentitypaketler.

• CanWriteToken özelliği ve WriteToken yöntemleri: Belirteç serileştirme.

• CanReadToken Yöntemler ve ReadToken yöntemler: 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, 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

Özellikler

Yöntemler

Şunlara uygulanır

Ayrıca bkz.

• SecurityToken
• SecurityKeyIdentifier
• SecurityTokenService