javax.security.auth.login
클래스 LoginContext

java.lang.Object 
  |
  +--javax.security.auth.login.LoginContext

public class LoginContext

extends Object

LoginContext 클래스는 Subject 를 인증하기 위한 기본적인 메소드를 기술해, 기본이 되는 인증 테크놀러지에 의존하지 않는 어플리케이션 개발의 방법을 제공합니다. Configuration 는 어플리케이션으로 사용되는 인증 테크놀러지 (LoginModule)를 지정합니다. 그 때문에, 어플리케이션 자체로 변경을 더하는 일 없이, 어플리케이션에 다른 LoginModule 를 플러그 인 할 수가 있습니다.

이 클래스는 플러그 인 가능한 인증을 서포트할 뿐만 아니라, 스택 된 인증의 개념도 서포트합니다. 바꾸어 말하면(자), 어플리케이션에서는 LoginModule 를 1 개 이상 사용하도록(듯이) 구성할 수 있습니다. 예를 들어, 1 개의 어플리케이션으로 Kerberos LoginModule 와 스마트 카드 LoginModule 의 양쪽 모두를 구성할 수 있습니다.

통상의 호출측은 이 클래스를 초기화해 name 와 CallbackHandler 에 건네줍니다. LoginContext 에서는 name 를 Configuration 의 인덱스로서 사용해, 사용되고 있는 LoginModule 나, 인증 전체가 성공하기 위해서(때문에) 성공하지 않으면 안 되는 LoginModule 를 판정합니다. CallbackHandler 는 기본이 되는 LoginModule 에게 건네져 LoginModule 는 유저와의 주고받아 (그래피컬 유저 인터페이스로 유저명과 패스워드의 입력을 요구하는 등)를 실시합니다.

호출측이 LoginContext 를 초기화하면(자),login 메소드를 호출해 Subject 를 인증합니다. 이 login 메소드는 호출측이 지정한 name 용으로 구성된 각 LoginModule 로부터 login 메소드를 호출합니다. 그리고, 각 LoginModule 에서는 각각의 인증 타입을 실행합니다 (유저명과 패스워드, 스마트 카드 PIN 인증 등). 인증이 실패했을 경우에, LoginModule 에서는 인증을 재시행하거나 유예를 주거나 하지 않습니다. 이런 종류의 처리는 호출해 옆이 실시합니다.

인증 전체가 성공했는지 어떠했는지에 관계없이, 이 login 메소드에서는 구성된 각 LoginModule 에 대해서 commit 메소드나 abort 메소드를 호출하는 것으로, 2 국면의 인증 프로세스를 완료합니다. 인증 전체가 성공했을 경우는 각 LoginModule 에 대해서 commit 메소드가 불려 가 인증 전체가 실패했을 경우는 각 LoginModule 에 대해서 abort 메소드가 불려 갑니다. 성공한 각 LoginModule 의 commit 에서는 관련하는 Principal (인증된 식별 정보)와 Credential (암호화열쇠등의 인증 데이터)가,Subject 와 관련지을 수 있습니다. 각 LoginModule 의 abort 메소드는 먼저 저장된 인증 상태를 클린 업, 또는 삭제/파기합니다.

login 메소드가 예외를 슬로우 하는 일 없이 되돌아 왔을 경우는 인증 전체에 성공한 것이 됩니다. 그리고, 호출측은 getSubject 메소드를 호출하는 것으로, 새롭게 인증된 Subject 를 취득할 수 있습니다. Subject 와 관련지을 수 있었던 Principal 와 Credential 는 Subject 의 getPrincipals,getPublicCredentials, 및 getPrivateCredentials 의 각 메소드를 호출하는 것으로 취득할 수 있습니다.

