ساده کردن اصالت‌سنجی سرویس به سرویس Cloud Run با Express Link

۱. نمای کلی

وقتی ریزخدمات یا برنامه‌های چندعاملی را در Cloud Run می‌سازید، سرویس‌های داخلی پسین نباید برای اینترنت عمومی باز باشند. درعوض، هر سرویس پس‌نگر را برای نیاز به اصالت‌سنجی (--no-allow-unauthenticated) پیکربندی می‌کنید و نقش Cloud Run Invoker (roles/run.invoker) IAM را فقط به فراخوانندگان مجاز اعطا می‌کنید.

به‌طور سنتی، فراخوانی سرویس Cloud Run اصالت‌سنجی‌شده مستلزم این است که برنامه فراخواننده شما تزریق دستی کد را در کد انجام دهد. قبل‌از ارسال درخواست HTTP، کد شما از «سرور فراداده Compute» برای دریافت یک کد شناسه OpenID Connect (OIDC) با امضای Google درخواست می‌کند. آن کد به نشانی وب مخاطب سرویس مقصد محدود می‌شود و کد شما آن را به سرصفحه Authorization: Bearer پیوست می‌کند. نوشتن و حفظ کردن لوله‌کشی اصالت‌سنجی در کد برنامه باعث ایجاد اصطکاک غیرضروری می‌شود:

  • این روش منطق کسب‌وکار شما را با کتابخانه‌های اصالت‌سنجی Google Cloud جفت می‌کند و خوانایی و قابلیت جابه‌جایی را در محیط‌های مختلف کاهش می‌دهد.
  • منطق دریافت کد بسته به نوع مقصد و حالت امنیتی متفاوت است. برای مثال، Cloud Run انتظار کد شناسه OIDC را دارد، Google APIs انتظار کد دسترسی OAuth 2.0 را دارد، و mTLS به کد محدودشده نیاز دارد.

Cloud Run Express Link (پیش‌نمایش) تزریق دستی کد را از کد برنامه شما حذف می‌کند. شبکه‌سازی محیطی را در سرویس Cloud Run تماس‌گیرنده (منبع) فعال می‌کنید و یک منبع ExpressLink اعلانی ایجاد می‌کنید که سرویس منبع را به سرویس مقصد متصل می‌کند. یک پراکسی جانبی تحت مدیریت Google درخواست‌های HTTP متن ساده برون‌سو به مقصد را رهگیری می‌کند، به‌طور خودکار کد هویتی سرویس تماس‌گیرنده را تزریق می‌کند، و اتصال به مقصد را رمزگذاری می‌کند.

در این codelab، هر دو رویکرد را درمقابل یک سرویس پس‌بک خصوصی مقایسه خواهید کرد:

  1. یک سرویس مقصد خصوصی و یک سرویس تماس‌گیرنده (caller-oidc) را که یک شناسه OIDC را از سرور فراداده Compute در Python واکشی می‌کند، مستقر کنید. این مرحله اتصال سرتاسری به پس‌بک را تأیید می‌کند و کد اصالت‌سنجی موردنیاز بدون Express Link را نشان می‌دهد.
  2. سرویس تماس‌گیرنده دوم (caller-express-link) را با کد واکشی توکن فراداده حذف‌شده مستقر کنید و آن را بااستفاده از Ambient Networking و 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)     |
+----------------------------------------------+          +-----------------+

پیش‌نیازها

  • آشنایی پایه با Python و سرویس‌های وب اچ‌تی‌تی‌پی
  • آشنایی پایه با حساب‌های خدمات Google Cloud IAM و استقرارهای Cloud Run

آنچه خواهید آموخت

  • نحوه مستقر کردن سرویس مقصد خصوصی Cloud Run که اصالت‌سنجی IAM را اعمال می‌کند
  • نحوه اصالت‌سنجی دستی درخواست‌های سرویس‌به‌سرویس در Python بااستفاده از google-auth کدهای شناسه OIDC از سرور فراداده برای درستی‌سنجی اتصال پایه
  • نحوه برداشتن کد واکشی دستی توکن و مستقر کردن سرویس فراخوان Cloud Run با فعال بودن Ambient Networking
  • نحوه ایجاد کردن Cloud Run Express Link تا سرویس تماس‌گیرنده شما بتواند سرویس مقصد اصالت‌سنجی‌شده را با کد اصالت‌سنجی صفر فراخوانی کند

