Express Link ile Cloud Run hizmetleri arasındaki kimlik doğrulamasını basitleştirme

1. Genel Bakış

Cloud Run'da mikro hizmetler veya çok aracılı uygulamalar oluşturduğunuzda dahili arka uç hizmetleri herkese açık internete açık olmamalıdır. Bunun yerine, her arka uç hizmetini kimlik doğrulama (--no-allow-unauthenticated) gerektirecek şekilde yapılandırır ve Cloud Run Çağırıcısı (roles/run.invoker) IAM rolünü yalnızca yetkili arayanlara verirsiniz.

Geleneksel olarak, kimliği doğrulanmış bir Cloud Run hizmetini çağırmak için çağıran uygulamanızın kodda manuel jeton ekleme işlemi yapması gerekir. Kodunuz, HTTP isteği göndermeden önce Google tarafından imzalanmış bir OpenID Connect (OIDC) kimlik jetonu için Compute Metadata Server'ı sorgular. Bu jeton, hedef hizmetin kitle URL'si kapsamındadır ve kodunuz bunu Authorization: Bearer başlığına ekler. Uygulama kodunda kimlik doğrulama altyapısı yazmak ve sürdürmek, gereksiz zorluklara neden olur:

  • İş mantığınızı Google Cloud kimlik doğrulama kitaplıklarıyla birleştirerek ortamlar arasında okunabilirliği ve taşınabilirliği azaltır.
  • Jeton alma mantığı, hedef türlerine ve güvenlik modlarına göre değişir. Örneğin, Cloud Run OIDC kimlik jetonları, Google API'leri OAuth 2.0 erişim jetonları bekler ve mTLS için bağlı jetonlar gerekir.

Cloud Run Express Link (Önizleme), uygulama kodunuzdan manuel jeton ekleme işlemini kaldırır. Arayan (kaynak) Cloud Run hizmetinde Ambient Networking'i etkinleştirir ve kaynak hizmeti hedef hizmete bağlayan açıklayıcı bir ExpressLink kaynağı oluşturursunuz. Google tarafından yönetilen bir yardımcı proxy, hedefe giden şifrelenmemiş metin HTTP isteklerini yakalar, arayan hizmetin kimlik jetonunu otomatik olarak yerleştirir ve hedefe olan bağlantıyı şifreler.

Bu codelab'de, her iki yaklaşımı da aynı özel arka uç hizmetiyle karşılaştıracaksınız:

  1. Python'da Compute Metadata Server'dan OIDC kimlik jetonu alan bir özel hedef hizmeti ve arayan hizmeti (caller-oidc) dağıtın. Bu adım, arka uca uçtan uca bağlantıyı onaylar ve Express Link olmadan gereken kimlik doğrulama kodunu gösterir.
  2. Meta veri jetonu getirme kodu kaldırılmış ikinci bir arayan hizmeti (caller-express-link) dağıtın ve Ambient Networking ile Express Link'i kullanarak bu hizmeti hedef hizmete bağlayın.
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)     |
+----------------------------------------------+          +-----------------+

Ön koşullar

  • Python ve HTTP web hizmetleri hakkında temel düzeyde bilgi sahibi olma
  • Google Cloud IAM hizmet hesapları ve Cloud Run dağıtımları hakkında temel düzeyde bilgi sahibi olmak

Neler öğreneceksiniz?

  • IAM kimlik doğrulamasını zorunlu kılan özel bir Cloud Run hedef hizmeti dağıtma
  • Temel bağlantıyı doğrulamak için meta veri sunucusundan alınan google-auth OIDC kimlik jetonlarını kullanarak Python'da hizmetler arası isteklerin kimliğini manuel olarak doğrulama
  • Manuel jeton alma kodunu kaldırma ve Ambient Networking etkinleştirilmiş bir Cloud Run arayan hizmeti dağıtma
  • Arayan hizmetinizin kimliği doğrulanmış bir hedef hizmeti sıfır kimlik doğrulama koduyla çağırabilmesi için Cloud Run Express Link oluşturma

