Mengonfigurasi kebijakan menggunakan konsol Google Cloud

Halaman ini memberikan petunjuk untuk mengonfigurasi kebijakan Otorisasi Biner menggunakan konsol Google Cloud. Atau, Anda dapat melakukan tugas ini menggunakan Google Cloud CLI atau REST API. Langkah ini adalah bagian dari menyiapkan Otorisasi Biner.

Kebijakan adalah sekumpulan aturan yang mengatur deployment satu atau beberapa image container.

Catatan: Halaman ini menjelaskan cara mengonfigurasi kebijakan untuk platform berbasis penampung yang didukung Binary Authorization, termasuk Google Kubernetes Engine (GKE), Distributed Cloud, Cloud Run, dan Cloud Service Mesh. Setelan kebijakan, seperti jenis aturan, parameter aturan, dan format parameter dapat bervariasi bergantung pada platform yang Anda gunakan. Oleh karena itu, setiap bagian di halaman ini mencantumkan platform tempat setelan berlaku. Pastikan setelan yang Anda gunakan didukung untuk platform Anda.

Sebelum memulai

1. Aktifkan Otorisasi Biner.

2. Aktifkan Otorisasi Biner untuk platform Anda:

   • Pengguna Google Kubernetes Engine (GKE): Buat cluster dengan Otorisasi Biner diaktifkan.

   • Pengguna Cloud Run: Aktifkan Otorisasi Biner di layanan Anda.

3. Jika Anda ingin menggunakan pernyataan, sebaiknya buat penanda tangan sebelum mengonfigurasi kebijakan. Anda dapat membuat pengautentikasi menggunakan konsol Google Cloud atau melalui alat command line.

4. Pilih project ID untuk project tempat Anda mengaktifkan Otorisasi Biner.

Menetapkan aturan default

Bagian ini berlaku untuk GKE, GKE Multi-Cloud, Distributed Cloud, Cloud Run, dan Cloud Service Mesh.

Aturan adalah bagian dari kebijakan yang menentukan batasan yang harus dipenuhi image sebelum dapat di-deploy. Aturan default menentukan batasan yang berlaku untuk semua image container yang tidak dikecualikan yang tidak memiliki aturan khusus clusternya sendiri. Setiap kebijakan memiliki aturan default.

Untuk menetapkan aturan default, lakukan hal berikut:

1. Di konsol Google Cloud, buka halaman Otorisasi Biner.

   Buka halaman Otorisasi Biner

2. Klik tab Kebijakan.

3. Klik Edit Policy.

4. Tetapkan mode evaluasi untuk aturan default.

   Mode evaluasi menentukan jenis batasan yang diterapkan Otorisasi Biner saat deployment. Untuk menetapkan mode evaluasi, pilih salah satu opsi berikut:

   • Izinkan semua gambar: Mengizinkan semua gambar di-deploy.
   • Tolak semua gambar: Tidak mengizinkan semua gambar di-deploy.
   • Hanya izinkan image yang telah disetujui oleh pengautentikasi berikut: Mengizinkan image di-deploy jika image memiliki satu atau beberapa pengesahan yang dapat diverifikasi oleh semua pengautentikasi yang Anda tambahkan ke aturan ini. Untuk mempelajari cara membuat pengautentikasi, lihat Membuat pengautentikasi.

   Jika Anda memilih Hanya izinkan gambar yang telah disetujui oleh penguji berikut:

   1. Dapatkan nama atau ID resource attestor Anda.

      Di konsol Google Cloud, pada halaman Attester, Anda dapat melihat attestor yang ada, atau membuat yang baru.

      Buka halaman Attester Otorisasi Biner

   2. Klik Tambahkan Pengesah.

   3. Pilih salah satu opsi berikut:

      • Tambahkan menurut project dan nama attestor

        Project ini mengacu pada project ID project yang menyimpan penanda tangan Anda. Contoh nama pengautentikasi adalah build-qa.

      • Menambahkan menurut ID resource attestor

        ID resource memiliki format:

        projects/PROJECT_ID/attestors/ATTESTOR_NAME
        

   4. Di bagian Penanda tangan, masukkan nilai yang sesuai untuk opsi yang Anda pilih.

   5. Klik Tambahkan Pengesah Lainnya jika Anda ingin menambahkan pengesah tambahan.

   6. Klik Tambahkan Pengesah untuk menyimpan aturan.

