javax.security.auth.login
클래스 Configuration

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

public abstract class Configuration

extends Object

이것은 어플리케이션에 있어서의 LoginModule 의 구성을 나타내는 abstract 클래스입니다. Configuration 에서는 특정의 어플리케이션으로 사용되는 LoginModule 과 LoginModule 가 불려 가는 차례를 지정합니다. 이 abstract 클래스에서는 실제의 Configuration 를 읽어내거나 로드하거나 하는 구현을 제공하도록(듯이) 서브 클래스화할 필요가 있습니다.

특정의 어플리케이션 appName 용으로 구성된 LoginModule 를 판정하기 위해서 Configuration 를 읽어내는 필요성이 있을 때, 다음의 호출을 합니다.

	config = Configuration.getConfiguration();
	entries = config.getAppConfigurationEntry(appName);
 

로그인 구성에는 이하에 나타내는 정보가 저장됩니다. 이 예에서는 Configuration 의 디폴트 구문만을 나타내고 있습니다. 이 클래스의 서브 클래스 구현에서는 다른 구문을 구현할 수 있어 파일, 데이타베이스, 서버라고 하는 임의의 소스로부터 Configuration 를 취득할 수 있습니다.

      Application {
	      ModuleClass  Flag    ModuleOptions;
	      ModuleClass  Flag    ModuleOptions;
	      ModuleClass  Flag    ModuleOptions;
      };
      Application {
	      ModuleClass  Flag    ModuleOptions;
	      ModuleClass  Flag    ModuleOptions;
      };
      other {
	      ModuleClass  Flag    ModuleOptions;
	      ModuleClass  Flag    ModuleOptions;
      };
 

Configuration 의 각 엔트리는 어플리케이션명 Application 로 인덱스화 되고 있어 그 어플리케이션용으로 구성된 LoginModules 의 리스트가 포함되어 있습니다. 각 LoginModule 는 그 완전 수식 클래스명으로 지정되고 있습니다. 인증은 모듈 리스트로 지정한 차례 대로에 처리됩니다. 어플리케이션의 고유 엔트리가 없는 경우,other 의 고유 엔트리가 디폴트가 됩니다.

Flag 의 값은 스택을 인증할 때의 전체적인 동작을 제어합니다. Flag 에 유효한 값과 각각의 의미를 다음에 나타냅니다.

      1) Required     - LoginModule 의 처리는 성공하지 않으면 안 된다.
			성공해도 실패해도,LoginModule 리스트에
			따라서 처리는 계속된다
      2) Requisite    - LoginModule 의 처리는 성공하지 않으면 안 된다.
			성공했을 경우는 LoginModule 리스트에 따라
			인증은 계속한다.
			실패했을 경우는  곧바로 제어가 어플리케이션에
			되돌려진다 (LoginModule 리스트에 따라
			인증을 하지 않는다)
      3) Sufficient   - LoginModule 의 처리는 성공하지 않아도 좋다.
			성공했을 경우는  곧바로 제어가 어플리케이션에
			되돌려진다 (LoginModule 리스트에 따라
			인증을 하지 않는다).
			실패했을 경우는 LoginModule 리스트에
			따라서 인증은 계속한다
      4) Optional     - LoginModule 의 처리는 성공하지 않아도
			좋다. 성공해도 실패해도,
			LoginModule 리스트에 따라
			인증은 계속된다

모든 Required LoginModule 와 Requisite LoginModule 가 성공했을 경우에만, 인증 전체가 성공합니다. Sufficient LoginModule 가 구성되고 성공했을 경우는 그 Sufficient LoginModule 에 앞서 Required LoginModule 와 Requisite LoginModule 가 성공하지 않으면 인증 전체가 성공한 것으로는 되지 않습니다. 어플리케이션으로 Required LoginModule 도 Requisite LoginModule 도 구성되어 있지 않은 경우는 Sufficient LoginModule 나 Optional LoginModule 가 적어도 1 kr 성공하지 않으면 안됩니다.

ModuleOptions 는 기본이 되는 LoginModule 에 직접 건네받는 LoginModule 고유의 값을 공백 캐릭터로 단락지은 리스트입니다. 옵션은 LoginModule 자체로 정의되고 있어 내부에서 동작을 제어합니다. 예를 들어,LoginModule 로 디버그와 테스트를 서포트하는 옵션이 정의되고 있다고 합니다. Configuration 로 옵션을 지정하려면 , debug="true" 와 열쇠와 값의 페어를 사용하는 것이 올바른 방법입니다. 열쇠와 값은 등호 기호 (=)로 단락지어, 값은 이중 인용부호로 둘러쌀 필요가 있습니다. 값에 ${system.property} 라고 하는 형식의 String 를 지정했을 경우는 시스템 프로퍼티의 값에 전개됩니다. LoginModule 로 정의할 수 있는 옵션의 수에 상한은 없습니다.