Ne oluşturacaksınız?

  • destination: Cloud Run'da /ping uç noktasını gösteren özel bir Python Flask hizmeti
  • caller-oidc: OIDC kimlik jetonlarını uygulama koduna manuel olarak getirip ekleyerek destination'ı çağıran bir Python Flask hizmeti
  • caller-express-link: Aynı destination hizmetini bir Express Link üzerinden çağıran, sıfır jeton yerleştirme koduna sahip yan yana bir Python Flask hizmeti

İhtiyacınız olanlar

  • Chrome gibi bir web tarayıcısı
  • Faturalandırmanın etkin olduğu ve IAM hizmet hesapları, Cloud Run hizmetleri ve Network Services kaynakları oluşturma izinlerine sahip bir Google Cloud projesi

2. Ortamınızı ayarlama

Google Cloud projesi oluşturun

  1. Google Hesabınız yoksa bir Google Hesabı oluşturmanız gerekir.
    • İş veya okul hesabı yerine kişisel hesap kullanıyorsanız İş ve okul hesaplarında, bu laboratuvar için gereken API'leri etkinleştirmenizi engelleyen kısıtlamalar olabilir.
  2. Google Cloud Console'da oturum açın.
  3. Cloud Console'da faturalandırmayı etkinleştirin.
    • Bu laboratuvarı tamamlamak için 1 ABD dolarından daha az değerde bulut kaynağı kullanmanız gerekir.
    • Daha fazla ücret ödememek için bu laboratuvarın sonundaki adımları uygulayarak kaynakları silebilirsiniz.
    • Yeni kullanıcılar 300 ABD doları değerindeki ücretsiz deneme sürümünden yararlanabilir.
  4. Yeni bir proje oluşturun veya mevcut bir projeyi yeniden kullanmayı seçin.
    • Proje kotasıyla ilgili bir hata görürseniz mevcut bir projeyi yeniden kullanın veya yeni bir proje oluşturmak için mevcut bir projeyi silin.

Cloud Shell'i Başlatma

Bu codelab'de, Google Cloud CLI (gcloud), Python ve curl önceden yüklenmiş olarak gelen tarayıcı tabanlı bir komut satırı ortamı olan Cloud Shell'i kullanacaksınız.

  1. Google Cloud konsolunda, üst gezinme çubuğunda Cloud Shell'i etkinleştir'i tıklayın. İstenirse Yetkilendir'i tıklayın.
  2. Proje kimliğinizi ve dağıtım bölgenizi dışa aktarın ve gcloud aracını $PROJECT_ID kullanacak şekilde yapılandırın. YOUR_PROJECT_ID ifadesini proje kimliğinizle değiştirin ve isteğe bağlı olarak us-west1 ifadesini başka bir Cloud Run bölgesiyle değiştirin:
export PROJECT_ID="YOUR_PROJECT_ID"
export REGION="us-west1"
gcloud config set project "$PROJECT_ID"
  1. Proje numaranızı ve etkin Google Cloud hesabınızı dışa aktarın ve dört değişkenin de doldurulduğunu onaylayı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"

gcloud'u güncelleme ve API'leri etkinleştirme

  1. Ortam Ağı ve Express Link için en yeni beta komutlarına sahip olmak üzere gcloud bileşenlerinizi güncelleyin:
gcloud components update --quiet
  1. Cloud Run kaynak dağıtımları, IAM hizmet hesapları, Ambient Networking ve Network Services Express Link için gerekli Google Cloud API'lerini etkinleştirin:
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

Çalışma alanı dizini oluşturma

Bu codelab'de oluşturacağınız üç hizmet klasörünü barındıracak bir çalışma dizini oluşturun:

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

3. Özel hedef hizmetini dağıtma

Öncelikle destination adlı özel bir Cloud Run hizmeti dağıtacaksınız. Bu tek hedef hizmeti, codelab'in her iki bölümünde de kullanacaksınız:

  • Hedef hizmet hiçbir zaman giden jeton ekleme işlemi gerçekleştirmez.
  • Hedef hizmetin, Express Link üzerinden trafik almak için Ambient Networking'i etkinleştirmesi gerekmez.
  1. Hedef hizmet için özel bir IAM hizmet hesabı oluşturun:
