تبسيط المصادقة بين خدمات Cloud Run باستخدام Express Link

1. نظرة عامة

عند إنشاء خدمات مصغّرة أو تطبيقات متعدّدة الوكلاء على Cloud Run، يجب ألا تكون خدمات الخلفية الداخلية متاحة للجميع على الإنترنت. بدلاً من ذلك، يمكنك ضبط كل خدمة خلفية لطلب المصادقة (--no-allow-unauthenticated) ومنح دور "إدارة الهوية وإمكانية الوصول" (IAM) لـ "مُشغِّل Cloud Run"‏ (roles/run.invoker) للمتصلين المصرَّح لهم فقط.

في العادة، يتطلّب استدعاء خدمة Cloud Run مصادَق عليها أن يُجري التطبيق الذي يستدعيها عملية حقن يدوي للرمز المميّز في الرمز البرمجي. قبل إرسال طلب HTTP، يرسل الرمز البرمجي طلبًا إلى خادم البيانات الوصفية في Compute للحصول على رمز مميز لتعريف اتصال OpenID (OIDC) موقَّع من Google. يتم تحديد نطاق هذا الرمز المميّز لعنوان URL الخاص بجمهور الخدمة المقصودة، ويربطه الرمز البرمجي بعنوان Authorization: Bearer. تؤدي كتابة وصيانة عمليات المصادقة داخل الرمز البرمجي للتطبيق إلى حدوث احتكاك غير ضروري:

  • فهي تربط منطق نشاطك التجاري بمكتبات مصادقة Google Cloud، ما يقلل من إمكانية القراءة وإمكانية النقل عبر البيئات.
  • يختلف منطق الحصول على الرمز المميّز باختلاف أنواع الوجهات وأوضاع الأمان. على سبيل المثال، تتطلّب Cloud Run رموز تعريف OIDC، وتتطلّب Google APIs رموز الدخول OAuth 2.0، وتتطلّب mTLS رموزًا مرتبطة.

تزيل ميزة Cloud Run Express Link (نسخة حصرية) عملية إدخال الرموز المميّزة يدويًا من الرمز البرمجي للتطبيق. يمكنك تفعيل الشبكات المحيطة في خدمة Cloud Run للاتصال (المصدر) وإنشاء مورد ExpressLink تعريفي يربط خدمة المصدر بخدمة الوجهة. يعترض خادم وكيل جانبي تديره Google طلبات HTTP الصادرة بنص عادي إلى الوجهة، ويُدخل رمز تعريف خدمة المتصل تلقائيًا، ويشفّر الاتصال بالوجهة.

في هذا الدرس التطبيقي حول الترميز، ستقارن بين الطريقتين في خدمة الخلفية الخاصة نفسها:

  1. انشر خدمة وجهة خاصة وخدمة متصل (caller-oidc) تجلب رمز تعريف OIDC من خادم البيانات الوصفية في Compute بلغة Python. تؤكّد هذه الخطوة الاتصال الشامل بالخلفية وتعرض رمز المصادقة المطلوب بدون Express Link.
  2. نشر خدمة متصل ثانية (caller-express-link) مع إزالة رمز جلب الرمز المميّز للبيانات الوصفية، وربطها بالخدمة الوجهة باستخدام ميزة "الشبكات المحيطة" و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 وخدمات الويب عبر بروتوكول HTTP
  • معرفة أساسية بحسابات خدمة Google Cloud IAM وعمليات نشر Cloud Run

أهداف الدورة التعليمية

  • كيفية نشر خدمة وجهة خاصة في Cloud Run تفرض مصادقة "إدارة الهوية وإمكانية الوصول" (IAM)
  • كيفية مصادقة طلبات الخدمة إلى الخدمة يدويًا في Python باستخدام رموز تعريف OIDC من google-auth من خادم البيانات الوصفية للتحقّق من الاتصال الأساسي
  • كيفية إزالة رمز جلب الرموز المميّزة يدويًا ونشر خدمة استدعاء Cloud Run مع تفعيل ميزة "الشبكة المحيطة"
  • كيفية إنشاء رابط Cloud Run Express Link لكي تتمكّن خدمة المتصل من استدعاء خدمة وجهة مصادَق عليها بدون رمز مصادقة

