For the complete documentation index, see llms.txt. This page is also available as Markdown.

通过 JWT 为 impact.com 微站设置 SSO

您的 Advocate 项目微站通常要求您的客户倡导者先使用用户名和密码注册,之后才能访问他们的分享链接和奖励详情。不过,作为一种更高级的替代方案,您也可以通过生成一个 JSON Web 令牌(JWT) 在服务器端生成,并通过 URL 参数传递给微站。

使用此方法,参与者将不会拥有微站的登录凭据。相反,他们通过登录您现有的客户门户获得访问权限,然后客户门户会使用 JWT 将他们重定向到微站,以识别他们并显示其个性化内容。

在开始之前

仅当以下所有条件都适用时,您才应使用此方法:

  • 您希望通过自动将参与者登录到您的项目微站来模拟单点登录(SSO)体验。

  • 您可以在服务器端生成 JWT。

  • 您无法或不想安装 Universal Tracking Tag (UTT) 到您的网站上。

1

步骤 1:创建一个不使用托管身份的微站

当您创建微站时,您需要关闭托管身份服务,然后将所有页面设置为“未验证”用户可访问。该 仪表板 页面将使用 JWT 对用户进行身份验证并加载微站。

创建微站

首先,调整设置以关闭 参与者登录 选项。

  1. 从左侧导航菜单中,选择 [Engage] → 内容.

  2. 微站点 卡片中,选择 编辑设置.

  3. 然后,您将被重定向到您的新 微站设置 页面。

  4. 登录 部分, [关闭] 参与者登录.

  5. 选择 保存设置.

配置仪表板页面

接下来,配置您的微站的 仪表板 页面对未验证用户可见。然后,将页面上的组件与您的推荐计划连接,以便显示正确的信息。

  1. 调整您网站的 仪表板 页面设置。

    • 从左侧导航菜单中,选择 [Engage] → 内容设置内容编辑内容.

    • 微站点 选项卡,选择 仪表板登录后布局 部分。

    • 选择 [菜单] → 设置.

    • 允许的用户 下拉列表中,选择 未验证.

  2. 将您的项目 ID 添加到页面上的组件中 仪表板.

    • 用户统计 — 您必须将 ID 添加到您选择显示的每一项单独用户统计数据中。

    • 分享链接

    • 推荐码

    • 社交媒体按钮 — 您必须将 ID 添加到您选择包含的每一个单独社交媒体分享按钮中。

  3. 在右上角,选择 保存.

有关使用编辑器查找并调整页面和组件设置的帮助,请参阅 微站点编辑器说明自定义微站布局和页面.

删除不必要的页面

删除微站不会使用的布局和页面。

  1. 将光标悬停在页面或布局上。

  2. 选择 [更多] → 删除.

  3. 删除 登录后布局.

  4. 删除以下页面:

    • 编辑资料

    • 邮箱验证

    • 忘记密码

    • 登录

    • 退出登录

    • 注册

    • 重置密码

    • 验证邮箱

2

步骤 2:生成 JWT

JWT 结构遵循 Advocate 的标准用户身份验证要求。如果您以前集成过 Advocate,您很可能已经在为 UTT 生成类似的令牌。

您必须在服务器或任何受信任的后端系统上安全地生成 JWT——绝不能在浏览器中生成。

3

步骤 3:将 JWT 附加到微站 URL

用户登录您的平台后,将其重定向到微站,并在 URL 查询字符串中包含 JWT。

示例: https://your-microsite.squatch.app/?jwt=<YOUR_GENERATED_JWT>

您可以在新的浏览器标签页中打开微站,也可以使用 iframe 将微站嵌入您的应用中。如果您决定嵌入微站,请确保您处理 跨域资源共享(CORS) 以及浏览器限制。

备注

  • 如果您使用此身份验证方法,用户将没有微站的登录凭据。

  • 基于 JWT 的访问必须严格控制。不要在客户端 JavaScript 中暴露或操作它。

  • 这是一种非标准方法——在向您的项目正式上线前,请在预发布环境中彻底测试。

  • 如果您需要 支持,请在您的支持请求中包含您的微站 URL、实现细节以及一个示例 JWT 有效载荷。

最后更新于

这有帮助吗?