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을 읽어내거나 로드하거나 하는 구현을 제공하도록 상속할 필요가 있습니다.

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

      Name {
              ModuleClass  Flag    ModuleOptions;
              ModuleClass  Flag    ModuleOptions;
              ModuleClass  Flag    ModuleOptions;
      };
      Name {
              ModuleClass  Flag    ModuleOptions;
              ModuleClass  Flag    ModuleOptions;
      };
      other {
              ModuleClass  Flag    ModuleOptions;
              ModuleClass  Flag    ModuleOptions;
      };
 

Configuration 각 엔트리는 어플리케이션명 Name 로 인덱스화 되고 있어 그 어플리케이션용으로 구성된 LoginModule 리스트가 포함되어 있습니다. 각 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개 성공하지 않으면 안됩니다.

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 () 유일한 생성자 입니다.

메서드 개요

abstract AppConfigurationEntry []	getAppConfigurationEntry (String name) 이 Configuration 로부터, 지정된 name AppConfigurationEntries를 취득합니다.
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()

유일한 생성자 입니다. 서브 클래스의 생성자에 한 호출은 일반적으로 암묵적인 호출입니다.

메서드의 상세

getConfiguration

public static Configuration  getConfiguration()

Login Configuration를 취득합니다.

반환값:

로그인 Configuration. Configuration 객체가 Configuration.setConfiguration 메서드로 설정되어 있는 경우는 그 객체가 리턴됩니다 . 그렇지 않은 경우는 디폴트의 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  name)

이 Configuration 로부터, 지정된 name AppConfigurationEntries를 취득합니다.

파라미터:

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

반환값:

이 Configuration 로부터 얻는, 지정된 name AppConfigurationEntries 배열. 지정된 name 엔트리가 없는 경우는 null

refresh

public abstract void refresh()

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

이 메서드는 이 Configuration 객체에 구현에 존한 방법으로 그 내용의 리프레쉬나 재로드를 실시하게 합니다. 예를 들어 Configuration 객체의 엔트리가 파일에 포함되고 있는 경우, refresh를 호출하면, 파일이 한번 더 읽어내지게 됩니다.

예외:

SecurityException - 호출 측에 그 Configuration를 리프레쉬 하는 접근 권한이 없는 경우