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> 는 SDK 가 인스톨 되고 있는 디렉토리입니다.

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

모든 디폴트 핸들러의 구현에서는 인수를 가지지 않는 public constructor 이 없으면 안됩니다.

메소드의 개요

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

메소드의 상세

handle

public 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 파라미터로 지정된 1 kr 이상의 Callback 를 서포트하지 않는 경우