Đơn giản hoá quy trình xác thực giữa các dịch vụ Cloud Run bằng Express Link

1. Tổng quan

Khi bạn xây dựng các ứng dụng vi dịch vụ hoặc đa tác nhân trên Cloud Run, các dịch vụ phụ trợ nội bộ không được mở cho Internet công cộng. Thay vào đó, bạn định cấu hình từng dịch vụ phụ trợ để yêu cầu xác thực (--no-allow-unauthenticated) và chỉ cấp vai trò IAM Người gọi Cloud Run (roles/run.invoker) cho những người gọi được uỷ quyền.

Thông thường, để gọi một dịch vụ Cloud Run đã xác thực, ứng dụng gọi của bạn phải thực hiện việc chèn mã thông báo theo cách thủ công trong mã. Trước khi gửi yêu cầu HTTP, mã của bạn sẽ truy vấn Máy chủ siêu dữ liệu Compute để lấy mã thông báo nhận dạng OpenID Connect (OIDC) do Google ký. Mã thông báo đó được đặt trong phạm vi URL đối tượng của dịch vụ đích và mã của bạn sẽ đính kèm mã thông báo đó vào tiêu đề Authorization: Bearer. Việc viết và duy trì quy trình xác thực trong mã xử lý ứng dụng gây ra những trở ngại không cần thiết:

  • Phương pháp này kết hợp logic kinh doanh của bạn với các thư viện xác thực của Google Cloud, làm giảm khả năng đọc và tính di động trên các môi trường.
  • Logic thu nạp mã thông báo sẽ khác nhau tuỳ theo loại đích đến và chế độ bảo mật. Ví dụ: Cloud Run yêu cầu mã thông báo nhận dạng OIDC, API của Google yêu cầu mã truy cập OAuth 2.0 và mTLS yêu cầu mã thông báo ràng buộc.

Cloud Run Express Link (Bản dùng thử) loại bỏ việc chèn mã thông báo theo cách thủ công khỏi mã xử lý ứng dụng. Bạn bật Ambient Networking trên dịch vụ Cloud Run gọi (nguồn) và tạo một tài nguyên ExpressLink khai báo để liên kết dịch vụ nguồn với dịch vụ đích. Proxy sidecar do Google quản lý sẽ chặn các yêu cầu HTTP dạng văn bản thuần tuý gửi đến đích, tự động chèn mã thông báo nhận dạng của dịch vụ gọi và mã hoá kết nối đến đích.

Trong lớp học lập trình này, bạn sẽ so sánh cả hai phương pháp với cùng một dịch vụ phụ trợ riêng tư:

  1. Triển khai một dịch vụ đích riêng tư và một dịch vụ gọi (caller-oidc) tìm nạp mã thông báo mã nhận dạng OIDC từ Máy chủ siêu dữ liệu Compute trong Python. Bước này xác nhận khả năng kết nối hai đầu với phần phụ trợ và cho thấy mã xác thực cần thiết mà không cần Express Link.
  2. Triển khai dịch vụ gọi thứ hai (caller-express-link) đã xoá mã tìm nạp mã thông báo siêu dữ liệu, rồi kết nối dịch vụ đó với dịch vụ đích bằng Ambient Networking và Express Link.
PART 1: WITHOUT EXPRESS LINK (caller-oidc)
+----------------------------------------------+          +-----------------+
| Caller Service (caller-oidc)                 |  HTTPS   | Destination     |
|                                              | + token  | (destination)   |
|  App Container                               | -------> |                 |
|   1. Parse audience URL with urllib.parse    |          | Verifies caller |
|   2. Fetch OIDC ID token via google-auth     |          | has IAM role    |
|   3. Set Authorization: Bearer header        |          | run.invoker     |
+----------------------------------------------+          +-----------------+

PART 2: WITH EXPRESS LINK (caller-express-link)
+----------------------------------------------+          +-----------------+
| Caller Service (caller-express-link)         |  HTTPS   | Destination     |
|  +----------------+      +----------------+  | + token  | (destination)   |
|  | App Container  | HTTP | Ambient        |  | -------> |                 |
|  | requests.get() | ---> | Sidecar Proxy  |  |          | Same service    |
|  | (no auth code) |      | (Express Link) |  |          | as Part 1       |
|  +----------------+      +----------------+  |          | (unchanged)     |
+----------------------------------------------+          +-----------------+