Catatan: Sebaiknya jangan gunakan mode evaluasi Izinkan semua dalam aturan default. Tindakan ini memungkinkan semua image container di-deploy, kecuali jika image tersebut gagal memenuhi aturan khusus cluster atau aturan spesifik lainnya dalam kebijakan.

Jika Anda ingin mengaktifkan mode uji coba, lakukan hal berikut:

1. Pilih Mode Uji Coba.

2. Klik Simpan Kebijakan.

Catatan: Mungkin perlu waktu beberapa menit agar kebijakan diterapkan.

Menetapkan aturan khusus cluster (opsional)

Bagian ini berlaku untuk GKE, Distributed Cloud, dan Cloud Service Mesh.

Kebijakan juga dapat memiliki satu atau beberapa aturan khusus cluster. Jenis aturan ini berlaku untuk image container yang akan di-deploy ke cluster Google Kubernetes Engine (GKE) tertentu saja. Aturan khusus cluster adalah bagian opsional dari kebijakan.

Menambahkan aturan khusus cluster (GKE)

Bagian ini berlaku untuk GKE dan Distributed Cloud.

Untuk menambahkan aturan khusus cluster untuk cluster GKE, lakukan hal berikut:

1. Di konsol Google Cloud, buka halaman Otorisasi Biner.

   Buka halaman Otorisasi Biner

2. Klik tab Kebijakan.

3. Klik Edit Policy.

4. Luaskan bagian Setelan tambahan untuk deployment GKE dan GKE Enterprise.

5. Jika tidak ada jenis aturan spesifik yang ditetapkan, klik Buat Aturan Spesifik.

   1. Untuk memilih jenis aturan, klik Specific Rule Type.

   2. Untuk mengubah jenis aturan, klik Change.

6. Klik Add Specific Rule.

7. Di kolom Cluster resource ID, masukkan ID resource untuk cluster.

   ID resource untuk cluster memiliki format LOCATION.NAME, misalnya, us-central1-a.test-cluster.

8. Tetapkan mode evaluasi untuk aturan default.

   Mode evaluasi menentukan jenis batasan yang diterapkan Otorisasi Biner saat deployment. Untuk menetapkan mode evaluasi, pilih salah satu opsi berikut:

   • Izinkan semua gambar: Mengizinkan semua gambar di-deploy.
   • Tolak semua gambar: Tidak mengizinkan semua gambar di-deploy.
   • Hanya izinkan image yang telah disetujui oleh pengautentikasi berikut: Mengizinkan image di-deploy jika image memiliki satu atau beberapa pengesahan yang dapat diverifikasi oleh semua pengautentikasi yang Anda tambahkan ke aturan ini. Untuk mempelajari cara membuat pengautentikasi, lihat Membuat pengautentikasi.

   Jika Anda memilih Hanya izinkan gambar yang telah disetujui oleh penguji berikut:

   1. Dapatkan nama atau ID resource attestor Anda.

      Di konsol Google Cloud, pada halaman Attester, Anda dapat melihat attestor yang ada, atau membuat attestor baru.

      Buka halaman Attester Otorisasi Biner

   2. Klik Tambahkan Pengesah.

   3. Pilih salah satu opsi berikut:

      • Tambahkan menurut project dan nama attestor

        Project ini mengacu pada project ID project yang menyimpan penanda tangan Anda. Contoh nama pengautentikasi adalah build-qa.

      • Menambahkan menurut ID resource attestor

        ID resource memiliki format:

        projects/PROJECT_ID/attestors/ATTESTOR_NAME
        

   4. Di bagian Penanda tangan, masukkan nilai yang sesuai untuk opsi yang Anda pilih.

   5. Klik Tambahkan Pengesah Lainnya jika Anda ingin menambahkan pengesah tambahan.

   6. Klik Tambahkan Pengesah untuk menyimpan aturan.

9. Klik Tambahkan untuk menambahkan aturan khusus cluster.

   Anda mungkin melihat pesan yang bertuliskan, "Tampaknya cluster ini tidak ada. Aturan ini tetap akan berlaku jika cluster ini tersedia di GKE di masa mendatang." Jika demikian, klik Tambahkan lagi untuk menyimpan aturan.

