어설션 콘텐츠 사용자 지정

목차
casso12kr
목차
2
AssertionGeneratorPlugin 인터페이스 구현
사용자 지정 어설션 생성기 플러그인을 생성할 때의 첫 번째 단계는 AssertionGeneratorPlugin 인터페이스를 구현하는 것입니다. 다음 요구 사항이 구현 클래스에 적용됩니다.
  • 구현에서는 매개 변수가 포함되지 않은 공개 기본 생성자 메서드를 제공해야 합니다.
  • 구현은 상태 비저장이어야 합니다. 따라서 여러 스레드가 단일 플러그인 클래스를 사용할 수 있어야 합니다.
  • 구현에 customizeAssertion 메서드 호출이 포함되어야 합니다. 요구 사항에 따라 이러한 메서드의 기존 구현을 덮어쓸 수 있습니다. 샘플 프로그램을 참조하십시오.
  • customizeAssertion 메서드에 전달되는 매개 변수 문자열의 구문 요구 사항과 사용에 대한 책임은 사용자 지정 개체에 있습니다.
참고
federation_sdk_home
\sample\com\ca\federation\sdk\plugin\sample 폴더에 두 개의 샘플 구현 클래스가 포함되어 있습니다.
어설션 생성기 플러그인 배포
AssertionGeneratoPlugin 인터페이스에 대한 구현 클래스를 코드화했으면 해당 구현 클래스를 컴파일하고
Single Sign-On
Federation이 실행 파일을 찾을 수 있는지 확인하십시오.
어설션 생성기 플러그인을 배포하려면
  1. 다음 방법 중 하나로 어설션 플러그인 코드를 컴파일합니다.
    • 샘플 플러그인을 사용하는 경우 플랫폼의 빌드 스크립트를 사용하여 플러그인을 컴파일합니다. 빌드 스크립트는
      federation_sdk_home
      \sample 디렉터리에 설치됩니다. 빌드 스크립트는 다음과 같습니다.
      Windows:
      build_plugin.bat
      UNIX:
      build_plugin.sh
      컴파일된 샘플 플러그인 fedpluginsample.jar은
      federation_sdk_home
      \jar 디렉터리에 있습니다.
    • 플러그인을 직접 작성하는 경우에는 플러그인을 컴파일할 때 smapi.jar를 포함하십시오.
  2. JVMOptions.txt 파일에서 플러그인의 클래스 경로를 포함하도록 -Djava.class.path 값을 수정합니다.
    federation_install_dir
    \siteminder\config 디렉터리에서 JVMOptions.txt 파일을 찾습니다.
    플러그인 jar를 원하는 디렉터리에 저장하고 JVMOptions.txt 파일에서 해당 위치를 가리키도록 할 수 있습니다. 샘플 플러그인을 사용하려면 fedpluginsample.jar를 가리키도록 클래스 경로를 수정해야 하지만 smapi.jar의 클래스 경로는 수정하지 마십시오.
    참고:
    Apache Xerces 또는 Xalan을 플러그인에 사용하려면
    Single Sign-On
    Federation과 함께 설치된 Xerces 또는 Xalan 바이너리 파일을 사용하십시오. 바이너리는
    Single Sign-On
    Federation SDK로는 설치되지 않습니다. 이 파일은 호환성을 위해 필요합니다.
  3. Single Sign-On
    Federation 서비스를 다시 시작합니다.
    서비스를 다시 시작하면
    Single Sign-On
    Federation이 최신 버전의 어설션 생성기 플러그인을 사용합니다.
어설션 생성기 플러그인이 사용되도록 설정
어설션 생성기 플러그인을 작성하고 컴파일한 후
Single Sign-On
Federation UI에서 설정을 구성하여 플러그인이 사용되도록 설정해야 합니다. UI 매개 변수는
Single Sign-On
Federation에게 플러그인을 찾을 수 있는 위치를 알려 줍니다.
플러그인을 배포할 때까지 플러그인 설정을 구성하지 마십시오.
어설션 생성기 플러그인이 사용되도록 설정하려면
  1. 관리 UI에 로그온합니다.
  2. 수정하려는 파트너 관계에 대한 파트너 관계 마법사의 "어설션 구성" 단계로 이동합니다.
  3. 다음 어설션 생성기 플러그인 설정의 값을 입력합니다.
    • 플러그인 클래스
      플러그인의 Java 클래스 이름을 지정합니다. 이름을 입력합니다. 이 플러그인은 런타임에 호출됩니다.
      예: com.mycompany.assertiongenerator.AssertionSample
      플러그인 클래스는 어설션을 구문 분석하고 수정한 다음 최종 처리를 위해 결과를
      Single Sign-On
      Federation에 반환할 수 있습니다. 각 신뢰 당사자의 어설션 생성기 플러그인을 지정합니다. SDK에 컴파일된 샘플 플러그인이 포함되어 있습니다. 컴파일된 샘플 어설션 플러그인은
      federation_sdk_home
      /jar 디렉터리에서 볼 수 있습니다.
      참고:
      federation_sdk_home\sample\com\ca\federation\sdk\plugin\sample 디렉터리에서
      Single Sign-On
      Federation 샘플 플러그인의 소스 코드도 볼 수 있습니다.
    • 플러그인 매개 변수
      (선택 사항)
      Single Sign-On
      Federation이 런타임에 플러그인에 매개 변수로 전달하는 문자열을 지정합니다. 이 문자열에는 어떤 값이든 포함될 수 있으며 따라야 하는 특정 구문이 없습니다.
      플러그인은 수신하는 매개 변수를 해석합니다. 예를 들어 매개 변수는 특성 이름일 수도 있고 플러그인에 작업을 수행하도록 지시하는 정수가 문자열에 포함될 수도 있습니다.
참조 정보(메서드 서명, 매개 변수, 반환 값, 데이터 형식)와 UserContext 클래스 및 APIContext 클래스에 대한 생성자는
Javadoc 참조서
에서 확인할 수 있습니다. Javadoc의 AssertionGeneratorPlugin 인터페이스를 참조하십시오.