javax.security.auth.callback
인터페이스 CallbackHandler

public interface CallbackHandler

기본 시큐러티 서비스가 사용자 명이나 패스워드등의 특정의 인증 데이터를 취득하거나 에러나 경고 메세지등의 특정의 정보를 표시하거나 할 수 있도록, 어플리케이션은 CallbackHandler을 구현해, 기본 시큐러티 서비스에 건네줍니다.

CallbackHandler는 어플리케이션 고유의 형식에서 구현됩니다. 예를 들어 그래피컬 사용자 인터페이스 (GUI)를 가지는 어플리케이션에 있어서의 구현에서는 윈도우를 pop-up 해, 정보를 요구하는 prompt나, 에러 메세지를 표시합니다. 또, 요구된 정보를, 최종 사용자에게 묻는 것이 아니라, 다른 소스로부터 얻는 일도 선택할 수 있습니다.

기본 시큐러티 서비스에서는 개개의 Callback를 CallbackHandler에 건네주는 것으로 다양한 타입의 정보를 요구할 수 있습니다. CallbackHandler 구현에서는 건네받는 Callback에 의해 바뀌는 정보의 취득과 표시의 방법을 결정하게 됩니다. 예를 들어기본 서비스로 사용자를 인증하기 위해서 사용자 명으로 패스워드가 필요한 경우는 NameCallback 과 PasswordCallback를 사용합니다. CallbackHandler에 서는 사용자 명과 패스워드를 차례로 입력시키는지, 1개의 윈도우내에 양쪽 모두를 입력시키는지를 선택할 수 있습니다.

디폴트의 CallbackHandler 클래스의 구현은 auth.login.defaultCallbackHandler 시큐러티 프로퍼티로 지정되고 있습니다. 시큐러티 프로퍼티는 <JAVA_HOME>/lib/security/java.security 라고 하는 파일에 있는 Java 시큐러티 프로퍼티 파일로 설정합니다. <JAVA_HOME>는 JDK가 인스톨 되고 있는 디렉토리입니다.

시큐러티 프로퍼티가 CallbackHandler 구현 클래스의 완전 지정명으로 설정되어 있는 경우, LoginContext는 지정한 CallbackHandler를 로드해, 기본이 되는 LoginModule에 건네줍니다. 그렇지 않은 경우, LoginContext는 디폴트의 핸들러만을 로드합니다.

모든 디폴트 핸들러의 구현은 인수를 가지지 않는 public 생성자를 제공할 필요가 있습니다.

메서드 개요

void	handle (Callback [] callbacks) 지정의 Callback 내에서 요구된 정보를 취득 또는 표시합니다.

메서드의 상세

handle

void handle(Callback [] callbacks)
            throws IOException,

                   UnsupportedCallbackException 

지정의 Callback 내에서 요구된 정보를 취득 또는 표시합니다.

handle 메서드의 구현에서는 건네받은 Callback 객체의 인스턴스가 요구된 정보를 취득 또는 표시할 수 있을지 어떨지를 확인합니다. handle 메서드 구현의 동작의 실례를, 다음에 나타냅니다. 이 코드예는 견본을 나타낼 뿐입니다. 코드를 간단하게 하기 위해서 적절한 에러 처리등의 자세한 것은 생략하고 있습니다.

public void handle(Callback[] callbacks)
throws IOException, UnsupportedCallbackException {

         for (int i = 0; i < callbacks.length; i++) {
            if (callbacks[i] instanceof TextOutputCallback) {
 
                // display the message according to the specified type
                TextOutputCallback toc = (TextOutputCallback) callbacks[i];
                switch (toc.getMessageType()) {
                case TextOutputCallback.INFORMATION:
                    System.out.println(toc.getMessage());
                    break;
                case TextOutputCallback.ERROR:
                    System.out.println("ERROR: " + toc.getMessage());
                    break;
                case TextOutputCallback.WARNING:
                    System.out.println("WARNING: " + toc.getMessage());
                    break;
                default:
                    throw new IOException("Unsupported message type: " +
                                        toc.getMessageType());
                }

            } else if (callbacks[i] instanceof NameCallback) {
 
                // prompt the user for a username
                NameCallback nc = (NameCallback) callbacks[i];
 
                // ignore the provided defaultName
                System.err.print(nc.getPrompt());
                System.err.flush();
                nc.setName((new BufferedReader
                        (new InputStreamReader(System.in))). readLine());

            } else if (callbacks[i] instanceof PasswordCallback) {
 
                // prompt the user for sensitive information
                PasswordCallback pc = (PasswordCallback) callbacks[i];
                System.err.print(pc.getPrompt());
                System.err.flush();
                pc.setPassword(readPassword(System.in));
 
            } else {
                throw new UnsupportedCallbackException
                        (callbacks[i], "Unrecognized Callback");
            }
         }
 }
  
// Reads user password from given input stream.
private char[] readPassword(InputStream in) throws IOException {
// insert code to read a user password from the input stream
 }
 

파라미터:

callbacks - 취득 또는 표시가 요구된 정보를 포함한 기본 시큐러티 서비스가 제공하는 Callback 객체의 배열

예외:

IOException - 입출력 에러가 발생했을 경우

UnsupportedCallbackException - 이 메서드의 구현이 callbacks 파라미터로 지정된 Callback 어느쪽이든을 지원 하지 않는 경우