Subject 를 로그아웃 시키려면 , 호출측에서 logout 메소드를 호출할 뿐입니다 봅니다. login 메소드와 같게 이 logout 메소드에서는 이 LoginContext 용으로 구성된 각 LoginModule 의 logout 메소드를 호출합니다. 각 LoginModule 의 logout 메소드는 상태를 클린 업 해,Subject 로부터 Principal 와 Credential 를 적절히 삭제 또는 파기합니다.

LoginContext 에 의해 불려 간 구성 끝난 각 LoginModule 에서는 인증을 받는 Subject, 유저와 통신하기 위한 CallbackHandler, 공유 LoginModule 상태, 및 LoginModule 고유의 옵션으로 초기화됩니다. LoginContext 가 Subject 에게 건네지지 않는 경우는 자기 자신을 인스턴스화합니다.

유저의 인증에 성공한 각 LoginModule 에서는 Subject 를 관련하는 유저 정보 (Principal 와 Credential)로 갱신합니다. 이 Subject 는 인증 전체가 성공했을 경우에,LoginContext 클래스의 getSubject 메소드에 의해 돌려주어집니다. LoginModule 는 AccessController.doPrivileged 호출의 내부로부터 항상 불려 갑니다. 그 때문에, 보안상 중요한 작업 (리모트 호스트에 접속하는 등)을 실행하는 LoginModule 로, 시큐러티 Policy 의 관련하는 Permission 의 부여가 필요해도, LoginModule 의 호출 측에, 이러한 Permission 는 필요 없습니다.

LoginContext 에서는 호출 어플리케이션에 의한 인증의 재시행을 서포트하고 있습니다. 예를 들어, 유저가 패스워드를 잘못해 입력했을 경우, LoginContext 의 login 메소드를 여러 차례 호출할 수가 있습니다. 다만, 1 개의 LoginContext 를 복수의 Subject 를 인증하기 위해서 사용할 수 없습니다. 다른 Subject 를 인증하려면 , 다른 LoginContext 를 사용하지 않으면 안됩니다.

같은 LoginContext 의 여러 차례 호출은 LoginModule 상태나 LoginModule 고유의 옵션에 영향을 주지 않습니다.

관련 항목:

Subject , CallbackHandler , Configuration , LoginModule

생성자의 개요

LoginContext (String name)
LoginContext 클래스의 constructor 입니다.

LoginContext (String name, CallbackHandler callbackHandler)
LoginContext 클래스의 constructor 입니다.

LoginContext (String name, Subject subject)
LoginContext 클래스의 constructor 입니다.

LoginContext (String name, Subject subject, CallbackHandler callbackHandler)
LoginContext 클래스의 constructor 입니다.

메소드의 개요

Subject	getSubject () 인증된 Subject 를 돌려줍니다.
void	login () 인증을 실행해, 성공했을 경우는 Principal 와 Credential 를 인증한 Subject 와 관련짓습니다.
void	logout () Subject 를 로그아웃 합니다.

클래스 java.lang. Object 에서 상속받은 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

생성자의 상세

LoginContext

public LoginContext(String  name)
             throws LoginException 

LoginContext 클래스의 constructor 입니다.

새로운 LoginContext 를 이름으로 초기화합니다. LoginContext 에서는 지정한 이름을 Configuration 의 인덱스로서 사용해, 사용되고 있는 LoginModule 를 판정합니다. 지정한 이름이 Configuration 내의 이름과 일치하지 않는 경우는 디폴트의 Configuration 엔트리인 other 를 사용합니다. other 의 Configuration 엔트리가 없는 경우는 LoginException 가 슬로우 됩니다.

이 constructor 에서는 CallbackHandler 를 받아들이지 않습니다. auth.login.defaultCallbackHandler 시큐러티 프로퍼티가 디폴트의 CallbackHandler 구현 클래스의 완전 수식명으로 설정되어 있는 경우, 그 CallbackHandler 가 로드 되어 기본이 되는 LoginModule 에게 건네집니다. 시큐러티 프로퍼티가 설정되어 있지 않은 경우, 기본이 되는 LoginModule 는 유저와 통신하기 위해서 사용하는 CallbackHandler 를 가지지 않게 됩니다. 그 때문에, 호출측에서는 구성 끝난 LoginModule 에, 유저를 인증하는 대체 방법이 있다고 봅니다.

