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

Access 自定义拦截页面

最后更新 查看 MarkdownAgent 设置

您可以自定义当用户未能通过 Access 应用程序身份验证时显示的拦截页面。每个应用程序可以有不同的拦截页面。

拦截页面类型

Cloudflare Access 提供三种不同的拦截页面选项:

  • Default(默认):显示 Cloudflare 品牌的拦截页面。
  • Custom Redirect URL - 将被拦截的请求重定向到指定 URL。例如,您可以将用户重定向到一个动态 Access Denied 页面 ↗,该页面会获取用户身份并显示被拦截的确切原因。
  • Custom Page Template(自定义页面模板) -(仅在按量付费和企业计划中可用)显示由 Cloudflare 托管的自定义 HTML 页面。

自定义重定向 URL 参数

当 Access 将被拦截的请求重定向到您的 Custom Redirect URL 时,会附带以下查询参数:

参数 描述
kid 应用程序的 audience (AUD) 标签。
account_id 拥有该应用程序的 Cloudflare 账户 ID。账户上下文不可用时会省略。
original_url 所请求的主机名和路径,包括任何查询字符串。请求状态可用时会包含此参数。

例如,对 app.example.com/admin 的请求可以重定向到:

https://denied.example.com/?kid=<APP_AUD>&account_id=<ACCOUNT_ID>&original_url=app.example.com%2Fadmin

通过 account_id 在使用 Access 应用程序 API 查找应用程序时识别账户。将 kid 与应用程序的 AUD 标签匹配,而不是与应用程序 ID 匹配。

这些参数为您的拦截页面提供上下文。不要将它们用作身份验证或授权的证明:访问者可以修改 URL 查询参数。

基于身份与非基于身份

您可以向未通过基于身份的策略的用户与未通过非身份策略的用户分别显示不同类型的拦截页面。

  • 基于身份的拦截页面:当用户在登录到其身份提供商后,被基于身份的 Access 策略(如电子邮件、用户组或外部评估规则)拦截时显示。
  • 非基于身份的拦截页面:当用户被非身份 Access 策略(如国家/地区、IP 或设备态势)拦截时显示。Cloudflare 在提示用户登录之前会检查非身份属性。

创建自定义拦截页面

要为 Access 创建自定义拦截页面:

  1. 在 Cloudflare 仪表板 ↗中,前往 Zero Trust > Reusable components(可重用组件) > Custom pages(自定义页面)。

  2. 找到 Access Custom Pages(Access 自定义页面) 设置,然后选择 Manage(管理)。

  3. 选择 Add a page template(添加页面模板)。

  4. 为拦截页面输入唯一名称。

  5. 在 Type 中,选择这是基于身份还是非基于身份的拦截页面。

  6. 在 Custom HTML 中,输入自定义页面的 HTML 代码。例如:

    <!doctype html>
    <html>
    	<body>
    		<h1>Access denied.</h1>
    
    		<p>To obtain access, contact your IT administrator.</p>
    	</body>
    </html>
  7. 要检查自定义页面的外观,请选择 Download(下载) 并在浏览器中打开 HTML 文件。

  8. 对自定义页面满意后,选择 Save(保存)。

您现在可以在配置 Access 应用程序时选择此拦截页面。

这篇文档对您有帮助吗?