Menyiapkan penerapan kebijakan Otorisasi Biner

Otorisasi Biner untuk Google Distributed Cloud memungkinkan Anda memperluas penerapan waktu deployment Otorisasi Biner ke cluster pengguna lokal untuk membantu mengamankan workload container mereka. Anda dapat menerapkan aturan penerapan kebijakan yang dikonfigurasi dalam project Google Cloud ke cluster pengguna di versi 1.28 atau yang lebih baru. Untuk mengetahui informasi selengkapnya tentang kebijakan dan aturan, lihat Ringkasan Otorisasi Biner.

Jika Anda mengaktifkan rilis Pratinjau Otorisasi Biner untuk Google Distributed Cloud, nonaktifkan dan bersihkan resource sebelum mengaktifkan fitur GA di cluster versi 1.28 atau yang lebih baru.

Prasyarat

Sebelum dapat mengaktifkan penerapan kebijakan Otorisasi Biner untuk cluster pengguna, pastikan Anda telah memenuhi kriteria prasyarat berikut:

  • Daftarkan cluster ke fleet: Untuk cluster yang dibuat dengan gkectl, cluster tersebut didaftarkan ke project Google Cloud yang Anda tentukan di kolom gkeConnect.projectID dalam file konfigurasi cluster. Project ini disebut sebagai project host fleet. Untuk mempelajari lebih lanjut tentang fleet, termasuk kasus penggunaan, praktik terbaik, dan contoh, lihat dokumentasi Pengelolaan fleet.

  • Aktifkan Otorisasi Biner API di project Google Cloud Anda: aktifkan layanan Otorisasi Biner di project host fleet Anda.

  • Tambahkan peran Binary Authorization Policy Evaluator ke project host fleet Anda: Untuk memberikan peran Binary Authorization Policy Evaluator (roles/binaryauthorization.policyEvaluator) ke akun layanan Kubernetes di project host fleet Anda, jalankan perintah berikut:

    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member="serviceAccount:PROJECT_ID.[binauthz-system/binauthz-agent]" \
        --role="roles/binaryauthorization.policyEvaluator"
    

    Jika cluster Anda berjalan di balik server proxy, pastikan server proxy mengizinkan koneksi ke Binary Authorization API (binaryauthorization.googleapis.com). API ini menyediakan validasi dan kontrol deployment berbasis kebijakan untuk image yang di-deploy ke cluster Anda. Untuk mengetahui informasi selengkapnya, lihat Aturan proxy dan firewall.

Setelah memenuhi prasyarat, Anda dapat mengaktifkan (atau menonaktifkan) kebijakan Otorisasi Biner saat membuat cluster baru atau mengupdate cluster yang ada.

Mengaktifkan kebijakan Otorisasi Biner selama pembuatan cluster

Anda dapat mengaktifkan penerapan kebijakan Otorisasi Biner dengan gkectl atau gcloud CLI.

gkectl

Untuk mengaktifkan Otorisasi Biner saat Anda membuat cluster dengan gkectl:

  1. Sebelum membuat cluster, tambahkan binaryAuthorization.evaluationMode ke file konfigurasi cluster pengguna seperti yang ditunjukkan dalam contoh berikut:

    ...
    binaryAuthorization:
      evaluationMode: "project_singleton_policy_enforce"
    ...
    

    Nilai yang diizinkan untuk evaluationMode adalah:

    • project_singleton_policy_enforce: menerapkan aturan yang ditentukan dalam kebijakan Otorisasi Biner, yang juga dikenal sebagai kebijakan singleton project, pada project Google Cloud Anda untuk mengatur deployment image container di cluster Anda.

    • disabled: menonaktifkan penggunaan Otorisasi Biner untuk cluster Anda. Ini adalah nilai defaultnya. Jika Anda menghilangkan binaryAuthorization, fitur ini akan dinonaktifkan.

  2. Lakukan perubahan lain yang diperlukan dalam file konfigurasi cluster, lalu jalankan perintah gkectl create cluster.

Untuk mengetahui informasi selengkapnya tentang cara membuat cluster, lihat Ringkasan penginstalan Google Distributed Cloud.

Mengaktifkan atau menonaktifkan kebijakan Otorisasi Biner untuk cluster yang ada

Jika Anda memiliki cluster versi 1.28 atau yang lebih tinggi, Anda dapat mengaktifkan atau menonaktifkan Otorisasi Biner kapan saja, menggunakan gkectl atau gcloud CLI.

gkectl

  • Untuk mengaktifkan:

    1. Edit file konfigurasi cluster untuk menambahkan kolom binaryAuthorization:

      ...
      binaryAuthorization:
        evaluationMode: "project_singleton_policy_enforce"
      
    2. Update cluster:

      gkectl update cluster \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --config USER_CLUSTER_CONFIG_FILE \
        --force

      Ganti kode berikut:

      • ADMIN_CLUSTER_KUBECONFIG: jalur file kubeconfig cluster admin
      • USER_CLUSTER_CONFIG_FILE: jalur file konfigurasi cluster pengguna Anda.
    3. Tunggu hingga Deployment bernama binauthz-module-deployment di namespace binauthz-system siap.

      Saat deployment siap, Otorisasi Biner akan menerapkan aturan yang ditentukan dalam kebijakan Otorisasi Biner, yang juga dikenal sebagai kebijakan singleton project. Kebijakan ini dikaitkan dengan projectGoogle Cloud Anda dan menentukan aturan untuk mengatur deployment image container. Untuk mengetahui informasi selengkapnya tentang cara menggunakan gkectl untuk mengupdate cluster, lihat Mengupdate cluster. Untuk mengetahui informasi selengkapnya tentang kebijakan dan aturan Otorisasi Biner, lihat Ringkasan Otorisasi Biner.

  • Untuk menonaktifkan:

    1. Edit file konfigurasi cluster dan hapus bagian binaryAuthorization atau tetapkan evaluationMode ke disabled.

      ...
      binaryAuthorization:
        evaluationMode: "disabled"
      
    2. Update cluster:

      gkectl update cluster \
        --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
        --config USER_CLUSTER_CONFIG_FILE \
        --force

    Setelah Anda melakukan perubahan ini, tunggu beberapa menit hingga Deployment bernama binauthz-module-deployment di namespace binauthz-system dihapus.

Pemecahan masalah

Jika Anda tidak menyelesaikan semua prasyarat, Anda mungkin melihat pesan seperti berikut yang menunjukkan ada masalah dengan konfigurasi Otorisasi Biner:

failed to validate Binary Authorization policy

(1) Ensure the Binary Authorization API is enabled for your Google Cloud project:
    gcloud services enable binaryauthorization.googleapis.com --project=PROJECT_ID
(2) Ensure an IAM policy binding is in place granting binaryauthorization.policyEvaluator role to the binauthz-system/binauthz-agent Kubernetes service account:
    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member="serviceAccount:PROJECT_ID.[binauthz-system/binauthz-agent]" \
        --role=roles/binaryauthorization.policyEvaluator