Ringkasan kebijakan IAM

Anda dapat membuat kebijakan izinkan dan kebijakan tolak IAM yang digunakan Agent Gateway untuk mengatur komunikasi berbasis agen secara aman antara agen Anda dan layanan lain, termasuk agen lain, server MCP, dan endpoint. Agent Gateway menggunakan Identity-Aware Proxy (IAP) untuk menerapkan kebijakan. IAP juga menerapkan keamanan otorisasi dan autentikasi identitas agen end-to-end.

Untuk membuat kebijakan IAM untuk Agent Gateway, lihat Membuat kebijakan IAM.

Anda juga dapat membuat Batas Akses Principal (PAB) pada identitas agen. Agent Gateway dapat menggunakan IAP untuk menerapkan kebijakan Batas Akses Principal.

Mengaktifkan Agent Gateway

Untuk menggunakan kebijakan komunikasi agentik, Anda harus menyiapkan Agent Gateway.

Sebaiknya konfigurasikan Agent Gateway dalam mode uji coba (DRY_RUN) di lingkungan staging untuk memverifikasi bahwa kebijakan Anda berfungsi seperti yang diharapkan. Dalam mode uji coba, IAP mencatat komunikasi agentik yang tidak diizinkan ke Cloud Audit Logs, tetapi tidak memblokirnya.

Jika sudah yakin bahwa kebijakan berfungsi dengan benar, Anda dapat memperbarui konfigurasi Agent Gateway untuk menyetel mode penerapan ke ENFORCE. Dalam mode ini, komunikasi yang dilakukan agen yang melanggar kebijakan tidak diizinkan dan komunikasi ke resource diblokir.

Komponen kebijakan

Kebijakan memiliki komponen berikut:

• Agen: Dalam kebijakan izin IAM Anda, agen sumber ditentukan berdasarkan identitas agennya (identitas agen yang memulai komunikasi dengan layanan). Untuk mempelajari cara berbagai jenis agen menerima identitas, lihat Identitas agen. Identitas agen diwakili oleh ID utama yang berisi identitas agen berformat SPIFFE—misalnya, principal://agents.global.org-.... Perhatikan bahwa ID agen dalam format URN (seperti urn:agent:...) hanya digunakan untuk pencarian inventaris dan katalog, serta tidak digunakan dalam binding kebijakan IAM. Saat Anda menggunakan gcloud CLI untuk mengonfigurasi kebijakan IAM, akun utama agen adalah anggota yang Anda beri akses.

  Agen Gemini Enterprise dan instance Agent Runtime otomatis diberi ID Agen dan didaftarkan di Agent Registry.

• Resource Agent Registry: Layanan Agent Registry yang aksesnya Anda izinkan atau tolak. Dalam kebijakan izinkan dan tolak IAM, layanan Agent Registry disebut sebagai resource. Resource dapat berupa seluruh registry dalam project atau layanan individual, yang dapat berupa server MCP, agen, atau endpoint.

  Setiap layanan harus didaftarkan di Agent Registry sebelum dapat dirujuk dalam kebijakan IAM. Pendaftaran ini divalidasi pada waktu pengikatan (saat pengikatan kebijakan dibuat atau diperbarui). Jika Anda mereferensikan layanan yang tidak terdaftar, pembuatan kebijakan akan langsung gagal dengan error entity yang diminta tidak ditemukan (NOT_FOUND).

  Saat Anda mengonfigurasi kebijakan menggunakan gcloud CLI atau Terraform, resource target ditentukan oleh ID atau jalur yang dibuat oleh registri (menggunakan flag seperti --agent, --endpoint, atau --mcp-server), bukan ID URN logisnya. Saat runtime, gateway keamanan mencocokkan tujuan traffic berdasarkan nama host persisnya, bukan menggunakan URN.

  Jika Anda meregionalkan pendaftaran agen, kebijakan izin IAM Anda hanya berlaku untuk resource yang ada di region pendaftaran.

• Peran: Kebijakan komunikasi agentik selalu memberikan peran Egressor yang diamankan IAP (roles/iap.egressor) pada resource layanan.