ما ستنشئه

  • ‫destination: خدمة Python Flask خاصة على Cloud Run تعرض نقطة نهاية /ping
  • caller-oidc: خدمة Python Flask تستدعي destination عن طريق جلب رموز تعريف OIDC يدويًا وإدخالها في الرمز البرمجي للتطبيق
  • caller-express-link: خدمة Python Flask تعمل جنبًا إلى جنب مع رمز حقن الرموز المميزة الصفري الذي يستدعي خدمة destination نفسها من خلال رابط Express Link

المتطلبات

  • متصفّح ويب، مثل Chrome
  • مشروع على Google Cloud تم تفعيل الفوترة فيه ولديه أذونات لإنشاء حسابات خدمة "إدارة الهوية وإمكانية الوصول" وخدمات Cloud Run وموارد "خدمات الشبكة"

2. إعداد البيئة

إعداد مشروع على Google Cloud

  1. إذا لم يكن لديك حساب على Google، عليك إنشاء حساب Google.
    • استخدام حساب شخصي بدلاً من حساب عمل أو حساب تديره مؤسسة تعليمية قد تكون هناك قيود على حسابات العمل والمؤسسات التعليمية تمنعك من تفعيل واجهات برمجة التطبيقات اللازمة لهذا التمرين العملي.
  2. سجِّل الدخول إلى Google Cloud Console.
  3. فعِّل الفوترة في Cloud Console.
    • من المفترض أن تبلغ تكلفة إكمال هذا التمرين أقل من دولار أمريكي واحد من موارد Cloud.
    • يمكنك اتّباع الخطوات الواردة في نهاية هذا التمرين لحذف الموارد وتجنُّب تحصيل المزيد من الرسوم.
    • يمكن للمستخدمين الجدد الاستفادة من فترة تجريبية مجانية بقيمة 300 دولار أمريكي.
  4. أنشِئ مشروعًا جديدًا أو اختَر إعادة استخدام مشروع حالي.
    • إذا ظهر لك خطأ بشأن حصة المشروع، أعِد استخدام مشروع حالي أو احذِف مشروعًا حاليًا لإنشاء مشروع جديد.

بدء Cloud Shell

في هذا الدرس التطبيقي حول الترميز، ستستخدم 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 لـ "الشبكة المحيطة" و"الربط السريع":
gcloud components update --quiet
  1. فعِّل واجهات Google Cloud API المطلوبة لعمليات نشر المصدر في Cloud Run وحسابات خدمة "إدارة الهوية وإمكانية الوصول" و"الشبكات المحيطة" و"رابط Express لخدمات الشبكة":
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

إنشاء دليل مساحة عمل

أنشئ دليل عمل للاحتفاظ بمجلدات الخدمات الثلاثة التي ستنشئها في هذا الدرس التطبيقي:

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

3- نشر خدمة الوجهة الخاصة

أولاً، عليك نشر خدمة Cloud Run خاصة باسم destination. ستعيد استخدام خدمة الوجهة الواحدة هذه في كلا جزأَي الدرس التطبيقي حول الترميز:

  • لا تنفّذ خدمة الوجهة مطلقًا عملية حقن الرموز المميزة الصادرة.
  • لا تحتاج الخدمة المقصودة إلى تفعيل ميزة "الشبكة المحيطة" لتلقّي الزيارات عبر Express Link.
  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. خزِّن عنوان URL الحتمي لخدمة الوجهة ومعرّف الموارد المنتظم (URI) الكامل للمورد في متغيّرات البيئة:
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"‏ (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

4. الاتصال بالوجهة بدون Express Link

