在流程设计器中发布“标识符优先身份验证”(IFA)流程后,您必须更新所需的主题,以自定义登录体验并启用该流程。
关于此任务
template/authentication/login/identity sources/identity source selection/combined_login_selection.html通过更新以下 HTML 页面,更新您想要的主题以自定义登录体验:。
“Verify”品牌功能支持修改主题的 HTML 文件,并允许在代码中直接使用 ` JavaScript, `,因此您可以添加脚本,直接从登录页面启动 IFA 流程。 theme.zip主题包的更新流程包括:下载主题包、编辑其中的文件,然后通过品牌 API 重新上传该 .zip 文件。
过程
- 下载您当前使用的主题。
主题可通过“验证”界面或品牌 API 进行更新。
- 使用“验证”界面
- 如果您已经拥有一个包含 IFA 重定向脚本的主题(通过 API 更新或由您的开发团队创建),您可以直接在用户界面中将其分配给您的应用程序。
- 转到 ”。
- 点击 “创建自定义主题 ”。
- 点击 “下载主模板文件 ”,然后将 .zip 文件解压到本地。
这些文件包含您将要自定义的登录模板。
- 添加启动 IFA 流程的 JavaScript。
在相应的登录模板中,添加
<script> window.location.href = "https://<tenant>/v1.0/flows/<flowID>/start"; </script>
.
- 将自定义的模板文件重新打包。
注意: 请保持文件夹结构不变,并将根目录打包为压缩文件。
- 回到窗口中,点击 “上传文件 ”,然后选择您的 .zip 文件。
- 输入主题名称,然后点击 “创建主题 ”。
- 申请主题包:
GET https://<tenant>/v1.0/branding/themes/<themeID>
. 请包含一个有效的访问令牌。 该主题将以一个
.zip 包含所有主题模板的文件形式下载。
- 请将 .zip 文件解压到本地,以便查看和编辑模板。
- 在解压后的文件夹中,找到登录页面模板。
路径名称因主题而异,但登录模板通常位于:
/templates/authentication/login/cloud_directory/default/login.html
/templates/authentication/login/saml/default/login.html
/templates/authentication/login/oidc/default/login.html
修改登录模板,将用户重定向至您已发布的 IFA 流程(使用 《配置标识符优先身份验证 》中的触发器 URL )。
- 在该 login.html 文件中,添加一个内联
<script> 链接,将用户重定向至您已发布的 IFA 流程 URL。
例如:
<script>
window.location.href = "https://<tenant>/v1.0/flows/<flowID>/start";
</script>
- 将主题文件夹按原布局重新打包。
- 使用品牌 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>'
- 当主题上传时:
- 在管理租户中,导航至 。
- 打开需要使用 IFA 流程的应用程序。
- 请前往应用程序设置中的 “主题 ”字段。
- 选择更新后的主题。
- 测试您的主题是否会重定向至 IFA 流程。
如果未生效,请重新检查脚本的位置,并确保已添加正确的流程触发器 URL。
结果
您已完成将“标识符优先身份验证”(IFA)流程分配给主题的操作。
后续操作
配置邀请工作流。 请参阅“ 设置邀请工作流 ”。