• Kondisi: Anda dapat secara opsional mengonfigurasi kondisi pada kebijakan izin IAM untuk lebih membatasi apa yang dapat diakses agen. Di konsol Cloud de Confiance , Anda dapat menggunakan Pembuat kondisi untuk membuat kondisi dengan memilih elemen UI. Atau, Anda dapat menggunakan Editor kondisi untuk memasukkan kondisi yang lebih kompleks sebagai ekspresi Common Expression Language (CEL).

  Tabel berikut mencantumkan nama atribut yang dapat Anda gunakan untuk membuat ekspresi CEL. Karena gaya akses kolom langsung (seperti request.mcp.toolName) tidak didukung, Anda harus menggunakan fungsi api.getAttribute() untuk mengambil nilai setiap atribut.

  Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi kebijakan izin dengan kondisi, lihat Mengonfigurasi kebijakan agen IAM.

  Nama atribut	Deskripsi dan contoh CEL
  mcp.toolName	Nama alat tertentu yang dipanggil. Misalnya: request.mcp.toolName == 'GetCalendarEvents'
  iap.googleapis.com/mcp.resourceName	Nama resource yang diakses. Contoh: api.getAttribute('iap.googleapis.com/mcp.resourceName', '') == 'my-resource'
  iap.googleapis.com/mcp.promptName	Nama perintah yang digunakan. Contoh: api.getAttribute('iap.googleapis.com/mcp.promptName', '') == 'my-prompt'
  mcp.method	Operasi MCP tertentu (misalnya, tools/call, resources/read).
  iap.googleapis.com/mcp.tool.isReadOnly iap.googleapis.com/mcp.tool.isDestructive iap.googleapis.com/mcp.tool.isIdempotent iap.googleapis.com/mcp.tool.isOpenWorld	Flag Boolean yang menunjukkan jenis operasi. Contoh: api.getAttribute('iap.googleapis.com/mcp.tool.isReadOnly', false) == true
  request.auth.type	Enum yang menunjukkan protokol (misalnya, 'MCP').

Membuat kebijakan

Di halaman Policies di konsol Cloud de Confiance , Anda membuat kebijakan izin dan kebijakan penolakan IAM yang digunakan Agent Gateway untuk mengatur komunikasi agentik.

Di gcloud CLI, Anda dapat mengonfigurasi kebijakan izin IAM dan penolakan IAM yang digunakan Agent Gateway untuk mengatur komunikasi berbasis agen.

Kebijakan di konsol Cloud de Confiance

Untuk membuat kebijakan IAM menggunakan Cloud de Confiance konsol, lihat Mengonfigurasi kebijakan IAM.

Kebijakan di gcloud CLI

Untuk membuat kebijakan IAM menggunakan gcloud CLI, lihat Mengonfigurasi kebijakan IAM.

Autentikasi dan otorisasi end-to-end

IAP dan Akses Kontekstual menyediakan autentikasi dan otorisasi identitas agen end-to-end default menggunakan protokol berikut:

• mutual TLS (mTLS)
• Menunjukkan Bukti Kepemilikan (DPoP)

Identitas agen disediakan dengan sertifikat X.509 dan token terikat sertifikat. IAP memastikan bahwa identitas agen menggunakan TLS timbal balik (mTLS) untuk melakukan autentikasi ke Agent Gateway. Saat gateway mengizinkan agen keluar dan mengakses API Cloud de Confiance , server MCP, agen lain, dan endpoint, agen akan mencoba mengakses di luar batas mTLS. Untuk membantu melindungi komunikasi, Akses Kontekstual menerapkan kebijakan Akses Kontekstual yang dikelola Google. Kebijakan ini mewajibkan DPoP untuk memvalidasi token terikat sertifikat yang terikat dengan identitas agen. Untuk mempelajari lebih lanjut cara Akses Kontekstual menyediakan keamanan mTLS dan DPoP end-to-end, lihat Keamanan agen Akses Kontekstual.

Langkah berikutnya