为主题分配标识符优先身份验证(IFA)

在流程设计器中发布“标识符优先身份验证”(IFA)流程后,您必须更新所需的主题,以自定义登录体验并启用该流程。

准备工作

关于此任务

template/authentication/login/identity sources/identity source selection/combined_login_selection.html通过更新以下 HTML 页面,更新您想要的主题以自定义登录体验:。

“Verify”品牌功能支持修改主题的 HTML 文件,并允许在代码中直接使用 ` JavaScript, `,因此您可以添加脚本,直接从登录页面启动 IFA 流程。 theme.zip主题包的更新流程包括:下载主题包、编辑其中的文件,然后通过品牌 API 重新上传该 .zip 文件。

过程

  1. 下载您当前使用的主题。

    主题可通过“验证”界面或品牌 API 进行更新。

    使用“验证”界面
    如果您已经拥有一个包含 IFA 重定向脚本的主题(通过 API 更新或由您的开发团队创建),您可以直接在用户界面中将其分配给您的应用程序。
    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 文件中,添加一个内联 <script> 链接,将用户重定向至您已发布的 IFA 流程 URL。
    例如:
    <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)流程分配给主题的操作。

后续操作

配置邀请工作流。 请参阅“ 设置邀请工作流 ”。