1. Обзор
При создании микросервисов или мультиагентных приложений в Cloud Run внутренние бэкенд-службы не должны быть доступны в общедоступном интернете. Вместо этого вы настраиваете каждую бэкенд-службу так, чтобы требовалась аутентификация (--no-allow-unauthenticated), и предоставляете роль IAM Cloud Run Invoker (roles/run.invoker) только авторизованным вызывающим объектам.
Обычно для вызова сервиса Cloud Run, требующего аутентификации, вызывающее приложение должно выполнить ручную вставку токена в код. Перед отправкой HTTP-запроса ваш код запрашивает у сервера метаданных Compute токен идентификатора OpenID Connect (OIDC), подписанный Google. Этот токен привязан к URL аудитории целевого сервиса, и ваш код прикрепляет его к заголовку Authorization: Bearer. Написание и поддержка кода аутентификации в коде приложения создает ненужные сложности:
- Она связывает бизнес-логику с библиотеками аутентификации Google Cloud, снижая читаемость и переносимость между средами.
- Логика получения токена зависит от типа целевого сервиса и режима безопасности. Например, Cloud Run ожидает идентификационные токены OIDC, API Google – токены доступа OAuth 2.0, а mTLS требует связанных токенов.
Cloud Run Express Link (предварительная версия) позволяет не добавлять токен в код приложения вручную. Вы включаете Ambient Networking в вызывающем (исходном) сервисе Cloud Run и создаете декларативный ресурс ExpressLink, который связывает исходный сервис с целевым. Управляемый Google служебный прокси-сервер перехватывает исходящие текстовые HTTP-запросы к целевому сервису, автоматически добавляет токен идентификации вызывающего сервиса и шифрует подключение к целевому сервису.
В этой практической работе вы сравните оба подхода на примере одной и той же частной бэкенд-службы:
- Разверните сервис частного назначения и сервис вызывающего абонента (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 и веб-сервисов HTTP.
- Базовые знания о сервисных аккаунтах Google Cloud IAM и развертывании Cloud Run.
Что вы узнаете
- Как развернуть частный целевой сервис Cloud Run, который принудительно применяет аутентификацию IAM
- Как вручную выполнить аутентификацию запросов между сервисами в Python, используя токены идентификации OIDC
google-authс сервера метаданных, чтобы проверить базовое подключение - Как удалить код для получения токенов вручную и развернуть вызывающий сервис Cloud Run с включенной функцией Ambient Networking
- Как создать ссылку Cloud Run Express, чтобы вызывающий сервис мог вызывать целевой сервис, прошедший аутентификацию, без кода аутентификации
Что вы создадите
- destination – частный сервис Python Flask в Cloud Run, который предоставляет конечную точку
/ping. - caller-oidc – сервис Python Flask, который вызывает destination, вручную получая и внедряя идентификационные токены OIDC в код приложения.
- caller-express-link – параллельный сервис Python Flask без кода внедрения токенов, который вызывает тот же целевой сервис через Express Link.
Что вам понадобится
- Браузер, например Chrome.
- Проект Google Cloud с включенными платежными функциями и разрешениями на создание сервисных аккаунтов IAM, сервисов Cloud Run и ресурсов Network Services.
2. Как настроить среду
Как настроить проект Google Cloud
- Если у вас нет аккаунта Google, создайте его.
- Используйте личный аккаунт вместо рабочего или учебного. В рабочих и учебных аккаунтах могут быть ограничения, которые не позволят вам включить API, необходимые для этой лабораторной работы.
- Войдите в консоль Google Cloud.
- Включите оплату в Cloud Console.
- Выполнение этой лабораторной работы должно стоить менее 1 доллара США в ресурсах Cloud.
- Чтобы избежать дальнейших расходов, удалите ресурсы, следуя инструкциям в конце этой практической работы.
- Новые пользователи могут воспользоваться бесплатной пробной версией с бонусом в размере 300 долларов США.
- Создайте новый проект или выберите существующий.
- Если вы видите ошибку, связанную с квотой на проекты, используйте существующий проект или удалите его, чтобы создать новый.
Запустить Cloud Shell
В этой практической работе вы будете использовать 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 и включите API
- Обновите компоненты
gcloud, чтобы получить последние командыbetaдля Ambient Networking и Express Link:
gcloud components update --quiet
- Включите необходимые API Google Cloud для развертываний источников 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
Создайте каталог рабочей области
Создайте рабочий каталог, в котором будут храниться три папки сервисов, которые вы создадите в ходе этой практической работы:
mkdir -p ~/express-link-codelab
cd ~/express-link-codelab
3. Разверните сервис частных целевых ресурсов
Сначала вы развернете частный сервис Cloud Run с названием destination. Вы будете использовать этот сервис целевой страницы для обеих частей практической работы:
- Целевой сервис никогда не выполняет внедрение исходящих токенов.
- Для получения трафика по 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
- Сохраните детерминированный 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"
- Назначьте своему аккаунту пользователя роль 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
4. Позвонить в пункт назначения без использования Express Link
Прежде чем внедрять Express Link, создайте caller-oidc, чтобы узнать, что требуется для аутентификации между сервисами, и убедиться, что вызывающий сервис может связаться с destination. Чтобы безопасно вызывать destination без Express Link, необходимо настроить два уровня:
- Авторизация IAM. Предоставьте сервисному аккаунту
caller-oidcрольroles/run.invokerвdestination. - Внедрение токена на уровне приложения. Добавьте библиотеку
google-authвcaller-oidcи проанализируйте целевой URL, чтобы извлечь корневую аудиторию 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"
- Сохраните детерминированный 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) выполняются напрямую.
- Создайте специальный сервисный аккаунт для
caller-express-link:
gcloud iam service-accounts create caller-express-link-identity \
--display-name="Cloud Run Express Link caller service account"
- Предоставьте
caller-express-link-identityрольroles/trafficdirector.client, чтобы управляемый сопутствующий сервис 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включена функция Ambient Networking:
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"
- Сохраните 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"
- Проверьте, как работает вызов
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.
- Создайте ресурс 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"
- Чтобы убедиться, что ресурс существует, посмотрите список Express Links:
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 перехватывает 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 ( |
Библиотеки аутентификации в | Требуется столбец " | Нет (только |
Исходящий вызов в | Выполнить синтаксический анализ URL аудитории, вызвать | Простой |
Схема целевого URL в приложении |
|
|
Конфигурация вызывающего абонента Cloud Run | Стандартное развертывание |
|
Конфигурация целевого сервиса Cloud Run |
| Без изменений ( |
7. Организовать
Чтобы избежать постоянных списаний средств с вашего аккаунта Google Cloud, удалите ресурсы, созданные в ходе этой практической работы.
- Удалите ресурс 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 специально для этой практической работы, вы можете удалить весь проект.
# 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-networkingс--ambient-scope=global) и предоставить разрешения клиента Traffic Director (roles/trafficdirector.client) вызывающему сервису Cloud Run - Как создать и проверить ресурс Network Services
ExpressLink, который автоматически внедряет токены идентификации и преобразует вызовыhttp://в виде обычного текста из контейнера в зашифрованные подключения TLS.
Дальнейшие действия
- Прочитайте статью Аутентификация между сервисами в документации Cloud Run.
- Последние новости о функциях Ambient Networking и Express Link можно найти в примечаниях к выпуску Cloud Run.