Điều kiện tiên quyết

  • Hiểu biết cơ bản về Python và dịch vụ web HTTP
  • Quen thuộc cơ bản với tài khoản dịch vụ Google Cloud IAM và hoạt động triển khai Cloud Run

Kiến thức bạn sẽ học được

  • Cách triển khai một dịch vụ đích riêng tư trên Cloud Run để thực thi quy trình xác thực IAM
  • Cách xác thực thủ công các yêu cầu giữa các dịch vụ trong Python bằng mã thông báo nhận dạng OIDC google-auth từ máy chủ siêu dữ liệu để xác minh khả năng kết nối cơ sở
  • Cách xoá mã tìm nạp mã thông báo theo cách thủ công và triển khai dịch vụ gọi Cloud Run khi bật Ambient Networking
  • Cách tạo một Đường liên kết nhanh Cloud Run để dịch vụ gọi của bạn có thể gọi một dịch vụ đích đã xác thực mà không cần mã xác thực

Sản phẩm bạn sẽ tạo ra

  • destination: Một dịch vụ Python Flask riêng tư trên Cloud Run hiển thị điểm cuối /ping
  • caller-oidc: Một dịch vụ Python Flask gọi destination bằng cách tìm nạp và chèn mã thông báo nhận dạng OIDC theo cách thủ công trong mã xử lý ứng dụng
  • caller-express-link: Một dịch vụ Python Flask song song không có mã chèn mã thông báo, gọi cùng một dịch vụ destination thông qua Express Link

Bạn cần có

  • Một trình duyệt web, chẳng hạn như Chrome
  • Một dự án trên đám mây của Google Cloud đã bật tính năng thanh toán và có quyền tạo tài khoản dịch vụ IAM, dịch vụ Cloud Run và tài nguyên Dịch vụ mạng

2. Thiết lập môi trường

Thiết lập dự án trên đám mây của Google

  1. Nếu chưa có Tài khoản Google, bạn phải tạo một Tài khoản Google.
    • Sử dụng tài khoản cá nhân thay vì tài khoản công việc hoặc trường học. Tài khoản công việc và tài khoản trường học có thể có các quy định hạn chế khiến bạn không thể bật các API cần thiết cho bài thực hành này.
  2. Đăng nhập vào Google Cloud Console.
  3. Bật tính năng thanh toán trong Cloud Console.
    • Bạn sẽ mất chưa đến 1 USD tài nguyên trên Cloud để hoàn thành bài thực hành này.
    • Bạn có thể làm theo các bước ở cuối bài thực hành này để xoá tài nguyên nhằm tránh bị tính thêm phí.
    • Người dùng mới đủ điều kiện nhận khoản tín dụng dùng thử miễn phí trị giá 300 USD.
  4. Tạo dự án mới hoặc chọn sử dụng lại dự án hiện có.
    • Nếu bạn thấy lỗi về hạn mức dự án, hãy sử dụng lại một dự án hiện có hoặc xoá một dự án hiện có để tạo dự án mới.

Bắt đầu Cloud Shell

Trong lớp học lập trình này, bạn sẽ sử dụng Cloud Shell, một môi trường dòng lệnh dựa trên trình duyệt được cài đặt sẵn Google Cloud CLI (gcloud), Python và curl.

  1. Trong Google Cloud Console, hãy nhấp vào Kích hoạt Cloud Shell trên thanh điều hướng trên cùng. Nếu được nhắc, hãy nhấp vào Uỷ quyền.
  2. Xuất mã dự án và khu vực triển khai, đồng thời định cấu hình gcloud để sử dụng $PROJECT_ID. Thay thế YOUR_PROJECT_ID bằng mã dự án của bạn và tuỳ ý thay thế us-west1 bằng một khu vực Cloud Run khác:
export PROJECT_ID="YOUR_PROJECT_ID"
export REGION="us-west1"
gcloud config set project "$PROJECT_ID"
  1. Xuất số dự án và tài khoản Google Cloud đang hoạt động, đồng thời xác nhận rằng cả 4 biến đều được điền sẵn:
export PROJECT_NUMBER=$(gcloud projects describe "$PROJECT_ID" --format="value(projectNumber)")
export ACTIVE_ACCOUNT=$(gcloud config get-value account 2>/dev/null)
echo "PROJECT_ID: $PROJECT_ID | PROJECT_NUMBER: $PROJECT_NUMBER | ACCOUNT: $ACTIVE_ACCOUNT | REGION: $REGION"

Cập nhật gcloud và bật API

  1. Cập nhật các thành phần gcloud để có các lệnh beta mới nhất cho Ambient Networking và Express Link:
gcloud components update --quiet
  1. Bật các Cloud APIs của Google Cloud cần thiết cho việc triển khai nguồn Cloud Run, tài khoản dịch vụ IAM, Ambient Networking và Network Services Express Link:
gcloud services enable \
    iam.googleapis.com \
    run.googleapis.com \
    cloudbuild.googleapis.com \
    artifactregistry.googleapis.com \
    networkservices.googleapis.com \
    networksecurity.googleapis.com \
    trafficdirector.googleapis.com \
    cloudtrace.googleapis.com

Tạo thư mục không gian làm việc

Tạo một thư mục đang hoạt động để lưu giữ 3 thư mục dịch vụ mà bạn sẽ xây dựng trong lớp học lập trình này:

mkdir -p ~/express-link-codelab
cd ~/express-link-codelab

3. Triển khai dịch vụ đích đến riêng tư

Trước tiên, bạn sẽ triển khai một dịch vụ Cloud Run riêng tư có tên là destination. Bạn sẽ sử dụng lại dịch vụ đích đến duy nhất này cho cả hai phần của lớp học lập trình:

  • Dịch vụ đích không bao giờ thực hiện chèn mã thông báo gửi đi.
  • Dịch vụ đích không cần bật Ambient Networking để nhận lưu lượng truy cập qua Express Link.
  1. Tạo một tài khoản dịch vụ IAM chuyên dụng cho dịch vụ đích:
gcloud iam service-accounts create destination-identity \
    --display-name="Cloud Run destination service account"
  1. Tạo thư mục destination rồi di chuyển vào thư mục đó:
mkdir -p ~/express-link-codelab/destination
cd ~/express-link-codelab/destination
  1. Chạy lệnh sau để tạo tệp requirements.txt bằng Flask và Gunicorn:
cat << 'EOF' > requirements.txt
Flask==3.0.0
gunicorn==21.2.0
EOF
  1. Chạy lệnh sau để tạo tệp main.py hiển thị điểm cuối /ping trả về tên dịch vụ Cloud Run từ biến môi trường K_SERVICE:
cat << 'EOF' > main.py
import os
from flask import Flask

app = Flask(__name__)

@app.route("/ping")
def ping():
    service_name = os.environ.get("K_SERVICE", "unknown")
    return f"Hello from {service_name}"

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=int(os.environ.get("PORT", 8080)))
EOF
  1. Triển khai destination từ nguồn bằng --no-allow-unauthenticated để Cloud Run từ chối các yêu cầu chưa được xác thực:
gcloud run deploy destination \
    --source . \
    --region="$REGION" \
    --service-account="destination-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --no-allow-unauthenticated
  1. Lưu trữ URL xác định của dịch vụ đích và URI tài nguyên đầy đủ trong các biến môi trường:
export DESTINATION_URL="https://destination-${PROJECT_NUMBER}.${REGION}.run.app"
export DESTINATION_URI="//run.googleapis.com/projects/${PROJECT_NUMBER}/locations/${REGION}/services/destination"
echo "DESTINATION_URL: $DESTINATION_URL"
echo "DESTINATION_URI: $DESTINATION_URI"
  1. Cấp cho tài khoản người dùng của bạn vai trò Người gọi Cloud Run (roles/run.invoker) trên destination để bạn có thể kiểm thử trực tiếp từ Cloud Shell:
