SessionSecurityTokenHandler 클래스

정의

public ref class SessionSecurityTokenHandler : System::IdentityModel::Tokens::SecurityTokenHandler

public class SessionSecurityTokenHandler : System.IdentityModel.Tokens.SecurityTokenHandler

type SessionSecurityTokenHandler = class
    inherit SecurityTokenHandler

Public Class SessionSecurityTokenHandler
Inherits SecurityTokenHandler

상속

Object

SecurityTokenHandler

SessionSecurityTokenHandler

파생

System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler

예제

다음 XML의 인스턴스를 사용 하 여 토큰 처리기 컬렉션의 기본 세션 보안 토큰 처리기를 교체 하는 방법을 보여 줍니다는 MachineKeySessionSecurityTokenHandler 구성에서 클래스입니다.

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

설명

SessionSecurityTokenHandler 클래스 직렬화, 역직렬화하 고 세션 토큰의 유효성을 검사 합니다. 세션 토큰은 토큰 형식의 SessionSecurityToken합니다. SessionSecurityTokenHandler 클래스가 쿠키 형식 토큰을 serialize 합니다. 기본적으로 클래스 Ws-secure Conversation Feb2005 또는 Ws-secure Conversation 1.3에 토큰을 serialize <wsc:SecurityContextToken> 요소입니다. 세션 토큰에서 사용 되는 WSFederationAuthenticationModule (WSFAM) 및 SessionAuthenticationModule (SAM) 세션에 대 한 정보를 저장 하이 주로 ClaimsPrincipal 인증된 된 사용자 및 세션 시작 및 만료 시간을 사용 하 여 연결 합니다.

수동 시나리오에서 합니다 WSFederationAuthenticationModule 를 호출 합니다 SessionAuthenticationModule (SAM)에서 세션 토큰을 만드는 인증 파이프라인에서는 ClaimsPrincipal 인증된 된 사용자를 나타내는입니다. SAM를 사용 하 여 해당 구성 SessionSecurityTokenHandler 토큰을 만드는 쿠키로 직렬화 (고 이후 요청에서 쿠키에서 토큰을 역직렬화할). 해당 구성의 인스턴스를 사용 하 여 SAM CookieHandler HTTP 응답에 쿠키를 다시 작성 하는 클래스입니다. 이 쿠키는 클라이언트에 반환 됩니다 하 고 이후 요청에서 클라이언트 id 공급자를 다시 보안 토큰을 가져오는으로 왕복 하는 것이 아니라 쿠키를 제공할 수 있습니다. WIF를 사용 하 여 세션을 작동 하는 방법에 대 한 자세한 내용은 참조 하세요. WIF 세션 관리합니다.

세션 토큰 모드에 있으면 참조, 즉, 해당 SessionSecurityToken.IsReferenceMode 속성은 true, 세션 토큰 처리기만의 해당 키를 다시 생성 하는 데 필요한 세션 토큰의 속성을 serialize 된 SessionSecurityTokenCache합니다. 기본값은 SessionSecurityTokenCacheKey 클래스는 캐시 키를 나타내는 데 쓰고 토큰 처리기는 SessionSecurityToken.ContextId 및 SessionSecurityToken.KeyGeneration 토큰의 속성입니다. 경우 세션 토큰은 참조 모드에 있지 않은 것입니다는 SessionSecurityToken.IsReferenceMode 속성은 false, 그런 다음 이전에 언급 된 속성 외에도 처리기를 호출 하는 ApplyTransforms 저장소와 토큰에서 serialize 된 바이트 배열에 대 한 메서드는 도 쿠키의 결과 값입니다. 토큰이 serialize 되는 방법을 하는 방법에 대 한 자세한 내용은 참조는 SessionSecurityTokenHandler.WriteToken(XmlWriter, SecurityToken) 메서드.

합니다 Transforms 속성에서 토큰을 세션에 적용 되는 변환의 목록을 가져옵니다는 ApplyTransforms 메서드. 파생 되는 모든 변환 된 CookieTransform 클래스입니다. 기본값은 DeflateCookieTransform 하며 ProtectedDataCookieTransform 적용 됩니다. ProtectedDataCookieTransform 쿠키 자료를 보호 하기 위해 데이터 보호 API (DPAPI)를 사용 합니다. DPAPI는 해당 보호 알고리즘에서 실행 되는 컴퓨터에 관련 된 키를 사용 합니다. 이 따라서 이러한 시나리오에서는 한 컴퓨터에서 작성 하는 토큰을 다른 컴퓨터에서 읽을 수 해야 때문에 기본 세션 토큰 처리기를 웹 팜 시나리오에서 사용 가능 하지 않습니다. 이 문제를 뚫을 수 있는 다양 한 전략을 사용할 수 있습니다. 예를 들어, 다음을 수행할 수 있습니다.

• 기본 바꿉니다 SessionSecurityTokenHandler 사용 하 여는 MachineKeySessionSecurityTokenHandler합니다. 합니다 MachineKeySessionSecurityTokenHandler ASP.NET에서 서명 및 암호화 키를 지정할 수 있습니다 <machineKey> 구성 파일의 요소입니다.

• 에 대 한 처리기를 제공 합니다 FederatedAuthentication.FederationConfigurationCreated global.asax.cs 파일 바꾸기 기본 세션에서 이벤트 처리기의 인스턴스를 사용 하 여 토큰 SessionSecurityTokenHandler 포함 하는 변환 목록을 포함 합니다 RsaSignatureCookieTransform 및 RsaEncryptionCookieTransform합니다. 변환 목록을 사용 하는 생성자 중 하나를 호출 하 여 새 인스턴스를 만들 수 있습니다.

• 사용자 지정 변환에서 파생 된 CookieTransform 기본 클래스를 사용 하 여 위의 메서드 적용할 변환 목록에 포함 합니다.

• 사용자 지정 토큰 처리기를 파생 SessionSecurityTokenHandler 메커니즘을 구현 하 고 있습니다.

세션을 사용 하 여 웹 팜 시나리오에 대 한 자세한 내용은 참조 하세요. WIF 및 웹 팜합니다.

는 SessionSecurityTokenHandler 기본 토큰 처리기 컬렉션에 포함되지만, 먼저 securityTokenHandlers> 요소 아래에<remove> 요소를 지정하여< 컬렉션에서 기본 처리기를 제거한 다음 add> 요소를 사용하여< 사용자 지정 토큰 처리기를 추가하여 사용자 지정 세션 토큰 처리기로 바꿀 수 있습니다. 기본적으로 요소 아래에 <add>sessionTokenRequirement> 요소를 포함하여< 기본 토큰 수명을 지정할 수 있습니다. 사용자 지정 구성 요소에서 수행할 사용자 지정 토큰 처리기를 디자인할 수 있습니다는 <add> 재정의 하 여 요소를 LoadCustomConfiguration 논리 처리를 제공 하는 방법입니다.

생성자

필드

속성

메서드

적용 대상

추가 정보

• SessionSecurityTokenCache
• SessionSecurityToken
• MachineKeySessionSecurityTokenHandler
• CookieTransform
• <sessionTokenRequirement>
• WIF 및 웹 팜
• WIF 세션 관리