IBM Security Verify API의 테마 기능을 사용하여 화면 맞춤형~준비 편~

개시하다


2021년 4월 업데이트에는 앱에 따라 화면 맞춤형을 제어하는'테마'기능이 추가됐다.

이전에 소개한 템플릿 기능은 IBM Security Verify 임차인 단위로 화면을 맞춤형으로 제작했다.
  • IBM Security Verify API를 통한 맞춤형 템플릿~준비 편~
  • IBM Security Verify API로 템플릿 사용자 정의~실기 편~
  • 따라서 IBM Security Verify에 여러 애플리케이션이 결합되어 있는 경우에는 로그인 화면의 모양을 애플리케이션 단위로 변경할 수 없습니다.
    4월에 발표된 테마 기능을 이용하여 응용 프로그램 단위로 사용자 정의할 수 있다.
    <콘셉트 활용 이미지>

    화면 사용자 정의 시 아래 절차에 따라 조작한다.
  • Default 테마 다운로드
  • 맞춤형 테마
  • 맞춤형 테마를 업로드합니다.
  • 응용 응용 응용 응용 응용 응용 프로그램 테마.
  • API 참조


    API 참조는 다음 URL을 통해 확인할 수 있습니다.
    https:/<자신의 룸메이트 이름>.verify.ibm.com/developer/explorer/#
  • 사용자를 얻기 위한 API에는 다음과 같은 항목이 있습니다.
  • Customization-Theme

  • 화면 사용자 정의에 대한 도움말이 여기 있습니다.
  • 관리 주제
  • https://www.ibm.com/docs/ja/security-verify?topic=branding-managing-themes#t_customizing_themes
  • 1. IBM Security Verify에 API 클라이언트 등록


    OAuth 액세스 토큰을 가져올 클라이언트 ID 및 클라이언트 기밀을 준비합니다.
    브라우저를 통해 IBM Security Verify 관리 화면에 액세스할 수 있습니다.
    https:/<자신의 룸메이트 이름>.verify.ibm.com/ui/admin
    구성 - API 클라이언트 탭을 엽니다.

    API 클라이언트 추가를 클릭합니다.

    액세스를 제공하는 API로서 저장을 선택합니다.
    - 템플릿 관리
    - 템플릿으로 승인합니다.테마만 변경할 권한이 없습니다.
    등록된 API 클라이언트를 편집 모드로 설정하면 클라이언트 ID/클라이언트 기밀 키를 복사할 수 있습니다.

    2. 액세스 토큰 받기

    curl -X POST "https://<テナント名>.verify.ibm.com/oidc/endpoint/default/token" --header "Content-Type: application/x-www-form-urlencoded" --data-urlencode "grant_type=client_credentials" --data-urlencode "client_id=<クライアントID>" --data-urlencode "client_secret=<クライアント秘密鍵>"
    
    획득한 방문 영패는 빨간 상자 부분입니다.

    3. 주제 다운로드 방법


    주제를 다운로드합니다.
    테마 파일 이름은 기본 "the.zip"을 사용합니다.
    curl -X GET https://<テナント名>.verify.ibm.com:443/v1.0/branding/themes/default -H "Accept: application/octet-stream" -H "Authorization: Bearer <アクセストークン>" --output <出力先>\themes.zip
    

    자원 관리자에서 다운로드한 테마, theeme를 엽니다.zip\templates 폴더를 열면 다음 폴더 계층이 됩니다.템플릿보다 폴더 수준이 낮습니다.

    4. 주제 업로드 방법


    사용자 정의 테마를 업로드하려면 두 개의 파일이 필요합니다.
  • 1.사용자 정의 테마 파일
  • 2.테마 이름이 적힌 config입니다.json 파일
  • 두 번째 config.제이슨의 예입니다.
    이 예에서 "custome1"을 주제 이름으로 등록합니다.
    {
    "name": "custome1",
    "description": "first theme customize",
    }
    
    테마를 업로드하는 명령입니다.
    curl -X POST  https://<テナント名>.verify.ibm.com:443/v1.0/branding/themes -H "Content-Type: multipart/form-data" -H "Accept: application/json" -F configuration=@<参照先>/config.json -F "files=@<参照先>/theme_file.zip" -H "Authorization: Bearer  <アクセストークン>"
    

    5. 주제의 적용 방법


    응용 프로그램 응용 프로그램을 위해 화면 관리 - 응용 프로그램에서 대상 응용 프로그램을 편집하고 테마를 적용합니다.

    6. 주제 재설정 방법


    테마를 초기화하는 데는 두 가지 방법이 있습니다.
  • 1.템플릿 재설정(대량 삭제)
  • 2.개별 테마 삭제
  • 또한 프로그램이 테마를 적용했다면 테마를 해제해야 합니다.
    첫 번째 템플릿 재설정 명령은 다음과 같습니다.
    curl -i -X DELETE  https://<テナント名>.verify.ibm.com:443/v1.0/branding/reset -H "Authorization: Bearer <アクセストークン>"
    

    응답 코드는 204입니다.
    또한 응용 프로그램 응용 프로그램 주제 상태에서 템플릿을 재설정하면 다음 오류가 발생합니다.

    두 번째 주제의 개별 삭제에는 주제 ID가 필요합니다.
    다음 명령을 사용하여 주제 ID를 가져옵니다.
    curl -X GET  https://<テナント名>.verify.ibm.com:443/v1.0/branding/themes -H "Authorization: Bearer <アクセストークン>""
    

    주제의 개별 삭제 명령은 다음과 같습니다.
    curl -i -X DELETE  https://<テナント名>.verify.ibm.com:443/v1.0/branding/themes/<テーマID> -H "Authorization: Bearer <アクセストークン>"
    

    최후


    준비편으로 주제를 이용하여 화면 맞춤형을 하는 기본 조작과 명령을 소개했다.
    나는 실천편에 실제 화면을 바꾸는 방법을 기재하고 싶다.

    좋은 웹페이지 즐겨찾기