跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

authentik (SAML)

最后更新 查看 MarkdownAgent 设置

使用安全断言标记语言 (SAML) 2.0 将 authentik 连接到 Cloudflare Access。

先决条件

  • 具有管理员访问权限的 authentik 账户
  • 具有 Zero Trust 访问权限的 Cloudflare 账户
  • 可公开访问且具有受信任 TLS 证书的 authentik 部署

1. 在 authentik 中创建应用

Cloudflare Access 团队名称是断言使用者服务 (ACS) URL 的一部分。配置 authentik 之前,请先找到团队名称。

您可以在 Cloudflare 仪表板 ↗ 的 Settings(设置)> Team name and domain(团队名称和域名)> Team name(团队名称) 下找到您的团队名称。

  1. 以管理员身份登录 authentik 并打开 Admin 界面。
  2. 前往 Applications > Applications 并选择 New Application。
  3. 输入应用详情,然后选择 Next。
  4. 对于提供商类型,选择 SAML Provider。
  5. 配置提供商:
    1. 输入提供商名称并选择授权流程。

    2. 对于 ACS URL,请输入:

      https://<YOUR_TEAM_NAME>.cloudflareaccess.com/cdn-cgi/access/callback
    3. 对于 Audience,请输入相同的 Cloudflare Access 回调 URL。

    4. 选择 Signing Certificate,并保持 Sign assertions 开启。

    5. 对于 Service Provider Binding,选择 Post。

    6. 对于 Default NameID Policy,选择 Email address。

  6. 选择 Create Application。

有关 authentik 提供商设置的更多信息,请参阅 Create a SAML provider ↗。

2. 获取 authentik 提供商详情

  1. 在 authentik Admin 界面中,前往 Applications > Providers。

  2. 选择你为 Cloudflare Access 创建的 SAML 提供商。

  3. 记录以下值。将 <AUTHENTIK_DOMAIN> 替换为你的 authentik 主机名,并将 <APPLICATION_SLUG> 替换为关联的应用 slug。

    Cloudflare 字段 authentik 值
    单点登录 URL https://<AUTHENTIK_DOMAIN>/application/saml/<APPLICATION_SLUG>/
    IdP 实体 ID 或颁发者 URL https://<AUTHENTIK_DOMAIN>/application/saml/<APPLICATION_SLUG>/metadata/
  4. 在 Download signing certificate 下,选择 Download。保存证书以供 Cloudflare 配置使用。

元数据选项卡还包含 SAML 端点、实体 ID 和签名证书。有关详情,请参阅 SAML Provider ↗。

3. 将 authentik 添加到 Cloudflare Access

  1. 在 Cloudflare Zero Trust 中,前往 Integrations > Identity providers。

    前往 Identity providers(身份提供商) ↗
  2. 选择 Add new identity provider > SAML。

  3. 输入身份提供商名称。

  4. 输入 authentik 中的 Single Sign-On URL 和 IdP Entity ID or Issuer URL。

  5. 对于 Signing certificate,粘贴从 authentik 下载的证书。

  6. 选择 Save(保存)。

4. 测试集成

  1. 在 Cloudflare Zero Trust 中,前往 Integrations > Identity providers。

    前往 Identity providers(身份提供商) ↗
  2. 找到 authentik 身份提供商并选择 Test。

  3. 完成 authentik 登录流程。

  4. 确认 Cloudflare 显示测试成功,并显示预期邮箱地址。

这篇文档对您有帮助吗?