gcloud iam service-accounts create destination-identity \
    --display-name="Cloud Run destination service account"
  1. destination klasörü oluşturun ve dosyayı bu klasöre taşıyın:
mkdir -p ~/express-link-codelab/destination
cd ~/express-link-codelab/destination
  1. Flask ve Gunicorn ile bir requirements.txt dosyası oluşturmak için aşağıdaki komutu çalıştırın:
cat << 'EOF' > requirements.txt
Flask==3.0.0
gunicorn==21.2.0
EOF
  1. Aşağıdaki komutu çalıştırarak K_SERVICE ortam değişkeninden Cloud Run hizmet adını döndüren bir /ping uç noktasını gösteren bir main.py dosyası oluşturun:
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. Cloud Run'ın kimliği doğrulanmamış istekleri reddetmesi için destination hizmetini --no-allow-unauthenticated ile kaynaktan dağıtın:
gcloud run deploy destination \
    --source . \
    --region="$REGION" \
    --service-account="destination-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --no-allow-unauthenticated
  1. Hedef hizmetin belirlenimci URL'sini ve tam kaynak URI'sini ortam değişkenlerinde depolayın:
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. Doğrudan Cloud Shell'den test edebilmek için kullanıcı hesabınıza destination üzerinde Cloud Run Çağırıcısı (roles/run.invoker) rolünü verin:
gcloud run services add-iam-policy-binding destination \
    --member="user:$ACTIVE_ACCOUNT" \
    --role="roles/run.invoker" \
    --region="$REGION"
  1. destination hizmetinin çalıştığını doğrulamak için kendi kimlik jetonunuzu kullanarak /ping hizmetine kimliği doğrulanmış bir istek gönderin:
TOKEN=$(gcloud auth print-identity-token)
curl -H "Authorization: Bearer $TOKEN" "$DESTINATION_URL/ping"

Aşağıdaki yanıtı görmeniz gerekir:

Hello from destination

4. Hedefi Express Link olmadan arama

Express Link'i kullanmaya başlamadan önce, hizmetler arası kimlik doğrulamanın günümüzde ne gerektirdiğini görmek ve arayan bir hizmetin destination hizmetine erişebildiğini doğrulamak için caller-oidc oluşturun. Express Link olmadan destination ile güvenli bir şekilde bağlantı kurmak için iki katman yapılandırmanız gerekir:

  • IAM yetkilendirmesi: destination üzerinde caller-oidc hizmet hesabına roles/run.invoker rolünü verin.
  • Uygulama düzeyinde jeton ekleme: google-auth kitaplığını caller-oidc uygulamasına ekleyin ve kök OIDC kitlesini ayıklamak için hedef URL'yi ayrıştırın. Ardından meta veri sunucusundan imzalı bir kimlik jetonu alın ve giden HTTPS isteğine Authorization: Bearer ID_TOKEN ekleyin.

caller-oidc uygulamasını yapılandırmak ve dağıtmak için aşağıdaki adımları uygulayın:

  1. caller-oidc için özel bir hizmet hesabı oluşturun:
gcloud iam service-accounts create caller-oidc-identity \
    --display-name="Cloud Run OIDC caller service account"
  1. caller-oidc-identity adlı asistanın destination adlı asistanı çağırmasına izin verin:
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. destination ile birlikte caller-oidc dizinini oluşturun:
mkdir -p ~/express-link-codelab/caller-oidc
cd ~/express-link-codelab/caller-oidc
  1. requirements.txt dosyası oluşturmak için aşağıdaki komutu çalıştırın. Uygulama kapsayıcınızda jeton alma işlemini gerçekleştirmek için özellikle google-auth eklemeniz gerektiğini unutmayın:
cat << 'EOF' > requirements.txt
Flask==3.0.0
google-auth==2.23.0
requests==2.31.0
gunicorn==21.2.0
EOF
  1. Manuel OIDC jetonu ekleme işlemiyle bir main.py dosyası oluşturmak için aşağıdaki komutu çalıştırın:
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 uygulamasını Cloud Run'a dağıtma:
gcloud run deploy caller-oidc \
    --source . \
    --region="$REGION" \
    --service-account="caller-oidc-identity@${PROJECT_ID}.iam.gserviceaccount.com" \
    --no-allow-unauthenticated
  1. Kullanıcı hesabınıza caller-oidc işlevini çağırma izni verin:
gcloud run services add-iam-policy-binding caller-oidc \
    --member="user:$ACTIVE_ACCOUNT" \
    --role="roles/run.invoker" \
    --region="$REGION"
  1. caller-oidc için belirlenmiş URL'yi depolayın ve HTTPS URL'sini ($DESTINATION_URL/ping) target_url olarak ileterek çağırın:
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 adresinden başarılı bir yanıt almanız gerekir:

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

5. Express Link için arayan hizmetini dağıtma

Şimdi, kardeş dizinde caller-express-link adlı ikinci bir arayan hizmeti oluşturacaksınız. Express Link ile caller-express-link, jeton ekleme koduna ihtiyaç duymaz ve doğrudan requests.get(target_url, timeout=10) hizmetini çağırır.

  1. caller-express-link için özel bir hizmet hesabı oluşturun:
gcloud iam service-accounts create caller-express-link-identity \
    --display-name="Cloud Run Express Link caller service account"
  1. Yönetilen Ambient Networking sepetinin Express Link yönlendirme ve güvenlik yapılandırmasını indirebilmesi için caller-express-link-identity hizmet hesabına roles/trafficdirector.client rolünü verin. Ayrıca, sepetin izleme aralıklarını dışa aktarabilmesi için roles/cloudtrace.agent rolünü de verin:
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-oidc ile birlikte caller-express-link dizinini oluşturun:
mkdir -p ~/express-link-codelab/caller-express-link
cd ~/express-link-codelab/caller-express-link
  1. google-auth olmadan bir requirements.txt dosyası oluşturmak için aşağıdaki komutu çalıştırın:
cat << 'EOF' > requirements.txt
Flask==3.0.0
requests==2.31.0
gunicorn==21.2.0
EOF
  1. Düz bir requests.get(target_url, timeout=10) çağrısı içeren ve jeton yerleştirme mantığı olmayan bir main.py dosyası oluşturmak için aşağıdaki komutu çalıştırın:
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. Elediğiniz kimlik doğrulama şablonunu görmek için ../caller-oidc/main.py üzerinde diff komutunu çalıştırın:
diff -u ../caller-oidc/main.py main.py || true
  1. caller-express-link'i gcloud beta run deploy kullanarak --ambient-networking ve --ambient-scope=global etkinleştirilmiş şekilde dağıtın:
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 cihazında Ortam Ağı'nın etkin olduğunu doğrulayın:
gcloud run services describe caller-express-link --region="$REGION"