10. Jika Anda ingin mengaktifkan mode uji coba, pilih Mode Uji Coba.

11. Klik Simpan Kebijakan.

Catatan: Mungkin perlu waktu beberapa menit agar kebijakan diterapkan.

Menambahkan aturan khusus cluster (GKE Multi-Cloud,Distributed Cloud)

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Bagian ini berlaku untuk Distributed Cloud.

Untuk menambahkan aturan khusus cluster untuk cluster GKE, lakukan hal berikut:

1. Di konsol Google Cloud, buka halaman Otorisasi Biner.

   Buka halaman Otorisasi Biner

2. Klik tab Kebijakan.

3. Klik Edit Policy.

4. Luaskan bagian Setelan tambahan untuk deployment GKE dan GKE Enterprise.

5. Jika tidak ada jenis aturan spesifik yang ditetapkan, klik Buat Aturan Spesifik.

   1. Untuk memilih jenis aturan, klik Specific Rule Type.

   2. Untuk memperbarui jenis aturan, klik Change.

6. Klik Add Specific Rule.

7. Di kolom Cluster resource ID, masukkan ID resource untuk cluster.

   • Untuk cluster terpasang GKE, dan GKE di AWS, formatnya adalah CLUSTER_LOCATION.CLUSTER_NAME—misalnya, us-central1-a.test-cluster.
   • Untuk Google Distributed Cloud dan Google Distributed Cloud, formatnya adalah FLEET_MEMBERSHIP_LOCATION.FLEET_MEMBERSHIP_ID—misalnya, global.test-membership.

8. Tetapkan mode evaluasi untuk aturan default.

   Mode evaluasi menentukan jenis batasan yang diterapkan Otorisasi Biner saat deployment. Untuk menetapkan mode evaluasi, pilih salah satu opsi berikut:

   • Izinkan semua gambar: Mengizinkan semua gambar di-deploy.
   • Tolak semua gambar: Tidak mengizinkan semua gambar di-deploy.
   • Hanya izinkan image yang telah disetujui oleh pengautentikasi berikut: Mengizinkan image di-deploy jika image memiliki satu atau beberapa pengesahan yang dapat diverifikasi oleh semua pengautentikasi yang Anda tambahkan ke aturan ini. Untuk mempelajari cara membuat pengautentikasi, lihat Membuat pengautentikasi.

   Jika Anda memilih Hanya izinkan gambar yang telah disetujui oleh penguji berikut:

   1. Dapatkan nama atau ID resource attestor Anda.

      Di konsol Google Cloud, pada halaman Attester, Anda dapat melihat attestor yang ada, atau membuat attestor baru.

      Buka halaman Attester Otorisasi Biner

   2. Klik Tambahkan Pengesah.

   3. Pilih salah satu opsi berikut:

      • Tambahkan menurut project dan nama attestor

        Project ini mengacu pada project ID project yang menyimpan penanda tangan Anda. Contoh nama pengautentikasi adalah build-qa.

      • Menambahkan menurut ID resource attestor

        ID resource memiliki format:

        projects/PROJECT_ID/attestors/ATTESTOR_NAME
        

   4. Di bagian Penanda tangan, masukkan nilai yang sesuai untuk opsi yang Anda pilih.

   5. Klik Tambahkan Pengesah Lainnya jika Anda ingin menambahkan pengesah tambahan.

   6. Klik Tambahkan Pengesah untuk menyimpan aturan.

9. Klik Tambahkan untuk menyimpan aturan.

   Anda mungkin melihat pesan yang bertuliskan "Tampaknya kluster ini tidak ada. Aturan ini tetap berlaku jika cluster yang ditentukan tersedia di GKE di masa mendatang." Dalam hal ini, klik Tambahkan lagi untuk menyimpan aturan.

10. Jika Anda ingin mengaktifkan mode uji coba, pilih Mode Uji Coba.

11. Klik Simpan Kebijakan.

Catatan: Mungkin perlu waktu beberapa menit agar kebijakan diterapkan.

Menambahkan aturan spesifik

Catatan: Fitur ini hanya dapat diaktifkan di cluster yang berjalan di rilis GKE berikut:

• 1.18.12-gke.700+
• 1.19.4-gke.700+
• 1.20.0-gke.600+
• 1.21+

Anda dapat membuat aturan yang dicakupkan ke identitas layanan mesh, akun layanan Kubernetes, atau namespace Kubernetes. Anda dapat menambahkan atau mengubah aturan tertentu sebagai berikut:

1. Di konsol Google Cloud, buka halaman Otorisasi Biner.

   Buka halaman Otorisasi Biner

2. Klik tab Kebijakan.

3. Klik Edit Policy.

4. Luaskan bagian Setelan tambahan untuk deployment GKE dan Anthos.

5. Jika tidak ada jenis aturan spesifik yang ditetapkan, klik Buat Aturan Spesifik.

   1. Klik Jenis Aturan Spesifik untuk memilih jenis aturan.

   2. Klik Ubah untuk memperbarui jenis aturan.

6. Jika jenis aturan tertentu ada, Anda dapat mengubah jenis aturan dengan mengklik Edit Type.

   Catatan: Anda dapat menetapkan satu jenis aturan spesifik per kebijakan. Jika jenis aturan diubah, aturan yang dibuat untuk jenis asli akan dihapus saat halaman kebijakan disimpan.

7. Untuk menambahkan aturan tertentu, klik Tambahkan Aturan Khusus. Bergantung pada jenis aturan yang Anda pilih, Anda harus memasukkan ID, sebagai berikut:

   • ASM Service Identity: Masukkan identitas layanan ASM Anda, yang memiliki format berikut: PROJECT_ID.svc.id.goog/ns/NAMESPACE/sa/SERVICE_ACCOUNT
   • Akun Layanan Kubernetes: Masukkan akun layanan Kubernetes Anda, yang memiliki format berikut: NAMESPACE:SERVICE_ACCOUNT.
   • Namespace Kubernetes: Masukkan namespace Kubernetes Anda, yang memiliki format berikut: NAMESPACE

   Ganti kode berikut, sesuai kebutuhan, bergantung pada jenis aturan:

   • PROJECT_ID: project ID tempat Anda menentukan resource Kubernetes.
   • NAMESPACE: namespace Kubernetes.
   • SERVICE_ACCOUNT: akun layanan.

8. Tetapkan mode evaluasi untuk aturan default.

   Mode evaluasi menentukan jenis batasan yang diterapkan Otorisasi Biner saat deployment. Untuk menetapkan mode evaluasi, pilih salah satu opsi berikut:

   • Izinkan semua gambar: Mengizinkan semua gambar di-deploy.
   • Tolak semua gambar: Tidak mengizinkan semua gambar di-deploy.
   • Hanya izinkan image yang telah disetujui oleh pengautentikasi berikut: Mengizinkan image di-deploy jika image memiliki satu atau beberapa pengesahan yang dapat diverifikasi oleh semua pengautentikasi yang Anda tambahkan ke aturan ini. Untuk mempelajari cara membuat pengautentikasi, lihat Membuat pengautentikasi.

   Jika Anda memilih Hanya izinkan gambar yang telah disetujui oleh penguji berikut:

   1. Dapatkan nama atau ID resource attestor Anda.

      Di konsol Google Cloud, pada halaman Attester, Anda dapat melihat attestor yang ada, atau membuat attestor baru.

      Buka halaman Attester Otorisasi Biner

   2. Klik Tambahkan Pengesah.

   3. Pilih salah satu opsi berikut:

      • Tambahkan menurut project dan nama attestor

        Project ini mengacu pada project ID project yang menyimpan penanda tangan Anda. Contoh nama pengautentikasi adalah build-qa.

      • Menambahkan menurut ID resource attestor

        ID resource memiliki format:

        projects/PROJECT_ID/attestors/ATTESTOR_NAME
        

   4. Di bagian Penanda tangan, masukkan nilai yang sesuai untuk opsi yang Anda pilih.

   5. Klik Tambahkan Pengesah Lainnya jika Anda ingin menambahkan pengesah tambahan.

   6. Klik Tambahkan Pengesah untuk menyimpan aturan.

9. Klik Mode uji coba untuk mengaktifkan mode uji coba.

10. Klik Tambahkan untuk menyimpan aturan tertentu.

