PAYATHON 2026

如何仅允许开发团队访问 GCP 开发环境 URL

技术老齐

结论

如果开发人员需要直接通过浏览器访问 dev.moocapps.com,可以采用以下方案:

  1. 在两个 Cloud Run 服务前配置 External Application Load Balancer。
  2. 通过 URL map 将 / 转发到 front-end,将 /api/* 转发到 back-end。
  3. 在对应的 backend service 上启用 Identity-Aware Proxy(IAP)。
  4. 将 IAP-secured Web App User 权限授予开发团队的 Google Group。
  5. 将 Cloud Run 的 ingress 限制为 Internal and Cloud Load Balancing,防止用户绕过 IAP 访问 run.app 地址。

开发人员访问网站时需要先登录 Google 账号。授权账号可以进入,未授权请求会返回 403。

Cloud Run 的 Require authentication 不会自动向普通浏览器提供登录页面。启用该选项后,请求必须携带 Google 签发的 ID token,因此直接打开 URL 会看到:

Error: Forbidden

Your client does not have permission to get URL / from this server

推荐的访问结构

Developer browser
       |
       | HTTPS + Google login
       v
dev.moocapps.com
External Application Load Balancer
       |
       +-- /api/*  -> back-end Cloud Run
       |
       +-- /*      -> front-end Cloud Run

浏览器最好通过同一个域名访问 API,例如:

const response = await fetch('/api/users');

前端浏览器无需直接请求公开的 https://backend-xxxxx.run.app 地址。改用同源路径后,前端页面和 API 可以共用 IAP 登录状态,也能减少跨域配置。

配置步骤

1. 为两个 Cloud Run 服务创建 serverless NEG

分别为 front-end 和 back-end 创建 serverless network endpoint group,再创建两个 load balancer backend service:

dev-frontend-backend
dev-api-backend

控制台更新后,具体界面和选项可能会变化,通常可以在以下位置配置:

Network services
  -> Load balancing
  -> Create load balancer
  -> Application Load Balancer
  -> Backend configuration
  -> Serverless network endpoint group

2. 配置 URL map

设置以下路径规则:

/api/*  -> dev-api-backend
/*      -> dev-frontend-backend

如果 back-end 不接收 /api 前缀,可以配置 URL rewrite,也可以让应用直接接受 /api/* 路径。

3. 将域名指向负载均衡器

为负载均衡器预留静态外部 IP,并把 DNS 记录指向该 IP:

dev.moocapps.com.  A  <LOAD_BALANCER_IP>

还需要为 dev.moocapps.com 配置 Google-managed certificate 或其他受支持的 TLS 证书。

4. 启用 IAP

在负载均衡器使用的 backend service 上启用 IAP。控制台可能会要求先配置 OAuth consent screen 或相关身份设置,按界面提示操作即可。

创建一个开发团队 Google Group,例如:

dev-team@example.com

将允许访问开发环境的人员加入该组,并向该组授予:

IAP-secured Web App User
roles/iap.httpsResourceAccessor

可以在 IAP 页面为具体资源添加访问主体,也可以使用命令行。以下命令以全局 backend service 为例:

gcloud iap web add-iam-policy-binding \
  --resource-type=backend-services \
  --service=dev-frontend-backend \
  --member="group:dev-team@example.com" \
  --role="roles/iap.httpsResourceAccessor" \
  --project="PROJECT_ID"

back-end 对应的 backend service 同样需要授权:

gcloud iap web add-iam-policy-binding \
  --resource-type=backend-services \
  --service=dev-api-backend \
  --member="group:dev-team@example.com" \
  --role="roles/iap.httpsResourceAccessor" \
  --project="PROJECT_ID"

如果两个服务使用同一套 IAP 策略,可以根据实际资源层级统一管理权限。权限最好授予 Google Group,避免逐个添加用户。

5. 防止绕过 IAP

如果 Cloud Run 的默认 run.app URL 仍然可以公开访问,用户就能绕过 dev.moocapps.com 和 IAP。

将两个服务的 ingress 设置为只接受内部流量以及来自 Cloud Load Balancing 的流量:

gcloud run services update FRONTEND_SERVICE \
  --region="REGION" \
  --ingress="internal-and-cloud-load-balancing" \
  --project="PROJECT_ID"
gcloud run services update BACKEND_SERVICE \
  --region="REGION" \
  --ingress="internal-and-cloud-load-balancing" \
  --project="PROJECT_ID"

还要检查 Cloud Run IAM 策略,删除开发服务不需要的公开调用权限:

gcloud run services get-iam-policy FRONTEND_SERVICE \
  --region="REGION" \
  --project="PROJECT_ID"

重点检查是否有以下成员:

allUsers
allAuthenticatedUsers

移除这些权限会改变现有的访问方式,因此要先确认负载均衡器和 IAP 已经可以正常调用服务。

front-end 调用 back-end 的两种情况

浏览器直接调用 back-end

React、Vue 等前端代码在用户浏览器中运行时,API 请求由浏览器发出,不经过 front-end Cloud Run 服务。

此时建议让 API 使用同一个域名:

const response = await fetch('/api/orders', {
  credentials: 'include',
});

负载均衡器会把 /api/* 转发到 back-end,IAP 可以用同一套认证保护页面和 API。

如果改用 api-dev.moocapps.com 等独立域名,就需要分别处理 IAP、Cookie、CORS 和前端请求地址,配置会更复杂。

front-end 服务端调用 back-end

如果请求由 front-end Cloud Run 服务端发出,例如 SSR、BFF 或反向代理,应使用独立的 service account 完成服务间认证:

  1. 为 front-end Cloud Run 指定专用 service account。
  2. 向该 service account 授予 back-end Cloud Run 的 roles/run.invoker。
  3. 由 front-end 获取目标为 back-end URL 的 ID token。
  4. 使用 Authorization: Bearer <ID_TOKEN> 调用 back-end。

授权示例:

gcloud run services add-iam-policy-binding BACKEND_SERVICE \
  --region="REGION" \
  --member="serviceAccount:frontend-runtime@PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/run.invoker" \
  --project="PROJECT_ID"

Node.js 调用示例:

import { GoogleAuth } from 'google-auth-library';

const backendUrl = process.env.BACKEND_URL;

const auth = new GoogleAuth();
const client = await auth.getIdTokenClient(backendUrl);

const response = await client.request({
  url: `${backendUrl}/api/orders`,
  method: 'GET',
});

BACKEND_URL 应填写 back-end 服务的 HTTPS URL。ID token 的 audience 必须与 back-end 接受的目标一致,不能随意填写 front-end 域名。

为什么会出现 403

启用 Cloud Run 的 Require authentication 后,请求至少要符合两个条件:

  • 请求中包含有效的 Google ID token。
  • token 对应的身份拥有该 Cloud Run 服务的 roles/run.invoker 权限。

用户在地址栏中直接输入 Cloud Run URL 时,浏览器通常不会自动生成并附加这种 token。因此,用户即使已经登录 Google 账号,也可能收到 403。IAP 可以提供浏览器登录流程,并在负载均衡器入口检查用户身份和权限。

更简单但适用范围有限的办法

如果开发人员只是偶尔查看服务,不需要像普通网站一样直接访问 dev.moocapps.com,可以保留 Cloud Run 身份验证,并让每个人使用本地代理:

gcloud run services proxy FRONTEND_SERVICE \
  --region="REGION" \
  --project="PROJECT_ID"

然后访问:

http://localhost:8080

开发人员仍需拥有 roles/run.invoker,并通过 gcloud auth login 登录。这种方式不需要部署负载均衡器,但不适合团队日常共用开发网址,也无法完整测试自定义域名、HTTPS Cookie、OAuth 回调等功能。

注意事项

  • IAP 只保护负载均衡器入口。Cloud Run ingress 也要受到限制,否则用户仍可绕过 IAP。
  • front-end 和 back-end 应分别使用不同的 service account,并按最小权限原则授权。
  • 数据库信息、Stripe secret key 和 service account 密钥不能放入浏览器端代码。
  • Stripe webhook 等第三方回调无法使用开发人员的 Google 登录。如果 back-end 需要接收 webhook,应单独建立入口,并在应用层验证 Stripe 签名。
  • 如果团队成员使用的不是 Google Workspace 账号,需要确认这些账号可以加入相应的 Google Group,并符合组织的 IAP 策略。
  • 生产环境与开发环境应分别配置 IAP、IAM、service account 和 secret,避免开发权限影响生产服务。

备注:内容仅供参考。