gcloud run services add-iam-policy-binding destination \
    --member="user:$ACTIVE_ACCOUNT" \
    --role="roles/run.invoker" \
    --region="$REGION"
  1. Gửi yêu cầu đã xác thực đến /ping bằng mã thông báo nhận dạng của riêng bạn để xác nhận destination đang chạy:
TOKEN=$(gcloud auth print-identity-token)
curl -H "Authorization: Bearer $TOKEN" "$DESTINATION_URL/ping"

Bạn sẽ thấy phản hồi sau:

Hello from destination

4. Gọi đích đến mà không có Express Link

Trước khi giới thiệu Express Link, hãy tạo caller-oidc để xem những yêu cầu hiện tại đối với việc xác thực giữa các dịch vụ và xác minh rằng dịch vụ gọi có thể kết nối với destination. Để gọi destination một cách an toàn mà không cần Express Link, bạn phải định cấu hình hai lớp:

  • Uỷ quyền IAM: Cấp cho tài khoản dịch vụ caller-oidc vai trò roles/run.invoker trên destination.
  • Chèn mã thông báo ở cấp ứng dụng: Thêm thư viện google-auth vào caller-oidc và phân tích cú pháp URL mục tiêu để trích xuất đối tượng OIDC gốc. Sau đó, tìm nạp mã thông báo nhận dạng đã ký từ máy chủ siêu dữ liệu và đính kèm Authorization: Bearer ID_TOKEN vào yêu cầu HTTPS gửi đi.

Hãy làm theo các bước sau để định cấu hình và triển khai caller-oidc:

  1. Tạo một tài khoản dịch vụ chuyên biệt cho caller-oidc:
gcloud iam service-accounts create caller-oidc-identity \
    --display-name="Cloud Run OIDC caller service account"
  1. Uỷ quyền cho caller-oidc-identity gọi destination:
gcloud run services add-iam-policy-binding destination \
    --member="serviceAccount:caller-oidc-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --role="roles/run.invoker" \
    --region="$REGION"
  1. Tạo thư mục caller-oidc cùng với destination:
mkdir -p ~/express-link-codelab/caller-oidc
cd ~/express-link-codelab/caller-oidc
  1. Chạy lệnh sau để tạo tệp requirements.txt. Xin lưu ý rằng bạn phải thêm google-auth cụ thể để xử lý việc truy xuất mã thông báo trong vùng chứa ứng dụng:
cat << 'EOF' > requirements.txt
Flask==3.0.0
google-auth==2.23.0
requests==2.31.0
gunicorn==21.2.0
EOF
  1. Chạy lệnh sau để tạo tệp main.py có chèn mã thông báo OIDC theo cách thủ công:
cat << 'EOF' > main.py
import os
from urllib.parse import urlparse
from flask import Flask, request
from google.auth.transport.requests import Request as GoogleAuthRequest
from google.oauth2 import id_token
import requests

app = Flask(__name__)

@app.route("/ping")
def ping():
    service_name = os.environ.get("K_SERVICE", "unknown")
    return f"Hello from {service_name}"

@app.route("/")
def call_destination():
    target_url = request.args.get("target_url")
    if not target_url:
        return "Error: target_url query parameter not set.", 400

    try:
        # 1. Extract the root service URL (scheme + host) for the OIDC audience claim
        parsed_url = urlparse(target_url)
        target_audience = f"{parsed_url.scheme}://{parsed_url.netloc}"

        # 2. Fetch a Google-signed OIDC ID token from the metadata server
        auth_req = GoogleAuthRequest()
        token = id_token.fetch_id_token(auth_req, target_audience)

        # 3. Inject the token as an HTTP Bearer header
        headers = {"Authorization": f"Bearer {token}"}
        response = requests.get(target_url, headers=headers, timeout=10)
        return f"I called the destination and it replied: '{response.text}'"
    except Exception as e:
        return f"Error calling destination: {str(e)}", 500

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=int(os.environ.get("PORT", 8080)))
EOF
  1. Triển khai caller-oidc lên Cloud Run:
gcloud run deploy caller-oidc \
    --source . \
    --region="$REGION" \
    --service-account="caller-oidc-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --no-allow-unauthenticated
  1. Cấp cho tài khoản người dùng của bạn quyền gọi caller-oidc:
gcloud run services add-iam-policy-binding caller-oidc \
    --member="user:$ACTIVE_ACCOUNT" \
    --role="roles/run.invoker" \
    --region="$REGION"
  1. Lưu trữ URL tất định của caller-oidc và gọi URL đó, truyền URL loại HTTPS $DESTINATION_URL/ping dưới dạng target_url:
export CALLER_OIDC_URL="https://caller-oidc-${PROJECT_NUMBER}.${REGION}.run.app"
TOKEN=$(gcloud auth print-identity-token)
curl -H "Authorization: Bearer $TOKEN" "$CALLER_OIDC_URL/?target_url=$DESTINATION_URL/ping"

Bạn sẽ nhận được thư trả lời thành công từ destination:

I called the destination and it replied: 'Hello from destination'

5. Triển khai dịch vụ gọi điện cho Express Link

Bây giờ, bạn sẽ tạo một dịch vụ gọi thứ hai có tên là caller-express-link trong một thư mục đồng cấp. Với Express Link, caller-express-link không cần mã chèn mã thông báo mà gọi trực tiếp requests.get(target_url, timeout=10).

  1. Tạo một tài khoản dịch vụ chuyên biệt cho caller-express-link:
gcloud iam service-accounts create caller-express-link-identity \
    --display-name="Cloud Run Express Link caller service account"
  1. Cấp cho caller-express-link-identity vai trò roles/trafficdirector.client để tệp trợ giúp Ambient Networking được quản lý có thể tải cấu hình bảo mật và định tuyến Express Link xuống. Ngoài ra, hãy cấp quyền roles/cloudtrace.agent để tệp trợ giúp có thể xuất các span theo dõi:
gcloud projects add-iam-policy-binding "$PROJECT_ID" \
    --member="serviceAccount:caller-express-link-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --role="roles/trafficdirector.client"

gcloud projects add-iam-policy-binding "$PROJECT_ID" \
    --member="serviceAccount:caller-express-link-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"
  1. Tạo thư mục caller-express-link cùng với caller-oidc:
mkdir -p ~/express-link-codelab/caller-express-link
cd ~/express-link-codelab/caller-express-link
  1. Chạy lệnh sau để tạo tệp requirements.txt không có google-auth:
cat << 'EOF' > requirements.txt
Flask==3.0.0
requests==2.31.0
gunicorn==21.2.0
EOF
  1. Chạy lệnh sau để tạo tệp main.py bằng lệnh gọi requests.get(target_url, timeout=10) đơn giản và không có logic chèn mã thông báo:
cat << 'EOF' > main.py
import os
from flask import Flask, request
import requests

app = Flask(__name__)

@app.route("/ping")
def ping():
    service_name = os.environ.get("K_SERVICE", "unknown")
    return f"Hello from {service_name}"

@app.route("/")
def call_destination():
    target_url = request.args.get("target_url")
    if not target_url:
        return "Error: target_url query parameter not set.", 400

    try:
        response = requests.get(target_url, timeout=10)
        return f"I called the destination and it replied: '{response.text}'"
    except Exception as e:
        return f"Error calling destination: {str(e)}", 500

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=int(os.environ.get("PORT", 8080)))
EOF
  1. Chạy diff đối với ../caller-oidc/main.py để xem mã nguyên mẫu xác thực mà bạn đã loại bỏ:
diff -u ../caller-oidc/main.py main.py || true
  1. Triển khai caller-express-link bằng gcloud beta run deploy khi bật --ambient-networking và --ambient-scope=global:
gcloud beta run deploy caller-express-link \
    --source . \
    --region="$REGION" \
    --service-account="caller-express-link-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --no-allow-unauthenticated \
    --ambient-networking \
    --ambient-scope=global
  1. Xác minh rằng tính năng Kết nối mạng xung quanh đang hoạt động trên caller-express-link:
gcloud run services describe caller-express-link --region="$REGION"

Ở cuối bản tóm tắt nội dung sửa đổi, hãy xác minh rằng Ambient Networking và Ambient Scope xuất hiện:

  Ambient Networking: Enabled
  Ambient Scope:     global
  1. Cấp cho tài khoản người dùng của bạn quyền gọi caller-express-link và uỷ quyền cho caller-express-link-identity gọi destination:
gcloud run services add-iam-policy-binding caller-express-link \
    --member="user:$ACTIVE_ACCOUNT" \
    --role="roles/run.invoker" \
    --region="$REGION"

gcloud run services add-iam-policy-binding destination \
    --member="serviceAccount:caller-express-link-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --role="roles/run.invoker" \
    --region="$REGION"
  1. Lưu trữ URL và URI tài nguyên của caller-express-link, cùng với URL tất định HTTP (http://) của destination:
export CALLER_EL_URL="https://caller-express-link-${PROJECT_NUMBER}.${REGION}.run.app"
export CALLER_EL_URI="//run.googleapis.com/projects/${PROJECT_NUMBER}/locations/${REGION}/services/caller-express-link"
export DESTINATION_HTTP_URL="http://destination-${PROJECT_NUMBER}.${REGION}.run.app"
echo "CALLER_EL_URL: $CALLER_EL_URL"
echo "CALLER_EL_URI: $CALLER_EL_URI"
echo "DESTINATION_HTTP_URL: $DESTINATION_HTTP_URL"
  1. Kiểm thử việc gọi destination thông qua caller-express-link trước khi tạo Đường liên kết nhanh:
TOKEN=$(gcloud auth print-identity-token)
curl -H "Authorization: Bearer $TOKEN" "$CALLER_EL_URL/?target_url=$DESTINATION_HTTP_URL/ping"

Đúng như dự kiến, lệnh gọi không thành công với 403 Forbidden vì chưa có Express Link nào chặn yêu cầu và chèn thông tin xác thực:

I called the destination and it replied: '
<html><head>
<meta http-equiv="content-type" content="text/html;charset=utf-8">
<title>403 Forbidden</title>
</head>
<body text=#000000 bgcolor=#ffffff>
<h1>Error: Forbidden</h1>
<h2>Your client does not have permission to get URL <code>/ping</code> from this server.</h2>
<h2></h2>
</body></html>
'

6. Kết nối các dịch vụ bằng Đường liên kết nhanh

Bây giờ, bạn sẽ khai báo một tài nguyên ExpressLink kết nối caller-express-link (dịch vụ nguồn) với destination mà không cần thay đổi một dòng mã nào hoặc triển khai lại dịch vụ Cloud Run.

  1. Tạo tài nguyên Express Link ở vị trí global:
gcloud beta network-services express-links create caller-to-destination \
    --location=global \
    --description="Express Link from caller-express-link to destination" \
    --source-services="$CALLER_EL_URI" \
    --destination-services="$DESTINATION_URI"
  1. Liệt kê các Đường liên kết nhanh để xác nhận tài nguyên có tồn tại:
gcloud beta network-services express-links list --location=global

Kết quả của lệnh:

NAME
caller-to-destination
  1. Kiểm tra thông tin chi tiết về cấu hình Express Link:
gcloud beta network-services express-links describe caller-to-destination --location=global

Kết quả của lệnh:

createTime: '2026-10-27T19:30:04.492105068Z'
description: Express Link from caller-express-link to destination
destination:
  services:
  - //run.googleapis.com/projects/PROJECT_NUMBER/locations/us-west1/services/destination
etag: ...
name: projects/PROJECT_ID/locations/global/expressLinks/caller-to-destination
source:
  services:
  - //run.googleapis.com/projects/PROJECT_NUMBER/locations/us-west1/services/caller-express-link
updateTime: '2026-10-27T19:30:11.309054865Z'
  1. Chạy lại chính xác yêu cầu curl đó đối với caller-express-link:
TOKEN=$(gcloud auth print-identity-token)
curl -H "Authorization: Bearer $TOKEN" "$CALLER_EL_URL/?target_url=$DESTINATION_HTTP_URL/ping"

Lần này, tệp trợ giúp Ambient chặn yêu cầu HTTP đến destination, chèn mã thông báo nhận dạng cho caller-express-link-identity, nâng cấp kết nối lên TLS và trả về phản hồi của đích đến:

I called the destination and it replied: 'Hello from destination'

Bảng sau đây tóm tắt những điểm thay đổi giữa caller-oidc và caller-express-link:

Phương diện

Không có Express Link (caller-oidc)

Với Express Link (caller-express-link)

Thư viện xác thực trong requirements.txt

Yêu cầu phải có google-auth

Không có (chỉ Flask, requests, gunicorn)

Cuộc gọi đi bằng main.py

Phân tích cú pháp URL đối tượng, gọi id_token.fetch_id_token(), đính kèm tiêu đề Authorization: Bearer

requests.get(target_url, timeout=10) đơn giản

Lược đồ URL mục tiêu trong ứng dụng

https://destination-PROJECT_NUMBER.REGION.run.app

http://destination-PROJECT_NUMBER.REGION.run.app (được nâng cấp lên TLS bằng tệp trợ giúp Ambient)

Cấu hình Cloud Run của phương thức gọi

Triển khai tiêu chuẩn

--ambient-networking --ambient-scope=global + roles/trafficdirector.client trên tài khoản dịch vụ của phương thức gọi

Cấu hình Cloud Run đích

--no-allow-unauthenticated + roles/run.invoker

Không thay đổi (--no-allow-unauthenticated + roles/run.invoker)

7. Dọn dẹp

Để tránh bị tính phí liên tục vào tài khoản Google Cloud, hãy xoá các tài nguyên bạn đã tạo trong lớp học lập trình này.

  1. Xoá tài nguyên Express Link:
gcloud beta network-services express-links delete caller-to-destination --location=global --quiet
  1. Xoá 3 dịch vụ Cloud Run:
gcloud run services delete caller-express-link --region="$REGION" --quiet
gcloud run services delete caller-oidc --region="$REGION" --quiet
gcloud run services delete destination --region="$REGION" --quiet
  1. Xoá các liên kết chính sách IAM ở cấp dự án và xoá 3 tài khoản dịch vụ:
gcloud projects remove-iam-policy-binding "$PROJECT_ID" \
    --member="serviceAccount:caller-express-link-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --role="roles/trafficdirector.client" \
    --quiet

gcloud projects remove-iam-policy-binding "$PROJECT_ID" \
    --member="serviceAccount:caller-express-link-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent" \
    --quiet

gcloud iam service-accounts delete "caller-express-link-identity@${PROJECT_ID}.iam.gserviceaccount.com" --quiet
gcloud iam service-accounts delete "caller-oidc-identity@${PROJECT_ID}.iam.gserviceaccount.com" --quiet
gcloud iam service-accounts delete "destination-identity@${PROJECT_ID}.iam.gserviceaccount.com" --quiet
  1. (Không bắt buộc) Nếu đã tạo một dự án Google Cloud dành riêng cho lớp học lập trình này, bạn có thể xoá toàn bộ dự án:
# Run only if you want to delete the entire project and all its resources
gcloud projects delete "$PROJECT_ID"

8. Xin chúc mừng

Bạn đã triển khai một dịch vụ phụ trợ Cloud Run riêng tư và gọi dịch vụ đó bằng cách chèn mã thông báo OIDC theo cách thủ công trong Python. Sau đó, bạn đã thay thế tất cả mã xác thực ở cấp ứng dụng bằng Cloud Run Express Link mang tính khai báo.

Kiến thức bạn học được

  • Lý do việc chèn mã thông báo OIDC theo cách thủ công liên kết logic nghiệp vụ của ứng dụng với các thư viện xác thực và chế độ bảo mật của nền tảng
  • Cách triển khai một dịch vụ đích đến Cloud Run đã xác thực, hoạt động không thay đổi dù có hay không có Express Link
  • Cách bật Ambient Networking (--ambient-networking bằng --ambient-scope=global) và cấp quyền cho ứng dụng Traffic Director (roles/trafficdirector.client) trên một dịch vụ Cloud Run gọi điện
  • Cách tạo và kiểm tra tài nguyên ExpressLink của Dịch vụ mạng, tự động chèn mã thông báo nhận dạng và nâng cấp các lệnh gọi http:// dạng văn bản thuần tuý từ vùng chứa của bạn lên kết nối TLS được mã hoá

Các bước tiếp theo