11. Klik Simpan Kebijakan.

Catatan: Mungkin perlu waktu beberapa menit agar kebijakan diterapkan.

Mengelola gambar yang dikecualikan

Bagian ini berlaku untuk GKE, Distributed Cloud, Cloud Run, dan Cloud Service Mesh.

Gambar yang dikecualikan adalah gambar, yang ditentukan oleh jalur, yang dikecualikan dari aturan kebijakan. Otorisasi Biner selalu mengizinkan deployment image yang dikecualikan.

Jalur ini dapat menentukan lokasi di Container Registry atau registry image container lainnya.

Cloud Run

Bagian ini berlaku untuk Cloud Run.

Anda tidak dapat langsung menentukan nama gambar yang berisi tag. Misalnya, Anda tidak dapat menentukan IMAGE_PATH:latest.

Jika ingin menentukan nama gambar yang berisi tag, Anda harus menentukan nama gambar menggunakan karakter pengganti sebagai berikut:

• * untuk semua versi gambar tunggal; misalnya, us-docker.pkg.dev/myproject/container/hello@*
• ** untuk semua image dalam project; misalnya, us-docker.pkg.dev/myproject/**

Anda dapat menggunakan nama jalur untuk menentukan ringkasan dalam format IMAGE_PATH@DIGEST.

Mengaktifkan kebijakan sistem

Bagian ini berlaku untuk GKE dan Distributed Cloud.

Percayai semua image sistem yang disediakan Google adalah setelan kebijakan yang mengaktifkan kebijakan sistem Otorisasi Biner. Jika setelan ini diaktifkan pada waktu deployment, Otorisasi Biner akan mengecualikan daftar image sistem yang dikelola Google yang diperlukan oleh GKE dari evaluasi kebijakan lebih lanjut. Kebijakan sistem dievaluasi sebelum setelan kebijakan Anda yang lain.

Catatan: Sebaiknya pilih Trust all Google-provided system images. Dengan demikian, Google dapat mengelola daftar yang diizinkan untuk image sistem yang digunakan GKE. Google memperbarui daftar yang diizinkan ini dengan setiap rilis GKE. Jika tidak mengaktifkan setelan ini, Anda harus mengelola daftar yang diizinkan sendiri.

Untuk mengaktifkan kebijakan sistem, lakukan langkah berikut:

1. Buka halaman Binary Authorization di Konsol Google Cloud.

   Buka Otorisasi Biner

2. Klik Edit Policy.

3. Luaskan bagian Setelan tambahan untuk deployment GKE dan Anthos.

4. Pilih Percayai semua image sistem yang disediakan Google di bagian Pengecualian image sistem Google.

   Untuk melihat gambar yang dikecualikan oleh kebijakan sistem, klik Lihat Detail.

   Catatan: Informasi kebijakan sistem mungkin berbeda untuk sementara dari satu wilayah ke wilayah lain saat Google memperbarui daftar yang diizinkan. Daftar gambar yang ditampilkan berasal dari grup region terakhir yang diperbarui. Karena sebagian besar perubahan pada kebijakan sistem adalah penambahan, daftar ini menampilkan kumpulan image sistem yang saat ini diizinkan di semua region. Anda dapat melihat kebijakan sistem untuk region tertentu menggunakan perintah gcloud.

5. Untuk menentukan gambar tambahan yang dikecualikan secara manual, luaskan bagian Aturan pengecualian kustom di bagian Gambar yang dikecualikan dari kebijakan ini.

   Kemudian, klik Add Image Pattern dan masukkan jalur registry ke gambar tambahan yang ingin Anda kecualikan.

6. Klik Simpan Kebijakan.

Catatan: Mungkin perlu waktu beberapa menit agar kebijakan diterapkan.

Langkah selanjutnya

• Gunakan pengautentikasi built-by-cloud-build untuk hanya men-deploy image yang dibuat oleh Cloud Build (Pratinjau).
• Gunakan pengesahan.
• Men-deploy image GKE.
• Melihat peristiwa Cloud Audit Logs.
• Gunakan validasi berkelanjutan.
• Gunakan validasi berkelanjutan lama (tidak digunakan lagi) untuk memeriksa kepatuhan kebijakan.