Düzeltme özetinin sonunda Ambient Networking ve Ambient Scope değerlerinin göründüğünü doğrulayın:

  Ambient Networking: Enabled
  Ambient Scope:     global
  1. Kullanıcı hesabınıza caller-express-link işlevini çağırma izni verin ve caller-express-link-identity hizmetini destination işlevini çağıracak şekilde yetkilendirin:
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 öğesinin URL'sini ve kaynak URI'sini, destination öğesinin HTTP (http://) deterministik URL'siyle birlikte depolayın:
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. Express Link oluşturmadan önce caller-express-link üzerinden destination numarasını arayarak test edin:
TOKEN=$(gcloud auth print-identity-token)
curl -H "Authorization: Bearer $TOKEN" "$CALLER_EL_URL/?target_url=$DESTINATION_HTTP_URL/ping"

Beklendiği gibi, isteği yakalayacak ve kimlik bilgilerini ekleyecek bir Express Link henüz mevcut olmadığından çağrı 403 Forbidden ile başarısız olur:

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. Hizmetleri Express Link ile bağlama

Şimdi, tek bir kod satırını değiştirmeden veya Cloud Run hizmetlerinden birini yeniden dağıtmadan caller-express-link (kaynak hizmet) ile destination arasında bağlantı kuran bir ExpressLink kaynağı tanımlayacaksınız.

  1. global konumunda Express Link kaynağını oluşturun:
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. Kaynağın mevcut olduğunu doğrulamak için Express Link'lerinizi listeleyin:
gcloud beta network-services express-links list --location=global

Komut çıkışı:

NAME
caller-to-destination
  1. Express Link yapılandırma ayrıntılarını inceleyin:
gcloud beta network-services express-links describe caller-to-destination --location=global

Komut çıkışı:

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. caller-express-link için aynı curl isteğini yeniden çalıştırın:
TOKEN=$(gcloud auth print-identity-token)
curl -H "Authorization: Bearer $TOKEN" "$CALLER_EL_URL/?target_url=$DESTINATION_HTTP_URL/ping"

Bu kez Ambient sepeti, destination adresine gönderilen HTTP isteğini yakalar, caller-express-link-identity için kimlik jetonunu ekler, bağlantıyı TLS'ye yükseltir ve hedefin yanıtını döndürür:

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

Aşağıdaki tabloda, caller-oidc ile caller-express-link arasındaki değişiklikler özetlenmiştir:

Boyut

Express Link olmadan (caller-oidc)

Express Link ile (caller-express-link)

requirements.txt içindeki Auth kitaplıkları

google-auth gerektirir

Hiçbiri (yalnızca Flask, requests, gunicorn)

main.py dilinde giden arama

Kitle URL'sini ayrıştırın, id_token.fetch_id_token() yöntemini çağırın, Authorization: Bearer başlığını ekleyin

Sade requests.get(target_url, timeout=10)

Uygulamadaki hedef URL şeması

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

http://destination-PROJECT_NUMBER.REGION.run.app (Ambient sidecar tarafından TLS'ye yükseltildi)

Arayan Cloud Run yapılandırması

Standart dağıtım

Arayan hizmet hesabında --ambient-networking --ambient-scope=global + roles/trafficdirector.client

Hedef Cloud Run yapılandırması

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

Değişmedi (--no-allow-unauthenticated + roles/run.invoker)

7. Temizleme

Google Cloud hesabınızda sürekli ücretlendirme olmaması için bu codelab sırasında oluşturduğunuz kaynakları silin.

  1. Express Link kaynağını silin:
gcloud beta network-services express-links delete caller-to-destination --location=global --quiet
  1. Üç Cloud Run hizmetini silin:
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. Proje düzeyindeki IAM politikası bağlamalarını kaldırın ve üç hizmet hesabını silin:
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. (İsteğe bağlı) Yalnızca bu codelab için özel bir Google Cloud projesi oluşturduysanız projenin tamamını silebilirsiniz:
# Run only if you want to delete the entire project and all its resources
gcloud projects delete "$PROJECT_ID"

8. Tebrikler

Özel bir Cloud Run arka uç hizmeti dağıttınız ve Python'da manuel OIDC jetonu ekleme yöntemini kullanarak bu hizmeti çağırdınız. Ardından, uygulama düzeyindeki tüm kimlik doğrulama kodunu açıklayıcı bir Cloud Run Express Link ile değiştirdiniz.

Öğrendikleriniz

  • Manuel OIDC jetonu ekleme işlemi, uygulama iş mantığını platform kimlik doğrulama kitaplıklarına ve güvenlik modlarına neden bağlar?
  • Express Link ile veya Express Link olmadan aynı şekilde çalışan kimliği doğrulanmış bir Cloud Run hedef hizmetini dağıtma
  • Çağrı yapan bir Cloud Run hizmetinde Ambient Networking'i (--ambient-scope=global ile --ambient-networking) etkinleştirme ve Traffic Director istemci izinlerini (roles/trafficdirector.client) verme
  • Kimlik jetonlarını otomatik olarak ekleyen ve kapsayıcınızdan gelen düz metin http:// çağrılarını şifrelenmiş TLS bağlantılarına yükselten bir ağ hizmetleri ExpressLink kaynağı oluşturma ve inceleme

Sonraki adımlar