REST API를 사용하여 Oracle Universal Authenticator 클라이언트 애플리케이션 사용자정의

소개

이 사용지침서에서는 REST API 및 Postman을 사용하여 Oracle Universal Authenticator 클라이언트 애플리케이션을 사용자정의하는 방법을 보여줍니다.

필요 조건

이 자습서를 시작하기 전에 다음 사항이 있어야 합니다.

  1. Read and understood Customizing the Oracle Universal Authenticator Client Application.
  2. Oracle Universal Authenticator와 함께 배치된 실행 중인 Oracle Advanced Authentication 설치입니다.
  3. Oracle Universal Authenticator 클라이언트 응용 프로그램 설치에 따라 장치에 Oracle Universal Authenticator 클라이언트 응용 프로그램을 설치했습니다.
  4. REST 구조 스타일에 대한 기본적인 이해
  5. Native Postman client 응용 프로그램이 설치되었습니다.
  6. JSON 파일 Oracle_Universal_Authenticator_REST_API.postman_collection.json, Oracle_Universal_Authenticator_Example_Environment.postman_environment.json을 다운로드했습니다.

참고: 관리자는 REST API를 사용하여 속성을 업데이트할 때 다음 사항에 유의해야 합니다.

Oracle Advanced Authentication Postman Collection 설치

Postman에서 환경 매개변수 설정

