WebSphere JAX-WS 주소록 SAML 웹 서비스 샘플 설정 지시사항

시작하기 전에

샘플을 실행하기 전에 다음 내용을 확인해야 합니다.
  • WebSphere® Application Server 버전 8.5가 설치되었고 서버가 작성되었는지 여부
  • SAML Bearer 1.1 WS HTTPS 정책 세트를 가져왔는지 여부(이 작업은 설치 시 기본적으로 완료됨)
기본적으로 WebSphere Application Server 설치 시 서버가 작성됩니다. 서버 보기에서 이 서버를 볼 수 있습니다. 그러나 새 서버를 작성하려면 다음을 수행하십시오.
  1. 파일 메뉴에서 새로 작성 > 기타 > 서버 > 서버 > 다음을 선택하십시오.
  2. WebSphere Application Server 버전 8.5를 서버 유형으로 선택하고 다음을 클릭하십시오.
  3. 작업공간에 접속된 런타임 환경이 없는 경우 WebSphere Application Server의 설치 디렉토리를 입력하도록 프롬프트가 표시됩니다.
  4. 서버 설정 페이지에서 완료를 클릭하십시오.
  5. 작업공간에서 작성한 서버를 보려면 창 메뉴에서 보기 표시 > 기타 > 서버 > 서버 > 확인을 선택하십시오.
SAML Bearer 1.1 WS HTTPS 정책 세트를 가져오려면 다음을 수행하십시오.
  1. 서버를 마우스 오른쪽 단추로 클릭하고 시작을 선택하여 서버를 시작하십시오.
  2. 서버를 마우스 오른쪽 단추로 클릭하고 관리 > 관리 콘솔 실행을 선택하여 관리 콘솔을 여십시오.
  3. 관리 콘솔에서 서비스 > 정책 세트 > 애플리케이션 정책 세트를 펼치십시오.
  4. 가져오기 > 기본 저장소에서를 클릭하고 SAML1.1 Bearer WSHTTPS 기본값을 선택한 후 확인을 클릭하십시오.
  5. 저장을 클릭하고 관리 콘솔을 닫은 후 서버를 다시 시작하십시오. 이제 샘플을 가져올 수 있습니다.

이 태스크 정보

샘플 실행: 샘플을 가져온 후에는 TestClient.jsp를 사용하여 샘플을 실행하십시오.

프로시저

  1. SAMLBearer_AddressBookClient/WebContent/sampleAddressBookPortProxy/TestClient.jsp를 선택하고 마우스 오른쪽 단추를 클릭하여 실행 도구 > 서버에서 실행을 선택하십시오. WebSphere Application Server 버전 8.5 프로파일이 선택되었으며 SAMLBearer_AddressBookEAR이 서버에 추가되었는지 확인하십시오.
  2. saveAddress 메소드를 선택하고 이름 필드에 정보를 입력하십시오. 기타 모든 필드는 선택사항입니다. 호출을 클릭하십시오. 결과 분할창에 true가 표시됩니다.
  3. findAddress 메소드를 선택하고 saveAddress 메소드 실행 중 사용한 이름을 입력한 후 호출을 클릭하십시오. saveAddress 메소드로 저장한 정보가 결과 분할창에 표시되어야 합니다.

다음에 수행할 작업

웹 서비스 및 클라이언트와 연관된 정책 세트를 보는 방법은 두 가지가 있습니다.
  • SAMLBearer_AddressBookEAR/META-INF에 clientPolicyAttachements.xmlpolicyAttachements.xml이라는 두 개의 파일이 작성됩니다. 기본 편집기에서 이 파일을 열어 클라이언트 및 서비스 각각에 대한 서비스 설정의 품질을 볼 수 있습니다.
  • 서비스 보기의 JAX-WS 웹 서비스 노드 아래에 클라이언트 및 서비스가 나열됩니다. 정책 세트 첨부 관리를 마우스 오른쪽 단추로 클릭하면 정책 세트를 보거나 수정할 수 있습니다.
기본이 아닌 포트를 사용하여 샘플 실행: TCP/IP 모니터와 같이 기본이 아닌 포트를 통해 웹 서비스 트래픽을 라우트하려면, 모니터의 포트 번호와 일치하도록 샘플 기본 엔드포인트를 변경해야 합니다.
  1. WebSphere 관리 콘솔에서 WebSphere Application Server가 사용 중인 기본 포트를 판별할 수 있습니다.
    1. 서버 보기에서 사용자의 서버를 마우스 오른쪽 단추로 클릭하고 관리 콘솔 실행을 선택하여 WebSphere Application Server 관리 콘솔을 실행하십시오.
    2. 왼쪽 분할창에서 서버를 펼치고 애플리케이션 서버를 선택하십시오.
    3. 목록에서 서버 이름을 선택하십시오. 기본적으로 서버 이름은 server1입니다.
    4. 구성 탭에서 통신 표제를 검색하고 포트를 펼치십시오.
    5. 사용되는 포트는 WC_defaulthost입니다.
  2. TestClient.jsp를 실행하십시오. SAMLBearer_AddressBookClient/WebContent/sampleAddressBookPortProxy/TestClient.jsp를 선택하고 마우스 오른쪽 단추를 클릭하여 실행 도구 > 서버에서 실행을 선택하십시오. WebSphere Application Server 버전 8.5 프로파일이 선택되었으며 SAMLBearer_AddressBookEAR이 서버에 추가되었는지 확인하십시오.
  3. JSP의 서비스 품질 분할창의 엔드포인트 필드에서 포트 번호를 변경하고 업데이트를 클릭하십시오.
참고: JAXB 무시 및 XML 페이로드 사용을 선택하면 TestClient.jsp 메소드의 JAXB 바인딩 보기가 원시 SOAP 메시지로 바뀝니다. 이 기능을 사용하려면 입력에 필수인 SOAP 본문 항목을 수동으로 입력해야 합니다. 이 기능은 생성된 클라이언트가 웹 서비스에 포함되어 있는 모든 메소드를 처리할 수 없는 경우에 유용하지만, 주소록 샘플에는 불필요한 기능입니다.

피드백