آنچه خواهید ساخت

  • مقصد: سرویس خصوصی Python Flask در Cloud Run که نقطه پایانی /ping را نمایش می‌دهد
  • caller-oidc: سرویس Python Flask که با واکشی و تزریق دستی کدهای شناسه OIDC در کد برنامه، مقصد را فراخوانی می‌کند
  • caller-express-link: یک سرویس Python Flask موازی با کد تزریق توکن صفر که همان سرویس مقصد را ازطریق Express Link فراخوانی می‌کند

آنچه نیاز خواهید داشت

  • مرورگر وب، مانند Chrome
  • پروژه Google Cloud با صورت‌حساب فعال و اجازه‌های ایجاد حساب‌های خدمات IAM، سرویس‌های Cloud Run، و منابع «سرویس‌های شبکه»

‫۲. راه‌اندازی محیط

راه‌اندازی پروژه Google Cloud

  1. اگر ازقبل «حساب Google» ندارید، باید «حساب Google» ایجاد کنید.
    • به‌جای حساب کاری یا تحصیلی، از حساب شخصی استفاده کنید. حساب‌های کاری و تحصیلی ممکن است محدودیت‌هایی داشته باشند که مانع از فعال کردن میاناهای برنامه‌سازی کاربردی موردنیاز برای این آزمایشگاه شود.
  2. به سیستم کنسول Google Cloud وارد شوید.
  3. صدور صورت‌حساب را در «کنسول Cloud» فعال کنید.
    • تکمیل این آزمایشگاه باید کمتر از ۱ دلار امریکا در منابع Cloud هزینه داشته باشد.
    • برای جلوگیری از کسر هزینه‌های بیشتر، می‌توانید مراحل انتهای این آزمایشگاه را برای حذف منابع دنبال کنید.
    • کاربران جدید واجدشرایط دوره آزمایشی رایگان ۳۰۰ دلاری هستند.
  4. پروژه جدیدی ایجاد کنید یا انتخاب کنید که از پروژه موجودی دوباره استفاده کنید.
    • اگر خطایی درباره سهمیه پروژه مشاهده کردید، از پروژه موجودی دوباره استفاده کنید یا پروژه موجودی را حذف کنید تا پروژه جدیدی ایجاد شود.

شروع Cloud Shell

در این codelab، از Cloud Shell استفاده می‌کنید که محیط خط فرمان مبتنی بر مرورگر است و Google Cloud CLI‏ (gcloud)،‏ Python، و curl ازقبل در آن نصب شده است.

  1. در کنسول Google Cloud، روی فعال کردن Cloud Shell در نوار پیمایش بالا کلیک کنید. اگر درخواست شد، روی مجاز کردن کلیک کنید.
  2. شناسه پروژه و منطقه استقرار را صادر کنید و gcloud را برای استفاده از $PROJECT_ID پیکربندی کنید. YOUR_PROJECT_ID را با شناسه پروژه‌تان جایگزین کنید و به‌صورت اختیاری us-west1 را با منطقه Cloud Run دیگری جایگزین کنید:
export PROJECT_ID="YOUR_PROJECT_ID"
export REGION="us-west1"
gcloud config set project "$PROJECT_ID"
  1. شماره پروژه و حساب Google Cloud فعال خود را صادر کنید و مطمئن شوید که هر چهار متغیر پر شده باشند:
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"

به‌روزرسانی gcloud و فعال کردن میاناهای برنامه‌سازی کاربردی

  1. مؤلفه‌های gcloud را به‌روز کنید تا جدیدترین فرمان‌های beta را برای «شبکه‌سازی محیطی» و Express Link داشته باشید:
gcloud components update --quiet
  1. Google Cloud API لازم را برای پیاده‌سازی‌های منبع Cloud Run، حساب‌های سرویس IAM،‏ Ambient Networking، و 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

ایجاد کردن فهرست راهنمای فضای کاری

یک فهرست راهنمای کاری برای نگهداری سه پوشه سرویسی که در این codelab خواهید ساخت ایجاد کنید:

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

۳. پیاده‌سازی سرویس مقصد خصوصی