auth.login.defaultCallbackHandler 시큐러티 프로퍼티는 <JAVA_HOME>/lib/security/java.security 라고 하는 파일에 있는 Java 시큐러티 프로퍼티 파일로 설정합니다. <JAVA_HOME> 는 SDK 가 인스톨 된 디렉토리입니다.

이 constructor 에서는 Subject 를 지정할 수 없기 때문에,Subject 는 Subject 자체를 인스턴스화합니다.

파라미터:

name - Configuration 의 인덱스로서 사용되는 이름

예외:

LoginException - 지정한 name 가 Configuration 에 없고, other 라고 하는 Configuration 엔트리가 없는 경우, 혹은 auth.login.defaultCallbackHandler 시큐러티 프로퍼티가 설정되어 있는 것에도 불구하고, 구현 클래스를 로드할 수 없었던 경우

LoginContext

public LoginContext(String  name,
                    Subject  subject)
             throws LoginException 

LoginContext 클래스의 constructor 입니다.

새로운 LoginContext 오브젝트를 이름과 Subject 오브젝트로 초기화합니다.

LoginContext 에서는 이름을 Configuration 의 인덱스로서 사용해, 사용되고 있는 LoginModule 를 판정합니다. 지정한 이름이 Configuration 내의 이름과 일치하지 않는 경우는 디폴트의 Configuration 엔트리인 other 를 사용합니다. other 의 Configuration 엔트리가 없는 경우는 LoginException 가 슬로우 됩니다.

이 constructor 에서는 CallbackHandler 를 받아들이지 않습니다. auth.login.defaultCallbackHandler 시큐러티 프로퍼티가 디폴트의 CallbackHandler 구현 클래스의 완전 수식명으로 설정되어 있는 경우, 그 CallbackHandler 가 로드 되어 기본이 되는 LoginModule 에게 건네집니다. 시큐러티 프로퍼티가 설정되어 있지 않은 경우, 기본이 되는 LoginModule 는 유저와 통신하기 위해서 사용하는 CallbackHandler 를 가지지 않게 됩니다. 그 때문에, 호출측에서는 구성 끝난 LoginModule 에, 유저를 인증하는 대체 방법이 있다고 봅니다.

auth.login.defaultCallbackHandler 시큐러티 프로퍼티는 <JAVA_HOME>/lib/security/java.security 라고 하는 파일에 있는 Java 시큐러티 프로퍼티 파일로 설정합니다. <JAVA_HOME> 는 SDK 가 인스톨 되고 있는 디렉토리입니다.

LoginContext 는 Subject 오브젝트를 구성 끝난 LoginModule 에 건네줍니다. 이것에 의해, LoginModule 는 인증을 추가 실행하거나 새로운 Principal 와 Credential 로 Subject 를 갱신할 수가 있습니다.

파라미터:

name - Configuration 의 인덱스로서 사용되는 이름

subject - 인증 대상의 Object

예외:

LoginException - 지정한 name 가 Configuration 에 없고, other 라고 하는 Configuration 엔트리가 없는 경우, 지정한 subject 가 null 의 경우, 혹은 auth.login.defaultCallbackHandler 시큐러티 프로퍼티가 설정되어 있는 것에도 불구하고, 구현 클래스를 로드할 수 없었던 경우

LoginContext

public LoginContext(String  name,
                    CallbackHandler  callbackHandler)
             throws LoginException 

LoginContext 클래스의 constructor 입니다.

새로운 LoginContext 오브젝트를 이름과 CallbackHandler 오브젝트로 초기화합니다.

