WS-Security에 대한 비밀번호 콜백 핸들러 개발

Liberty에서 비밀번호 콜백 핸들러는 비밀번호를 검색하기 위해 많은 WS-Security 시나리오에서 사용될 수 있습니다. 예를 들어, 비밀번호는 UsernameTokens을 생성하거나, 키 저장소를 열거나, 개인 키에 액세스하기 위해 검색할 수 있습니다. PasswordDigest를 사용할 때 제공자에게 비밀번호 콜백 핸들러가 필요합니다. 비밀번호 콜백 핸들러는 Liberty에서 사용자 기능으로 패키징되어야 합니다.

이 태스크 정보

이 태스크에서는 사용자 이름 및 키 저장소 키 비밀번호를 검색하기 위해 비밀번호 콜백 핸들러를 개발하는 방법을 설명합니다.

프로시저

  1. 비밀번호 콜백 핸들러를 개발하십시오. 다음 예제는 콜백 핸들러를 보여줍니다.
    package com.ibm.ws.wssecurity.example.cbh;
    
    import java.util.HashMap;
    import java.util.Map;
    import javax.security.auth.callback.Callback;
    import javax.security.auth.callback.CallbackHandler;
    import org.apache.ws.security.WSPasswordCallback;
    
    public class SamplePasswordCallback implements CallbackHandler {
    
      private Map<String, String> userPasswords =  new HashMap<String, String>();
      private Map<String, String> keyPasswords = new HashMap<String, String>();
      public SamplePasswordCallback() {
        // some example user passwords
        userPasswords.put("user1", "user1pswd");
        userPasswords.put("admin", "adminpswd");
        // some example key passwords
        keyPasswords.put("alice",  "keypwsd");
        keyPasswords.put("bob",   "keypswd");
      }
      public void handle(Callback[] callbacks) throws IOException, UnsupportedCallbackException {
        for (int i = 0; i < callbacks.length; i++) {
          WSPasswordCallback pwcb = (WSPasswordCallback)callbacks[i];
          String id = pwcb.getIdentifier();
          String pass = null;
          switch (pwcb.getUsage()) {
            case WSPasswordCallback.USERNAME_TOKEN_UNKNOWN:
            case WSPasswordCallback.USERNAME_TOKEN:
              pass = userPasswords.get(id);
              pwcb.setPassword(pass);
              break;
            case WSPasswordCallback.SIGNATURE:
            case WSPasswordCallback.DECRYPT:
              pass = keyPasswords.get(id);
              pwcb.setPassword(pass);
              break;
          }
        }
      }
    }
  2. 콜백 핸들러에 대한 MANIFEST.MF 파일을 작성하십시오. 다음 예제는 MANIFEST.M 파일을 보여줍니다.
    Manifest-Version: 1.0
    Bnd-LastModified: 1359415594428
    Build-Identifier: SNAPSHOT-Mon Jan 28 17:26:34 CST 2013
    Bundle-Copyright: The Program materials contained in this file are IBM
    copyright materials. 5724-I63, 5724-J08, 5724-H89, 5724-H88, 5655-W65
    Copyright International Business Machines Corp. 1999, 2012 All Rights
    Reserved * Licensed Materials - Property of IBM US Government Users
    Restricted Rights - Use, duplication or disclosure restricted by GSA ADP
    Schedule Contract with IBM Corp.
    Bundle-Description: An PasswordCallbackHandler; version=1.0.0
    Bundle-ManifestVersion: 2
    Bundle-Name: wssecuritycbh
    Bundle-SymbolicName: com.ibm.ws.wssecurity.example.cbh
    Bundle-Vendor: IBM
    Bundle-Version: 1.0.0
    Created-By: 1.6.0 (IBM Corporation)
    Export-Package: com.ibm.ws.wssecurity.example.cbh;uses:="com.ibm.websphe
    re.ras.annotation,javax.security.auth.callback";version="1.0.0"
    Import-Package: com.ibm.websphere.ras,com.ibm.websphere.ras.annotation,c
    om.ibm.ws.ffdc,javax.security.auth.callback,org.apache.ws.security;version="[1.6,2)"
    Require-Capability: osgi.ee;filter:="(&(osgi.ee=JavaSE)(version>=1.6))"
    Tool: Bnd-2.1.0.20120920-170235
    WS-TraceGroup: WSSecurity
  3. 콜백 핸들러를 JAR 파일로 패키징하십시오. 이전 단계에서 작성한 MANIFEST.MF 파일과 콜백 핸들러 클래스로 JAR 파일을 작성하십시오. 다음 예제는 SampleCbh.jar이라고 하는 샘플 JAR 파일의 컨텐츠를 보여줍니다.
    META-INF/MANIFEST.MF
    com/ibm/ws/wssecurity/example/cbh/SamplePasswordCallback.class
  4. 기능 Manifest 파일을 작성하십시오. 다음 예제는 wsseccbh-1.0.mf라고 하는 샘플 기능 Manifest 파일을 보여줍니다.
    Subsystem-ManifestVersion: 1
    Subsystem-SymbolicName: wsseccbh-1.0; visibility:=public
    Subsystem-Version: 1.0.0 
    Subsystem-Content: com.ibm.ws.wssecurity.example.cbh; version="[1,1.0.100)";    location:="lib/"; type="osgi.bundle"; start-phase:=APPLICATION_EARLY
     
    Subsystem-Type: osgi.subsystem.feature
    IBM-Feature-Version: 2
    
    IBM-API-Package: com.ibm.ws.wssecurity.example.cbh; version="1.0"; type="internal"
  5. Liberty에서 사용자 기능으로서 콜백 핸들러를 설치하십시오. 콜백 핸들러 JAR 파일 및 기능 Manifest 파일을 Liberty 사용자 디렉토리에 복사하십시오. 다음 예는 파일 복사 위치를 보여줍니다.
    build.image/wlp/usr/extension/lib/SampleCbh.jar
    build.image/wlp/usr/extension/lib/features/wsseccbh-1.0.mf
  6. server.xml 파일에서 콜백 핸들러를 사용자 기능으로 구성하십시오. server.xml 파일에서 콜백 핸들러를 사용자 기능으로 정의하십시오. 다음 예제는 콜백 핸들러를 사용자 기능으로 정의하는 방법을 보여줍니다.
    <featureManager>
      <feature>usr:wsseccbh-1.0</feature>
      <feature>servlet-3.0</feature>
      <feature>appSecurity-2.0</feature>
      <feature>jaxws-2.2</feature>
      <feature>wsSecurity-1.1</feature>
    </featureManager>

결과

정상적으로 비밀번호 콜백 핸들러가 개발되었으며 Liberty에 콜백 핸들러가 설치되었습니다.

다음에 수행할 작업

이제 이 콜백 핸들러를 사용하여 UsernameTokens에 대한 비밀번호와 WS-Security 구성에서 사용되는 개인용 키를 검색할 수 있습니다.

주제의 유형을 표시하는 아이콘 태스크 주제

파일 이름: twlp_wssec_callbackhandler.html