전술의 구문에 근거하는 Configuration 엔트리의 예를 다음에 나타냅니다.

 Login {
   com.sun.security.auth.module.UnixLoginModule required;
   com.sun.security.auth.module.Krb5LoginModule optional
                   useTicketCache="true"
                   ticketCache="${user.home}${/}tickets";
 };
 

이 Configuration 에서는 Login 라고 하는 어플리케이션으로, 유저는 최초로 com.sun.security.auth.module.UnixLoginModule 로 인증되어 인증에 성공할 필요가 있습니다. UnixLoginModule 인증에 실패해도, com.sun.security.auth.module.Krb5LoginModule 는 불려 갑니다. 이것에 의해, 실패한 소스를 숨길 수가 있습니다. Krb5LoginModule 는 Optional 이기 (위해)때문에, UnixLoginModule (Required)가 성공했을 경우만, 인증 전체가 성공합니다.

LoginModule 고유의 옵션인 useTicketCache="true" 나 ticketCache=${user.home}${/}tickets" 는 Krb5LoginModule 에게 건네집니다. 이러한 옵션에 의해, Krb5LoginModule 에서는 지정한 장소에 있는 티켓 캐쉬를 사용하게 됩니다. 시스템 프로퍼티의 user.home 와 / (file.separator)는 각각의 값에 전개됩니다.

디폴트의 Configuration 구현은 (Java 시큐러티 프로퍼티 파일의) login.configuration.provider 시큐러티 프로퍼티에, 희망하는 Configuration 구현 클래스의 완전 지정명을 설정하는 것에 의해 변경할 수 있습니다. Java 시큐러티 프로퍼티 파일은 <JAVA_HOME>/lib/security/java.security 라는 이름의 파일에 저장됩니다. 다만, <JAVA_HOME> 는 JDK 가 인스톨 된 디렉토리를 나타냅니다.

관련 항목:

LoginContext

생성자의 개요

protected

Configuration () 유일한 constructor 입니다.

메소드의 개요

abstract AppConfigurationEntry []	getAppConfigurationEntry (String applicationName) 이 어플리케이션의 LoginModule 의 구성에 대응하는 AppConfigurationEntry 의 배열을 취득합니다.
static Configuration	getConfiguration () 현재의 Login Configuration 를 취득합니다.
abstract void	refresh () Configuration 를 리프레쉬 해, 재로드합니다.
static void	setConfiguration (Configuration configuration) 현재의 Login Configuration 를 설정합니다.

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

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

생성자의 상세

Configuration

protected Configuration()

유일한 constructor 입니다. 서브 클래스의 constructor 에 의한 호출은 통상은 암묵적인 호출입니다.

메소드의 상세

getConfiguration

public static Configuration  getConfiguration()

현재의 Login Configuration 를 취득합니다.

반환값:

현재의 Login Configuration

예외:

SecurityException - 호출 측에, Configuration 를 취득하는 액세스권이 없는 경우

관련 항목:

setConfiguration(javax.security.auth.login.Configuration)

setConfiguration

public static void setConfiguration(Configuration  configuration)

현재의 Login Configuration 를 설정합니다.

파라미터:

configuration - 새로운 Configuration

예외:

SecurityException - 현재의 thread가 Configuration 를 설정하는 Permission 를 가지지 않는 경우

관련 항목:

getConfiguration()

getAppConfigurationEntry

public abstract AppConfigurationEntry [] getAppConfigurationEntry(String  applicationName)

이 어플리케이션의 LoginModule 의 구성에 대응하는 AppConfigurationEntry 의 배열을 취득합니다.

파라미터:

applicationName - Configuration 를 인덱스화하기 위한 이름

반환값:

이 어플리케이션의 LoginModule 의 구성에 대응하는 AppConfigurationEntry 의 배열. 이 어플리케이션에 구성된 LoginModule 가 없는 경우는 null

refresh

public abstract void refresh()

Configuration 를 리프레쉬 해, 재로드합니다.

이 메소드는 이 오브젝트가, 현재의 Configuration 를 리프레쉬나 재로드하는 원인이 됩니다. 이것은 구현에 의존합니다. 예를 들어 Configuration 오브젝트가 파일에 저장되고 있는 경우,refresh 를 호출하면(자), 파일이 한번 더 읽어내지게 됩니다.

예외:

SecurityException - 호출 측에, Configuration 를 리프레쉬 하는 액세스권이 없는 경우