ابتدا، سرویس خصوصی Cloud Run را با نام destination مستقر خواهید کرد. از این سرویس مقصد واحد برای هر دو بخش codelab مجدداً استفاده خواهید کرد:

  • سرویس مقصد هرگز تزریق رمزه برون‌مرزی انجام نمی‌دهد.
  • برای دریافت ترافیک ازطریق Express Link، لازم نیست Ambient Networking در سرویس مقصد فعال باشد.
  1. حساب سرویس IAM اختصاصی برای سرویس مقصد ایجاد کنید:
gcloud iam service-accounts create destination-identity \
    --display-name="Cloud Run destination service account"
  1. پوشه destination ایجاد کنید و به آن منتقل شوید:
mkdir -p ~/express-link-codelab/destination
cd ~/express-link-codelab/destination
  1. فرمان زیر را برای ایجاد فایل requirements.txt با Flask و Gunicorn اجرا کنید:
cat << 'EOF' > requirements.txt
Flask==3.0.0
gunicorn==21.2.0
EOF
  1. دستور زیر را اجرا کنید تا فایل main.py ایجاد شود که نقطه پایانی /ping را که نام سرویس Cloud Run را از متغیر محیطی 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. destination را از منبع با --no-allow-unauthenticated مستقر کنید تا Cloud Run درخواست‌های تأییدنشده را رد کند:
gcloud run deploy destination \
    --source . \
    --region="$REGION" \
    --service-account="destination-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --no-allow-unauthenticated
  1. نشانی وب قطعی و شناسه منبع یکسان کامل سرویس مقصد را در متغیرهای محیطی ذخیره کنید:
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. نقش Cloud Run Invoker (roles/run.invoker) را در destination به حساب کاربری‌تان اعطا کنید تا بتوانید آن را مستقیماً از Cloud Shell آزمایش کنید:
gcloud run services add-iam-policy-binding destination \
    --member="user:$ACTIVE_ACCOUNT" \
    --role="roles/run.invoker" \
    --region="$REGION"
  1. بااستفاده از کد اصالت‌سنجی خودتان، درخواست اصالت‌سنجی‌شده‌ای به /ping ارسال کنید تا تأیید شود destination درحال اجرا است:
TOKEN=$(gcloud auth print-identity-token)
curl -H "Authorization: Bearer $TOKEN" "$DESTINATION_URL/ping"

باید پاسخ زیر را ببینید:

Hello from destination

۴. تماس با مقصد بدون «پیوند سریع»

قبل‌از معرفی Express Link، caller-oidc را بسازید تا ببینید اصالت‌سنجی سرویس به سرویس امروزه به چه چیزی نیاز دارد و درستی‌سنجی کنید که سرویس تماس‌گیرنده می‌تواند به destination دسترسی پیدا کند. برای فراخوانی ایمن destination بدون Express Link، باید دو لایه را پیکربندی کنید:

  • مجوز IAM: به حساب سرویس caller-oidc نقش roles/run.invoker را در destination اعطا کنید.
  • تزریق کردن کد در سطح برنامه: کتابخانه google-auth را به caller-oidc اضافه کنید و نشانی وب هدف را تجزیه کنید تا مخاطب OIDC ریشه را استخراج کنید. سپس یک شناسه توکن امضاشده را از سرور فراداده واکشی کنید و Authorization: Bearer ID_TOKEN را به درخواست HTTPS خروجی پیوست کنید.

برای پیکربندی و پیاده‌سازی caller-oidc، این مراحل را دنبال کنید:

  1. ایجاد حساب سرویس اختصاصی برای caller-oidc:
gcloud iam service-accounts create caller-oidc-identity \
    --display-name="Cloud Run OIDC caller service account"
  1. به caller-oidc-identity اجازه دهید 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. فهرست راهنمای caller-oidc را در کنار destination ایجاد کنید:
mkdir -p ~/express-link-codelab/caller-oidc
cd ~/express-link-codelab/caller-oidc
  1. فرمان زیر را برای ایجاد فایل requirements.txt اجرا کنید. توجه داشته باشید که باید google-auth را به‌طور خاص برای مدیریت بازیابی کد در محفظه برنامه‌تان اضافه کنید:
cat << 'EOF' > requirements.txt
Flask==3.0.0
google-auth==2.23.0
requests==2.31.0
gunicorn==21.2.0
EOF
  1. فرمان زیر را اجرا کنید تا فایل main.py با تزریق دستی کد OIDC ایجاد شود:
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. مستقر کردن caller-oidc در Cloud Run:
gcloud run deploy caller-oidc \
    --source . \
    --region="$REGION" \
    --service-account="caller-oidc-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --no-allow-unauthenticated
  1. به حساب کاربری‌تان اجازه دهید caller-oidc را فراخوانی کند:
gcloud run services add-iam-policy-binding caller-oidc \
    --member="user:$ACTIVE_ACCOUNT" \
    --role="roles/run.invoker" \
    --region="$REGION"
  1. نشانی وب قطعی caller-oidc را ذخیره کنید و آن را فراخوانی کنید، نشانی وب اچ‌تی‌تی‌پی‌اس $DESTINATION_URL/ping را به‌عنوان 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"

باید پاسخ موفقیت‌آمیزی از destination دریافت کنید:

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

۵. پیاده‌سازی سرویس تماس‌گیرنده برای Express Link

اکنون سرویس تماس‌گیرنده دومی به‌نام caller-express-link در دایرکتوری خواهر/برادر خواهید ساخت. با «پیوند سریع»، caller-express-link به هیچ کد تزریق توکنی نیاز ندارد—مستقیماً با requests.get(target_url, timeout=10) تماس می‌گیرد.

  1. ایجاد حساب سرویس اختصاصی برای caller-express-link:
gcloud iam service-accounts create caller-express-link-identity \
    --display-name="Cloud Run Express Link caller service account"
  1. نقش roles/trafficdirector.client را به caller-express-link-identity اعطا کنید تا سایدکار مدیریت‌شده Ambient Networking بتواند پیکربندی امنیتی و مسیریابی Express Link را بارگیری کند. همچنین roles/cloudtrace.agent را اعطا کنید تا سایدکار بتواند بازه‌های ردیابی را صادر کند:
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. فهرست راهنمای caller-express-link را در کنار caller-oidc ایجاد کنید:
mkdir -p ~/express-link-codelab/caller-express-link
cd ~/express-link-codelab/caller-express-link
  1. فرمان زیر را برای ایجاد فایل requirements.txt بدون google-auth اجرا کنید:
cat << 'EOF' > requirements.txt
Flask==3.0.0
requests==2.31.0
gunicorn==21.2.0
EOF
  1. فرمان زیر را اجرا کنید تا فایل main.py با فراخوانی requests.get(target_url, timeout=10) ساده و بدون منطق تزریق کد ایجاد شود:
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. diff را درمقابل ../caller-oidc/main.py اجرا کنید تا اصالت‌سنجی تکراری را که حذف کرده‌اید ببینید:
diff -u ../caller-oidc/main.py main.py || true
  1. پیاده‌سازی caller-express-link بااستفاده از gcloud beta run deploy با فعال بودن --ambient-networking و --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. بررسی کنید که «شبکه‌سازی محیطی» در caller-express-link فعال باشد:
gcloud run services describe caller-express-link --region="$REGION"

