۱. نمای کلی
وقتی ریزخدمات یا برنامههای چندعاملی را در 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، هر دو رویکرد را درمقابل یک سرویس پسبک خصوصی مقایسه خواهید کرد:
- یک سرویس مقصد خصوصی و یک سرویس تماسگیرنده (caller-oidc) را که یک شناسه OIDC را از سرور فراداده Compute در Python واکشی میکند، مستقر کنید. این مرحله اتصال سرتاسری به پسبک را تأیید میکند و کد اصالتسنجی موردنیاز بدون Express Link را نشان میدهد.
- سرویس تماسگیرنده دوم (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
- اگر ازقبل «حساب Google» ندارید، باید «حساب Google» ایجاد کنید.
- بهجای حساب کاری یا تحصیلی، از حساب شخصی استفاده کنید. حسابهای کاری و تحصیلی ممکن است محدودیتهایی داشته باشند که مانع از فعال کردن میاناهای برنامهسازی کاربردی موردنیاز برای این آزمایشگاه شود.
- به سیستم کنسول Google Cloud وارد شوید.
- صدور صورتحساب را در «کنسول Cloud» فعال کنید.
- تکمیل این آزمایشگاه باید کمتر از ۱ دلار امریکا در منابع Cloud هزینه داشته باشد.
- برای جلوگیری از کسر هزینههای بیشتر، میتوانید مراحل انتهای این آزمایشگاه را برای حذف منابع دنبال کنید.
- کاربران جدید واجدشرایط دوره آزمایشی رایگان ۳۰۰ دلاری هستند.
- پروژه جدیدی ایجاد کنید یا انتخاب کنید که از پروژه موجودی دوباره استفاده کنید.
- اگر خطایی درباره سهمیه پروژه مشاهده کردید، از پروژه موجودی دوباره استفاده کنید یا پروژه موجودی را حذف کنید تا پروژه جدیدی ایجاد شود.
شروع Cloud Shell
در این codelab، از Cloud Shell استفاده میکنید که محیط خط فرمان مبتنی بر مرورگر است و Google Cloud CLI (gcloud)، Python، و curl ازقبل در آن نصب شده است.
- در کنسول Google Cloud، روی فعال کردن Cloud Shell در نوار پیمایش بالا کلیک کنید. اگر درخواست شد، روی مجاز کردن کلیک کنید.
- شناسه پروژه و منطقه استقرار را صادر کنید و
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"
- شماره پروژه و حساب 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 و فعال کردن میاناهای برنامهسازی کاربردی
- مؤلفههای
gcloudرا بهروز کنید تا جدیدترین فرمانهایbetaرا برای «شبکهسازی محیطی» و Express Link داشته باشید:
gcloud components update --quiet
- 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 در سرویس مقصد فعال باشد.
- حساب سرویس IAM اختصاصی برای سرویس مقصد ایجاد کنید:
gcloud iam service-accounts create destination-identity \
--display-name="Cloud Run destination service account"
- پوشه
destinationایجاد کنید و به آن منتقل شوید:
mkdir -p ~/express-link-codelab/destination
cd ~/express-link-codelab/destination
- فرمان زیر را برای ایجاد فایل
requirements.txtبا Flask و Gunicorn اجرا کنید:
cat << 'EOF' > requirements.txt
Flask==3.0.0
gunicorn==21.2.0
EOF
- دستور زیر را اجرا کنید تا فایل
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
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
- نشانی وب قطعی و شناسه منبع یکسان کامل سرویس مقصد را در متغیرهای محیطی ذخیره کنید:
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"
- نقش 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"
- بااستفاده از کد اصالتسنجی خودتان، درخواست اصالتسنجیشدهای به
/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، این مراحل را دنبال کنید:
- ایجاد حساب سرویس اختصاصی برای
caller-oidc:
gcloud iam service-accounts create caller-oidc-identity \
--display-name="Cloud Run OIDC caller service account"
- به
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"
- فهرست راهنمای
caller-oidcرا در کنارdestinationایجاد کنید:
mkdir -p ~/express-link-codelab/caller-oidc
cd ~/express-link-codelab/caller-oidc
- فرمان زیر را برای ایجاد فایل
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
- فرمان زیر را اجرا کنید تا فایل
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
- مستقر کردن
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
- به حساب کاربریتان اجازه دهید
caller-oidcرا فراخوانی کند:
gcloud run services add-iam-policy-binding caller-oidc \
--member="user:$ACTIVE_ACCOUNT" \
--role="roles/run.invoker" \
--region="$REGION"
- نشانی وب قطعی
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) تماس میگیرد.
- ایجاد حساب سرویس اختصاصی برای
caller-express-link:
gcloud iam service-accounts create caller-express-link-identity \
--display-name="Cloud Run Express Link caller service account"
- نقش
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"
- فهرست راهنمای
caller-express-linkرا در کنارcaller-oidcایجاد کنید:
mkdir -p ~/express-link-codelab/caller-express-link
cd ~/express-link-codelab/caller-express-link
- فرمان زیر را برای ایجاد فایل
requirements.txtبدونgoogle-authاجرا کنید:
cat << 'EOF' > requirements.txt
Flask==3.0.0
requests==2.31.0
gunicorn==21.2.0
EOF
- فرمان زیر را اجرا کنید تا فایل
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
diffرا درمقابل../caller-oidc/main.pyاجرا کنید تا اصالتسنجی تکراری را که حذف کردهاید ببینید:
diff -u ../caller-oidc/main.py main.py || true
- پیادهسازی
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
- بررسی کنید که «شبکهسازی محیطی» در
caller-express-linkفعال باشد:
gcloud run services describe caller-express-link --region="$REGION"
در پایان خلاصه بازنگری، مطمئن شوید که Ambient Networking و Ambient Scope نشان داده میشود:
Ambient Networking: Enabled Ambient Scope: global
- به حساب کاربریتان اجازه دهید
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"
- نشانی وب و شناسه منبع یکسان
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"
- تماس آزمایشی با
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 را دوباره مستقر کنید.
- منبع 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"
- «پیوندهای سریع» خود را فهرست کنید تا وجود منبع تأیید شود:
gcloud beta network-services express-links list --location=global
برونداد فرمان:
NAME caller-to-destination
- جزئیات پیکربندی 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'
- دقیقاً همان درخواست
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'
مقایسه تزریق دستی کد با Express Link
جدول زیر تغییرات بین caller-oidc و caller-express-link را خلاصه میکند:
ابعاد | بدون Express Link ( | با «پیوند سریع» ( |
کتابخانههای Auth در | مورد لزوم | هیچکدام (فقط |
تماس خروجی تا | تجزیه نشانی وب مخاطب، تماس با | ساده |
طرحواره نشانی وب هدف در برنامه |
|
|
پیکربندی Cloud Run تماسگیرنده | استقرار استاندارد | |
پیکربندی Cloud Run مقصد | | بدون تغییر ( |
۷. مرتبسازی
برای جلوگیری از کسر هزینههای جاری از حساب Google Cloud، منابعی را که درطول این codelab ایجاد کردهاید حذف کنید.
- منبع Express Link را حذف کنید:
gcloud beta network-services express-links delete caller-to-destination --location=global --quiet
- سه سرویس 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
- اتصالهای خطمشی 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
- (اختیاری) اگر پروژه 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://متن ساده را از محفظه شما به اتصالات «امنیت لایه انتقال» رمزگذاریشده ارتقا میدهد
مراحل بعدی
- اصالتسنجی سرویس به سرویس را در اسناد Cloud Run بخوانید.
- برای اطلاع از جدیدترین بهروزرسانیهای Ambient Networking و Express Link، یادداشتهای انتشار Cloud Run را بررسی کنید.