LoginContext 에서는 이름을 Configuration 의 인덱스로서 사용해, 사용되고 있는 LoginModule 를 판정합니다. 지정한 이름이 Configuration 내의 이름과 일치하지 않는 경우는 디폴트의 Configuration 엔트리인 other 를 사용합니다. other 의 Configuration 엔트리가 없는 경우는 LoginException 가 슬로우 됩니다.

LoginContext 는 CallbackHandler 오브젝트를 구성 끝난 LoginModule 에 건네주기 (위해)때문에, LoginModule 는 유저와 교환할 수 있습니다. 그 때문에,CallbackHandler 오브젝트에서는 LoginModule 를, 어플리케이션이 유저와 교환하는 방법과는 무관계한 그대로로 할 수 있습니다. 이 LoginContext 는 어플리케이션이 제공하는 CallbackHandler 를 새로운 CallbackHandler 구현으로 랩 할 수 있습니다. 이 새로운 CallbackHandler 구현의 handle 메소드 구현에서는 어플리케이션이 제공하는 CallbackHandler 의 handle 메소드의 호출을, 호출측의 현재의 AccessControlContext 에 제약을 받고 있는 java.security.AccessController.doPrivileged 호출내에서 실행합니다.

이 constructor 에서는 Subject 를 지정할 수 없기 때문에,Subject 는 Subject 자체를 인스턴스화합니다.

파라미터:

name - Configuration 의 인덱스로서 사용되는 이름

callbackHandler - LoginModule 가 유저와 교환하기 위해서(때문에) 사용하는 CallbackHandler 오브젝트

예외:

LoginException - 지정한 name 가 Configuration 에 없고, other 라고 하는 Configuration 엔트리가 없는 경우, 혹은 지정한 callbackHandler 가 null 의 경우

LoginContext

public LoginContext(String  name,
                    Subject  subject,
                    CallbackHandler  callbackHandler)
             throws LoginException 

LoginContext 클래스의 constructor 입니다.

새로운 LoginContext 오브젝트를 이름, 인증을 받는 Subject 오브젝트, 및 CallbackHandler 오브젝트로 초기화합니다.

LoginContext 에서는 이름을 Configuration 의 인덱스로서 사용해, 사용되고 있는 LoginModule 를 판정합니다. 지정한 이름이 Configuration 내의 이름과 일치하지 않는 경우는 디폴트의 Configuration 엔트리인 other 를 사용합니다. other 의 Configuration 엔트리가 없는 경우는 LoginException 가 슬로우 됩니다.

LoginContext 는 Subject 오브젝트를 구성 끝난 LoginModule 에 건네줍니다. 이것에 의해, LoginModule 는 인증을 추가 실행하거나 새로운 Principal 와 Credential 로 Subject 를 갱신할 수가 있습니다.

LoginContext 는 CallbackHandler 오브젝트를 구성 끝난 LoginModule 에 건네주기 (위해)때문에, LoginModule 는 유저와 교환할 수 있습니다. 그 때문에,CallbackHandler 오브젝트에서는 LoginModule 를, 어플리케이션이 유저와 교환하는 방법과는 무관계한 그대로로 할 수 있습니다. 이 LoginContext 는 어플리케이션이 제공하는 CallbackHandler 를 새로운 CallbackHandler 구현으로 랩 할 수 있습니다. 이 새로운 CallbackHandler 구현의 handle 메소드 구현에서는 어플리케이션이 제공하는 CallbackHandler 의 handle 메소드의 호출을, 호출측의 현재의 AccessControlContext 에 제약을 받고 있는 java.security.AccessController.doPrivileged 호출내에서 실행합니다.

파라미터:

name - Configuration 의 인덱스로서 사용되는 이름

subject - 인증 대상의 Object

callbackHandler - LoginModule 가 유저와 교환하기 위해서(때문에) 사용하는 CallbackHandler 오브젝트

예외:

LoginException - 지정한 name 가 Configuration 에 없고, other 라고 하는 Configuration 엔트리가 없는 경우, 지정한 subject 가 null 의 경우, 혹은 지정한 callbackHandler 가 null 의 경우

메소드의 상세

login

public void login()
           throws LoginException 

인증을 실행해, 성공했을 경우는 Principal 와 Credential 를 인증한 Subject 와 관련짓습니다.

이 메소드에서는 로그인 Configuration 로 정의된,LoginContext constructor로 건네진 name 용으로 구성된 각 LoginModule 의 login 메소드를 호출합니다. 그리고, 각 LoginModule 에서는 각각의 인증 타입을 실행합니다 (유저명과 패스워드, 스마트 카드 PIN 인증 등).

이 메소드에서는 LoginContext 의 인증 전체가 성공했을 경우 (관련하는 REQUIRED, REQUISITE, SUFFICIENT, OPTIONAL 의 각 LoginModule 이 성공)에 구성 끝난 LoginModule 에 대해서 commit 메소드를 호출하는지 인증 전체가 실패했을 경우에 구성 끝난 각 LoginModule 에 대해서 abort 메소드를 호출하는 것으로, 2 국면의 인증 프로세스가 완료합니다. 인증에 성공했을 경우는 성공한 각 LoginModule 의 commit 메소드에 의해, 관련하는 Principal 와 Credential 가,Subject 와 관련지을 수 있습니다. 인증에 실패했을 경우는 각 LoginModule 의 abort 메소드에 의해, 원래 보존되고 있던 상태를 삭제 또는 파기합니다.

인증 프로세스의 commit 국면에 실패하면(자) 인증 전체가 실패해, 이 메소드는 구성 끝난 각 LoginModule 에 대해서 abort 메소드를 호출합니다.

어떠한 이유로써 abort 국면이 실패해도,login 국면중이나 commit 국면중에 슬로우 된 원의 예외를 전달합니다. 어느 쪽의 경우도, 인증 전체가 실패합니다.

복수의 LoginModule 으로 실패했을 경우, 최초로 실패한 LoginModule 로 발생한 예외를 전달합니다.

이 메소드가 abort 국면에 들어갔을 (login 국면이나 commit 국면에 실패할) 경우는 지정한 어플리케이션용으로 구성된 모든 LoginModule 를, 각각의 Configuration 플래그 파라미터에 관계없이, 호출합니다. 원칙으로서abort 국면중은 Requisite 와 Sufficient 가 가지는 의미는 무시됩니다. 이것에 의해, 적절한 클린 업과 상태의 복원을 실시하는 것이 프로텍션됩니다.

예외:

LoginException - 인증에 실패했을 경우

logout

public void logout()
            throws LoginException 

Subject 를 로그아웃 합니다.

이 메소드는 이 LoginContext 용으로 구성된 각 LoginModule 의 logout 메소드를 호출합니다. 각 LoginModule 는 각각의 로그아웃 처리를 실시합니다. 로그아웃 처리에는 Subject 로부터의 Principal 나 Credential 의 삭제/파기나, 상태의 클린 업등이 포함됩니다.

이 메소드에서는 지정한 어플리케이션용으로 구성된 모든 LoginModule 를, 각각의 Configuration 플래그 파라미터에 관계없이 호출합니다. 원칙으로서 이 메소드에서는 Requisite 와 Sufficient 가 가지는 의미는 무시됩니다. 이것에 의해, 적절한 클린 업과 상태의 복원을 실시하는 것이 프로텍션됩니다.

예외:

LoginException - 로그아웃에 실패했을 경우

getSubject

public Subject  getSubject()

인증된 Subject 를 돌려줍니다.

반환값:

인증된 Subject. 인증에 실패해, Subject 가 이 LoginContext 의 constructor로 건네지지 않는 경우, 이 메소드는 null 를 돌려준다. 그렇지 않은 경우는 건네받은 Subject 를 돌려준다