在飞连代理模式下，如果您需要针对 Web 类应用执行精细管控（识别并校验 HTTP/HTTPS 请求中的具体 URI 路径及动作接口），必须先在管理后台定义该应用及其关联的 URL 资源路径。

本文将指导您如何在代理模式下，为精细管控策略添加并管理 Web 应用资源。

前提条件 #

• 请确保您已参考接入代理网关，在零信任接入 > 接入网关 > 代理网关页面成功部署代理网关节点并配置所属集群，且目标集群中至少有一个正常运行的节点。
• 请确保目标 Web 应用已在企业内网正常运行。
• 请确保飞连客户端版本已升级 3.3.21 及以上版本。

添加 Web 应用资源 #

添加 Web 应用资源分为“创建应用”与“定义受控资源”两个阶段。

第一步：创建 Web 应用 #

1. 登录飞连管理后台。
2. 在左侧导航栏，选择零信任接入 > 应用管理 > Web 应用。
3. 在页面顶部，切换至客户端访问页签。
4. 单击页面右上角的 + 创建应用。
   
5. 在配置页面中，重点完成以下设置，并点击确定。
   
   

   配置项	说明
   应用名称	自定义易于识别的应用名称。
   应用地址	配置目标应用在内网环境下的真实服务地址。 协议：选择应用的服务协议（http 或 https）。 地址与端口：输入应用所在的服务器 IP 或域名，以及对应的服务端口号。 说明 若协议选择为 https，飞连网关需要对加密流量进行解密才可识别具体的 URL 路径。若未配置特定证书，系统将默认使用全局“企业自签根证书”进行解密验证。请确保已在企业设置 > 证书管理中配置了合规的 SSL 证书，或确保所有访问终端已安装并信任飞连全局根证书，否则员工在访问时浏览器会弹出安全告警。
   应用描述	选填，简要说明应用的业务用途，方便后续维护识别。
   标签	为应用关联逻辑分组标识。通过标签维度，您可以在策略配置中实现跨应用的批量授权。
   生效接入点	指定该应用发布的目标代理网关集群，支持选择全部集群或部分集群，不支持单独选择网关节点。 全部集群：将应用发布到全部代理网关集群。 部分集群：将应用发布到指定的代理网关集群。 Web 应用的生效集群范围必须包含在对应代理应用的生效集群范围内。若某个集群不在对应代理应用的生效范围内，精细管控策略将无法在该集群上生效。 应用发布到集群后，配置将下发至集群内的所有节点。新节点加入集群后，自动继承该集群已发布的应用；节点移出集群后，自动移除从该集群继承的应用发布关系。
   XFF 传递	控制网关如何向后端透传客户端真实 IP。通过处理 HTTP 请求头中的 X-Forwarded-For 字段，实现客户端 IP 的传递与溯源。 透传：网关不对 X-Forwarded-For 做任何修改，保持请求原始内容转发至后端。适用于上游已有可信代理（如 CDN、WAF）负责写入 XFF 的场景。 追加：将与网关直接建立连接的客户端 IP 追加到 X-Forwarded-For 末尾，若请求中无该头部则自动创建。适用于需要保留完整代理链信息并满足审计溯源需求的场景。 覆盖：使用与网关直接建立连接的客户端 IP 替换 X-Forwarded-For 的全部内容，原有值将被丢弃。适用于不信任上游 XFF 内容（如防止客户端伪造 XFF）的场景。

第二步：定义受控资源（URL 路径/接口） #

应用创建完成后，您需要进入应用详情页定义具体的管控资源范围。

1. 在 Web 应用列表页的客户端访问页签下，点击目标应用名称进入详情页。
2. 在页面下方的资源管理区域，点击右侧 + 添加资源。
   
3. 在弹出的添加资源窗口中，定义该应用下需要实施精细化访问控制的应用资源。
   • 资源名称：为该组路径定义名称，如“核心管理接口”。
   • 资源路径：输入具体的 URL 或 URI 路径。
     • 支持精确路径：如 /admin/login。
     • 支持通配符路径：使用 * 匹配目录下所有资源，如 /api/v1/*。
   • 继续添加：若需定义多个资源路径，可点击 + 继续添加。
   • 删除：点击路径右侧的删除可移除对应的配置行。
4. 点击确定完成应用资源定义。

管理 Web 应用 #

在 Web 应用列表页的客户端访问页签下，您可以对已定义的资源进行维护。

• 编辑：点击进入目标应用详情，修改应用的基础信息、生效接入点或资源路径等。修改生效接入点时，仅支持选择代理网关集群，且所选集群范围必须包含在对应代理应用的生效集群范围内。
• 删除：移除不再使用的 Web 应用资源。删除前请确保该资源未被任何精细管控策略引用。

应用发布到集群的配置变更记录可在日志审计的管理员操作日志中查看。

后续操作 #

完成 Web 应用资源的定义后，您需前往零信任接入 > 代理策略 > 精细管控策略页签配置具体的授权规则，详情参看配置代理模式精细管控策略。