SecurityTokenHandler 클래스

정의

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

상속

Object

SecurityTokenHandler

파생

System.IdentityModel.Tokens.EncryptedSecurityTokenHandler

System.IdentityModel.Tokens.KerberosSecurityTokenHandler

System.IdentityModel.Tokens.RsaSecurityTokenHandler

System.IdentityModel.Tokens.Saml2SecurityTokenHandler

System.IdentityModel.Tokens.SamlSecurityTokenHandler

자세히…

구현

ICustomIdentityConfiguration

예제

모든 코드 예제는 SecurityTokenHandler 에서 항목을 가져옵니다는 Custom Token 샘플입니다. 이 샘플의 간단한 웹 토큰 (SWT) 처리를 사용 하도록 설정 하는 사용자 지정 클래스를 제공 합니다. 이 샘플 및 WIF 및 다운로드할 위치에 사용할 수 있는 다른 샘플에 대 한 정보를 참조 하세요 WIF 코드 샘플 인덱스합니다. 다음 XML에는 SWT 토큰 처리기가 토큰 처리기 컬렉션에 추가 하는 방법을 보여 줍니다.

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

설명

SecurityTokenHandler 클래스는 모든 보안 토큰 처리기 파생 되는 기본 클래스입니다. 보안 토큰 처리기는 담당 합니다.

• 보안 토큰 유효성 검사 (SecurityToken) 프로세스와 패키징으로 토큰에 클레임을 포함 하도록 설계 되었습니다 형식의 ClaimsIdentity 개체입니다.

• 직렬화 및 역직렬화 형식의 보안 토큰을 처리 하도록 설계 되었습니다.

• 직렬화 및 역직렬화 키 식별자 절 (SecurityKeyIdentifierClause)을 처리 하도록 설계 되었습니다 형식의 토큰을 참조 하는 <wsse:SecurityTokenReference> 요소입니다.

• 보안 토큰을 만들기는 SecurityTokenDescriptor 의 구현을 통해 전달 되는 개체는 SecurityTokenService 클래스.

• 구현에 대 한 보안 토큰에서 키 식별자 절을 만드는 SecurityTokenService 클래스입니다.

Windows Identity Foundation (WIF)는 기본적으로 다음 보안 토큰 처리기를 제공합니다.

• EncryptedSecurityTokenHandler

• KerberosSecurityTokenHandler

• MachineKeySessionSecurityTokenHandler

• MembershipUserNameSecurityTokenHandler

• RsaSecurityTokenHandler

• Saml2SecurityTokenHandler

• SamlSecurityTokenHandler

• SessionSecurityTokenHandler

• UserNameSecurityTokenHandler

• WindowsUserNameSecurityTokenHandler

• X509SecurityTokenHandler

이러한 클래스의 대부분 클래스는 토큰을 처리 하는 관련 된 기능을 구현 하는 추가 멤버를 노출 합니다. 대부분의 경우에서에서 직접 읽지 못하고 이러한 클래스 중 하나에서 파생 되는 것이 더 수는 SecurityTokenHandler 클래스입니다.

구성 파일의 securityTokenHandlers> 요소 아래에<추가>, 제거 또는 지우기 요소를 지정하여< 토큰 처리기 컬렉션에서 보안 토큰 처리기를 추가하거나 <제거할 수 있습니다.>>< SecurityTokenHandlerConfiguration 처리기 컬렉션에 대 한 구성 설정이 포함 된 개체를 통해 액세스할 수는 Configuration 속성 및 토큰 처리기의 구성원 인 처리기 컬렉션에서 액세스할 수 있습니다는 ContainingCollection 속성입니다. 재정의할 수 있습니다는 LoadCustomConfiguration 처리기는 모든 사용자 지정 구성 요소를 처리 하는 방법입니다.

SecurityTokenHandler 클래스는 다른 여러 속성 및 메서드를 노출 합니다. 구현 하도록 선택 하는 기능에 따라 이러한 멤버 중 일부나 전부를 재정의할 수 있습니다.

재정의 해야 합니다 TokenType 속성 및 GetTokenTypeIdentifiers 클래스는 보안 토큰의 형식에 대 한 정보를 사용 하 여 WIF 인프라를 제공 하는 메서드를 처리 하도록 설계 합니다.

유효성 검사, serialization 및 deserialization 기능 속성 또는 처리기 메서드 또는 기능을 구현 하는 메서드를 사용 하 여 결합 된 특정 기능을 수행할 수 있는지 여부를 나타내는 메서드를 통해 노출 됩니다. 다음 목록에는 해당 기능을 구현 하는 메서드를 사용 하 여 기능을 나타내는 메서드나 속성 쌍:

• CanValidateToken 속성 및 ValidateToken 메서드: 토큰의 유효성을 검사하고 토큰에 포함된 클레임을 ClaimsIdentity로 패키지합니다.

• 합니다 CanWriteToken 속성 및 WriteToken 메서드: serialization 토큰입니다.

• 합니다 CanReadToken 메서드 및 ReadToken 메서드: deserialization 토큰입니다.

• 합니다 CanReadKeyIdentifierClause 메서드 및 ReadKeyIdentifierClause 메서드: 키 식별자 절을 역직렬화 합니다.

• 합니다 CanWriteKeyIdentifierClause 메서드 및 WriteKeyIdentifierClause 메서드: 키 식별자 절을 직렬화 합니다.

CreateToken 하며 CreateSecurityTokenReference 메서드는 구현 파이프라인에서 호출 됩니다는 SecurityTokenService 클래스입니다.

DetectReplayedToken 지정한 토큰이 이미 수신 여부를 결정 하는 WIF 인프라에서 호출 됩니다. 기본적으로이 메서드는 다음과 같이 반환 됩니다. false를 나타내는 토큰을 이미 수신 되지 않았습니다. 메서드를 재정의 하 고 재생 된 토큰을 검색 하는 논리를 제공할 수 있습니다.

생성자

속성

메서드

적용 대상

추가 정보

• SecurityToken
• SecurityKeyIdentifier
• SecurityTokenService