참고: 아래 단계는 사용 중인 Postman 버전에 따라 다를 수 있습니다.

  1. Postman을 열고 작업 영역에서 환경을 선택합니다.

  2. 임포트를 누릅니다.

  3. 임포트 대화상자에서 Oracle_Universal_Authenticator_Example_Environment.postman_environment.json을 선택하거나 삭제한 다음 열기를 누릅니다.

  4. 표시된 환경 목록에서 Oracle Universal Authenticator 예제 환경 오른쪽에 있는 줄임표를 누르고 복제를 누릅니다.

  5. 원래 환경 위에 나타나는 Oracle Universal Authenticator 예제 환경 복사에서 줄임표를 누르고 이름을 Oracle Universal Authenticator Environment for REST APIs로 바꿉니다.

  6. 초기 값 및 현재 값에 대해 다음 값을 입력하여 새 환경에 대한 환경 변수를 업데이트합니다. 완료되면 저장을 누릅니다.

    • RELEASENAME: Oracle Advanced Authentication 설정에 지정된 RELEASENAME(예: oaainstall)입니다.
    • DRSS_URL: Oracle Advanced Authentication에서 DRSS 끝점에 대한 URL(예: https://oaa.example.com/oaa-drss)입니다.
    • DRSS_USERNAME: RELEASENAME-oaa-drss 형식의 DRSS API 사용자 이름입니다(예: oaainstall-oaa-drss).
    • DRSS_PASSWORD: Oracle Advanced Authentication 설정의 경우 drssapikey입니다.

    주: RELEASENAME, DRSS_URL, DRSS_USERNAME 및 DRSS_PASSWORD를 모를 경우 배치 세부정보 인쇄를 참조하십시오.

    환경은 다음과 유사합니다.

  7. 환경 드롭다운 목록을 누른 다음 목록에서 업데이트된 환경을 선택합니다.

Postman 컬렉션 가져오기

  1. Oracle Advanced Authentication REST API Postman 모음을 임포트하려면 모음 > 임포트를 선택합니다.

  2. 임포트 대화상자에서 Oracle_Universal_Authenticator_REST_API.postman_collection.json을 선택하거나 삭제합니다.

    컬렉션은 다음과 같이 표시되어야 합니다.

테마 API 테스트

언어 테마 생성

주: SSL 인증서 확인 오류를 방지하려면 탐색 햄버거 메뉴에서 파일 > 설정으로 이동하고 [일반 사항] 탭에서 SSL 인증서 확인을 해제합니다.

이 섹션에서는 사용자 정의할 항목의 언어 테마를 생성합니다.

  1. [모음] 탭에서 Oracle Universal Authenticator REST API > 테마 관리 API로 이동합니다.

  2. PUT updateLocale을 선택합니다. 이 요청은 oaa-drss/v1/themes/<locale> 끝점에 대해 PUT 요청을 수행하고 본문의 정보를 기반으로 필요한 로케일에 대한 테마를 생성합니다.

    필드 및 값을 적절히 변경하거나 제거합니다.

    이 예에서는 en_US 언어에 대한 테마가 생성되고, oaa-drss/v1/themes/en_US 및 모든 사용자정의 가능 속성이 업데이트됩니다.

    로고 값의 경우 선택한 유틸리티를 사용하여 bmp 파일을 BASE64로 변환하고 값을 logo 항목에 붙여넣어야 합니다.

  3. 전송을 누릅니다.

  4. 응답에서 204 No Content가 나타나는지 확인합니다.

  5. 다른 언어의 테마를 더 생성하세요. 이 예에서는 프랑스어 fr 언어에 대한 테마가 생성되고, oaa-drss/v1/themes/fr 및 모든 사용자정의 가능 속성이 업데이트됩니다.

    참고: 사용자정의되는 모든 텍스트는 생성 중인 테마의 언어여야 합니다.

  6. 전송을 누릅니다.

  7. 응답에서 204 No Content가 나타나는지 확인합니다.

  8. 필요한 다른 언어 테마(예: 스페인어 등)에 대해 위를 반복합니다.

언어 테마 받기

  1. [모음] 탭에서 Oracle Universal Authenticator REST API > 테마 관리 API로 이동합니다.

  2. GET getLocale을 선택합니다. 이 요청은 oaa-drss/v1/themes/locales 끝점으로 GET 요청을 수행하고 생성된 모든 테마를 반환합니다.

  3. 전송을 누릅니다.

  4. 응답에서 Status: 200 OK가 나타나는지 확인합니다. 테마 목록이 반환됩니다.

테마에 대한 사용자정의 속성 가져오기

  1. [모음] 탭에서 Oracle Universal Authenticator REST API > 테마 관리 API로 이동합니다.

  2. GET getLocale을 선택합니다. 이 요청은 oaa-drss/v1/themes/<locale> 끝점에 대해 GET 요청을 수행하고 테마에 대해 사용자정의된 모든 속성을 반환합니다.

  3. 전송을 누릅니다.

  4. 응답에서 Status: 200 OK가 나타나는지 확인합니다. 사용자 정의된 등록 정보 목록이 반환됩니다.

    주: 사용자정의한 매개변수뿐만 아니라 사용자정의하지 않은 매개변수 및 사용자정의할 수 없는 기타 매개변수에 대한 기본값이 표시됩니다.

테마 활성화

Oracle Universal Authenticator 클라이언트 애플리케이션의 테마 사용을 시작하려면 oua.themes.custom.distribution 속성을 "1"로 설정해야 합니다.

  1. [모음] 탭에서 Oracle Universal Authenticator REST API > 테마 관리 API로 이동합니다.

  2. PUT oua.themes.custom.distribution을 선택합니다. 이 요청은 본문에서 oua.themes.custom.distribution 속성을 설정하여 oaa-drss/oua/property/v1 끝점에 PUT 요청을 생성합니다. 1 값은 테마를 활성화하고, 0 값은 테마를 비활성화합니다. 기본값은 0입니다.

  3. 전송을 누릅니다.

  4. 응답에서 Status: 200 OK가 나타나고 응답에 1로 설정된 oua.themes.custom.distribution가 포함되어 있는지 확인합니다.

테마 업데이트

  1. [모음] 탭에서 Oracle Universal Authenticator REST API > 테마 관리 API로 이동합니다.

  2. PUT updateLocale을 선택합니다. 이 요청은 oaa-drss/v1/themes/<locale> 끝점에 대해 PUT 요청을 수행하고 본문의 정보를 기반으로 필요한 로케일에 대한 테마를 생성하거나 업데이트합니다.

    필드 및 값을 적절하게 업데이트하거나 제거합니다.

    참고: 갱신할 필드는 물론 이전에 사용자 정의한 모든 필드를 포함해야 합니다. 이전에 사용자 정의한 등록 정보를 추가하지 않으면 해당 등록 정보를 기본값으로 덮어씁니다.

    이 예에서는 CPFT_TILE_IMAGE가 Enter your Example Company Username"로 업데이트됩니다.

  3. 전송을 누릅니다.

  4. 응답에서 204 No Content가 나타나는지 확인합니다.

테마 삭제

테마를 삭제하면 테마가 완전히 제거됩니다. 관리자는 테마를 삭제할 때 주의해야 하며 다음 사항에 주의해야 합니다.

  1. [모음] 탭에서 Oracle Universal Authenticator REST API > 테마 관리 API로 이동합니다.

  2. DEL deleteLocale을 선택합니다. 이 요청은 oaa-drss/v1/themes/<locale> 끝점에 대해 DELETE 요청을 수행하고 지정된 로케일에 대한 테마를 삭제합니다.

    이 예에서는 스페인어 로케일(es)이 삭제됩니다.

  3. 전송을 누릅니다.

  4. 응답에서 204 No Content가 나타나는지 확인합니다.

  5. 테마를 더미 값으로 업데이트해야 하는 경우 PUT updateLocale을 사용하여 테마를 업데이트하고 전송을 누릅니다. 204 No Content 메시지가 나타납니다.

더 알아보기

피드백

이 자습서에 대한 피드백을 제공하려면 idm_user_assistance_ww_grp@oracle.com으로 문의하십시오.

감사의 글

추가 학습 자원

docs.oracle.com/learn에서 다른 실습을 탐색하거나 Oracle Learning YouTube 채널에서 더 많은 무료 학습 콘텐츠에 액세스하세요. 또한 Oracle Learning Explorer가 되려면 education.oracle.com/learning-explorer을 방문하십시오.

제품 설명서는 Oracle Help Center를 참조하십시오.