در پایان خلاصه بازنگری، مطمئن شوید که Ambient Networking و Ambient Scope نشان داده می‌شود:

  Ambient Networking: Enabled
  Ambient Scope:     global
  1. به حساب کاربری‌تان اجازه دهید caller-express-link را فراخوانی کند و به caller-express-link-identity اجازه دهید 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. نشانی وب و شناسه منبع یکسان caller-express-link را به‌همراه نشانی وب قطعی HTTP (http://) مربوط به 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. تماس آزمایشی با destination ازطریق caller-express-link قبل‌از ایجاد «پیوند سریع»:
TOKEN=$(gcloud auth print-identity-token)
curl -H "Authorization: Bearer $TOKEN" "$CALLER_EL_URL/?target_url=$DESTINATION_HTTP_URL/ping"

همان‌طور که انتظار می‌رود، تماس با 403 Forbidden ناموفق است زیرا هنوز هیچ Express Link وجود ندارد که درخواست را رهگیری کند و اطلاعات کاربری را تزریق کند:

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>
'

‫۶. اتصال سرویس‌ها با «پیوند سریع»

اکنون منبع ExpressLink را که caller-express-link (سرویس منبع) را به destination متصل می‌کند اعلام می‌کنید—بدون اینکه حتی یک خط کد را تغییر دهید یا هیچ‌کدام از سرویس‌های Cloud Run را دوباره مستقر کنید.

  1. منبع Express Link را در مکان 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. «پیوندهای سریع» خود را فهرست کنید تا وجود منبع تأیید شود:
gcloud beta network-services express-links list --location=global

برونداد فرمان:

NAME
caller-to-destination
  1. جزئیات پیکربندی Express Link را بررسی کنید:
gcloud beta network-services express-links describe caller-to-destination --location=global

برونداد فرمان:

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. دقیقاً همان درخواست curl را درمقابل caller-express-link دوباره اجرا کنید:
TOKEN=$(gcloud auth print-identity-token)
curl -H "Authorization: Bearer $TOKEN" "$CALLER_EL_URL/?target_url=$DESTINATION_HTTP_URL/ping"

این بار، Ambient sidecar درخواست HTTP به destination را رهگیری می‌کند، کد هویتی caller-express-link-identity را تزریق می‌کند، اتصال را به TLS ارتقا می‌دهد، و پاسخ مقصد را برمی‌گرداند:

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

جدول زیر تغییرات بین caller-oidc و caller-express-link را خلاصه می‌کند:

ابعاد

بدون Express Link‏ (caller-oidc)

با «پیوند سریع» (caller-express-link)

کتابخانه‌های Auth در requirements.txt

مورد لزوم google-auth

هیچ‌کدام (فقط Flask، requests، gunicorn)

تماس خروجی تا main.py دیگر

تجزیه نشانی وب مخاطب، تماس با id_token.fetch_id_token()، پیوست کردن سرصفحه Authorization: Bearer

ساده requests.get(target_url, timeout=10)

طرح‌واره نشانی وب هدف در برنامه

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

http://destination-PROJECT_NUMBER.REGION.run.app (توسط Ambient sidecar به TLS ارتقا یافته است)

پیکربندی Cloud Run تماس‌گیرنده

استقرار استاندارد

‫--ambient-networking --ambient-scope=global + roles/trafficdirector.client در حساب سرویس تماس‌گیرنده

پیکربندی Cloud Run مقصد

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

بدون تغییر (--no-allow-unauthenticated + roles/run.invoker)

‫۷. مرتب‌سازی

برای جلوگیری از کسر هزینه‌های جاری از حساب Google Cloud، منابعی را که درطول این codelab ایجاد کرده‌اید حذف کنید.

  1. منبع Express Link را حذف کنید:
gcloud beta network-services express-links delete caller-to-destination --location=global --quiet
  1. سه سرویس 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. اتصال‌های خط‌مشی IAM سطح پروژه را بردارید و سه حساب سرویس را حذف کنید:
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. (اختیاری) اگر پروژه Google Cloud اختصاصی را صرفاً برای این codelab ایجاد کرده‌اید، می‌توانید کل پروژه را حذف کنید:
# Run only if you want to delete the entire project and all its resources
gcloud projects delete "$PROJECT_ID"

‫۸. تبریک می‌گوییم

شما یک سرویس زیرینه خصوصی Cloud Run را مستقر کردید و آن را بااستفاده از تزریق دستی توکن OIDC در Python فراخوانی کردید. سپس همه کدهای اصالت‌سنجی سطح برنامه را با Cloud Run Express Link اعلانی جایگزین کردید.

آنچه یاد گرفتید

  • چرا تزریق دستی کد OIDC منطق کسب‌وکار برنامه را با کتابخانه‌های اصالت‌سنجی پلاتفرم و حالت‌های امنیتی جفت می‌کند
  • نحوه مستقر کردن سرویس مقصد Cloud Run اصالت‌سنجی‌شده که بدون تغییر با Express Link یا بدون آن کار می‌کند
  • نحوه فعال کردن «شبکه‌سازی محیطی» (--ambient-networking با --ambient-scope=global) و اعطای اجازه‌های کارخواه «مدیر ترافیک» (roles/trafficdirector.client) در سرویس فراخواننده Cloud Run
  • نحوه ایجاد و بازرسی منبع «سرویس‌های شبکه» ExpressLink که به‌طور خودکار کدهای هویتی را تزریق می‌کند و تماس‌های http:// متن ساده را از محفظه شما به اتصالات «امنیت لایه انتقال» رمزگذاری‌شده ارتقا می‌دهد

مراحل بعدی