قبل تقديم Express Link، أنشِئ caller-oidc لمعرفة متطلبات المصادقة بين الخدمات اليوم والتحقّق من أنّ خدمة الاتصال يمكنها الوصول إلى destination. للاتصال بـ "destination" بأمان بدون Express Link، عليك ضبط طبقتَين:

  • تفويض "إدارة الهوية وإمكانية الوصول": امنح حساب الخدمة caller-oidc دور roles/run.invoker في destination.
  • إدخال الرمز المميّز على مستوى التطبيق: أضِف مكتبة google-auth إلى caller-oidc وحلِّل عنوان URL المستهدَف لاستخراج جمهور 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. خزِّن عنوان URL الحتمي لـ caller-oidc واستدعِه، مع تمرير عنوان URL الذي يستخدم HTTPS $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'

5- نشر خدمة المتصل لـ Express Link

عليك الآن إنشاء خدمة استدعاء ثانية باسم caller-express-link في دليل شقيق. باستخدام 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. يجب منح caller-express-link-identity دور roles/trafficdirector.client حتى يتمكّن تطبيق Ambient Networking المُدار من تنزيل إعدادات الأمان والتوجيه في Express Link. يجب أيضًا منح roles/cloudtrace.agent حتى يتمكّن sidecar من تصدير نطاقات التتبُّع:
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. يُرجى تخزين عنوان URL ومعرّف الموارد المنتظم (URI) الخاص بـ caller-express-link، بالإضافة إلى عنوان URL الحتمي 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" قبل إنشاء رابط 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>
'

6. ربط الخدمات باستخدام Express Link

الآن، عليك الإعلان عن مورد 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. أدرِج روابط Express Links لتأكيد توفّر المورد:
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)

باستخدام Express Link (caller-express-link)

مكتبات المصادقة في requirements.txt

يتطلب google-auth

بلا (Flask، requests، gunicorn فقط)

مكالمة صادرة في main.py

تحليل عنوان URL الخاص بشريحة الجمهور، واستدعاء id_token.fetch_id_token()، وإرفاق عنوان Authorization: Bearer

‫requests.get(target_url, timeout=10) عادي

مخطّط عنوان URL المستهدَف في التطبيق

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

http://destination-PROJECT_NUMBER.REGION.run.app (تمت ترقيته إلى بروتوكول أمان طبقة النقل (TLS) من خلال Ambient sidecar)

إعدادات Cloud Run للمتصل

النشر العادي

‫--ambient-networking --ambient-scope=global + roles/trafficdirector.client في حساب خدمة المتصل

إعدادات Cloud Run للوجهة

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

بلا تغيير (--no-allow-unauthenticated + roles/run.invoker)

7. تَنظيم

لتجنُّب تحمُّل رسوم مستمرة على حسابك على Google Cloud، احذف الموارد التي أنشأتها خلال هذا الدرس التطبيقي حول الترميز.

  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. أزِل عمليات ربط سياسات "إدارة الهوية وإمكانية الوصول" على مستوى المشروع واحذف حسابات الخدمة الثلاثة:
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 لهذا الدرس التطبيقي حول الترميز فقط، يمكنك حذف المشروع بأكمله:
# Run only if you want to delete the entire project and all its resources
gcloud projects delete "$PROJECT_ID"

8. تهانينا

لقد نشرت خدمة خلفية خاصة في Cloud Run واستدعيتها باستخدام حقن رمز OIDC يدويًا في Python. بعد ذلك، استبدلت جميع رموز المصادقة على مستوى التطبيق برابط Cloud Run Express Link تعريفي.

ما تعلّمته

  • لماذا يربط الإدخال اليدوي لرموز OIDC المميزة منطق عمل التطبيق بمكتبات مصادقة النظام الأساسي وأوضاع الأمان؟
  • كيفية نشر خدمة وجهة Cloud Run مصادَق عليها تعمل بدون تغيير مع Express Link أو بدونه
  • كيفية تفعيل "الشبكات المحيطة" (--ambient-networking مع --ambient-scope=global) ومنح أذونات عميل Traffic Director ‏(roles/trafficdirector.client) في خدمة Cloud Run التي تُجري المكالمات
  • كيفية إنشاء مورد "خدمات الشبكة" (ExpressLink) وفحصه، والذي يُدخل تلقائيًا رموز الهوية المميّزة ويُرقّي طلبات http:// النص العادي من الحاوية إلى اتصالات بروتوكول أمان طبقة النقل (TLS) المشفّرة

الخطوات التالية