테마에 IFA(식별자 우선 인증) 할당

온라인에서 편집하기

플로우 디자이너에 IFA(Identifier-First Authentication) 흐름이 게시되면, 이를 사용하여 로그인 환경을 사용자 지정하려면 원하는 테마를 업데이트해야 합니다.

시작하기 전에

  • 이 태스크를 완료하려면 관리 권한이 있어야 합니다.
  • IBM® Verify 관리 콘솔에 로그인하십시오.
  • 게시된 IFA 흐름이 있어야 합니다. 자세한 내용은 ‘식별자 우선 인증(IFA) 구성’을 참조하십시오.

이 태스크에 대한 정보

다음 HTML 페이지를 수정하여 원하는 테마를 적용하고 로그인 화면을 맞춤 설정하세요: template/authentication/login/identity sources/identity source selection/combined_login_selection.html.

Verify 브랜딩 기능은 테마 HTML 파일 수정을 지원하며, 인라인 JavaScript, 사용을 허용하므로 로그인 페이지에서 바로 IFA 흐름을 시작하는 스크립트를 추가할 수 있습니다. theme.zip테마 패키지는 파일을 다운로드하고, 해당 파일을 편집한 다음, 브랜딩 API를 통해 파일을 .zip 다시 업로드하여 업데이트합니다.

프로시저

  1. 현재 사용 중인 테마를 다운로드하세요.

    테마는 Verify UI 또는 브랜딩 API를 통해 업데이트할 수 있습니다.

    Verify UI 사용
    이미 IFA 리디렉션 스크립트가 포함된 테마(API를 통해 업데이트되었거나 개발팀에서 생성한 테마)가 있다면, UI에서 직접 해당 테마를 애플리케이션에 할당할 수 있습니다.
    1. ‘사용자 경험 ’ > ‘브랜딩 ’으로 이동합니다.
    2. ‘사용자 지정 테마 만들기 ’를 클릭하세요.
    3. ‘마스터 템플릿 파일 다운로드’를 클릭한 다음, 파일을 .zip 로컬에 압축을 풀어주세요.
      이 파일들에는 사용자가 직접 수정할 로그인 템플릿이 포함되어 있습니다.
    4. IFA 흐름을 시작하는 ‘ JavaScript ’를 추가하세요.
      해당 로그인 템플릿에 다음을 추가하세요
      <script>  window.location.href = "https://<tenant>/v1.0/flows/<flowID>/start"; </script>
      .
    5. 사용자 정의 템플릿 파일을 다시 압축하십시오.
      참고: 폴더 구조는 그대로 유지한 채 루트 디렉터리를 압축해 주세요.
    6. 창으로 돌아가서 ‘파일 업로드’를 클릭한 다음, 파일을 .zip 선택하세요.
    7. 테마 이름을 입력한 다음 ‘테마 만들기’를 클릭하세요.
    브랜딩 API 사용
    1. 테마 패키지 요청하기:
      GET https://<tenant>/v1.0/branding/themes/<themeID>
      . 유효한 액세스 토큰을 포함하십시오. .zip 이 테마는 모든 테마 템플릿이 포함된 파일로 다운로드됩니다.
    2. 템플릿을 확인하고 편집하려면 파일을 .zip 로컬에 압축을 풀어주세요.
  2. 추출된 폴더 안에서 로그인 페이지 템플릿을 찾으세요.
    경로 이름은 테마에 따라 다르지만, 로그인 템플릿은 보통 다음 위치에 있습니다:
    /templates/authentication/login/cloud_directory/default/login.html
/templates/authentication/login/saml/default/login.html
/templates/authentication/login/oidc/default/login.html

    로그인 템플릿을 수정하여 사용자를 게시된 IFA 흐름으로 리디렉션하십시오( ‘식별자 우선 인증 구성 ’의 ‘ URL ’ 트리거 사용).

  3. 해당 login.html 파일에 사용자를 게시된 IFA 흐름( URL )으로 리디렉션하는 인라인을 <script> 추가하세요.
    예:
    <script>
  window.location.href = "https://<tenant>/v1.0/flows/<flowID>/start";
</script>
  4. 테마 폴더를 원래 구조대로 다시 압축하십시오.
  5. 브랜딩 API를 사용하여 업데이트된 테마를 업로드하세요:
    curl -X PUT 'https://<tenant>/v1.0/branding/themes/<themeID>' \
  --header 'Content-Type: multipart/form-data' \
  -F 'configuration=@themeConfiguration.json' \
  -F 'files=@updatedTheme.zip' \
  -H 'Authorization: Bearer <access_token>'
  6. 테마가 업로드되면:
    1. 관리 테넌트에서 ‘애플리케이션 > 애플리케이션 ’으로 이동합니다.
    2. IFA 흐름을 사용해야 하는 애플리케이션을 실행합니다.
    3. 앱 설정에서 ‘테마’ 항목으로 이동하세요.
    4. 업데이트된 테마를 선택하세요.
  7. 테마가 IFA 흐름으로 리디렉션되는지 확인해 보세요.
    그렇지 않다면 스크립트의 위치를 다시 한 번 확인하고, 올바른 흐름 트리거 URL 가 추가되었는지 확인하십시오.

결과

테마에 IFA(Identifier-First Authentication) 흐름을 할당하는 작업을 완료했습니다.

다음에 수행할 작업

초대 워크플로를 구성합니다. ‘초대 워크플로 설정 ’을 참조하세요.