Setiap subjek - pengguna atau grup - mengikuti proses dua langkah untuk mendapatkan akses ke server Management API dan cluster Kubernetes:
Akses server Management API: Beri subjek izin di server Management API menggunakan
ClusterRoleBindingatauRoleBindingkeClusterRoleyang telah ditentukan sebelumnya.Akses cluster Kubernetes: Berikan akses khusus namespace atau akses di seluruh cluster.
Untuk akses khusus namespace: Untuk memberikan akses ke namespace project tertentu dalam cluster, buat
ProjectRoledanProjectRoleBindingyang sesuai. Proses ini menyebarkanRoledanRoleBindingKubernetes keNamespaceKubernetes di cluster, yang sesuai denganProjectyang terkait denganProjectRoledanProjectRoleBinding.Untuk akses di seluruh cluster: Untuk memberikan akses ke semua namespace dalam cluster, buat
OrganizationRoledanOrganizationRoleBindingyang sesuai. Proses ini menyebarkanClusterRoledanClusterRoleBindingKubernetes ke seluruh cluster Kubernetes.
Halaman ini ditujukan bagi audiens dalam grup administrator platform yang mengelola izin dalam organisasi mereka.
Admin IAM Organisasi dan Admin IAM Project dapat membuat lebih banyak peran project dan binding peran project untuk memberikan izin tambahan khusus project. Namun, Admin IAM Organisasi dapat membuat peran project dan binding peran project untuk project apa pun. Di sisi lain, Admin IAM Project hanya dapat membuat peran project dan binding peran project untuk project yang izin aksesnya telah diberikan kepada mereka.
Sebelum memulai
Sebelum mengelola binding peran atau mencabut akses, Anda harus meminta izin yang diperlukan dan menyiapkan lingkungan Anda. Peran spesifik yang diperlukan bergantung pada apakah Anda mengelola binding peran atau mencabut akses pengguna.
Meminta peran IAM
Hubungi Admin IAM Organisasi Anda untuk meminta peran berdasarkan tugas yang perlu Anda lakukan:
- Admin IAM Organisasi (
organization-iam-admin): membuat, memperbarui, dan menghapus binding peran di tingkat organisasi dan project. - Admin Sesi Org. (
org-session-admin): mencabut sesi aktif dan akses pengguna dalam zona tertentu.
Menyiapkan lingkungan Anda
Untuk menggunakan alat command line guna mengelola binding peran atau mencabut akses, selesaikan penyiapan berikut.
- Download dan instal gdcloud CLI, jika Anda belum melakukannya.
- Untuk menggunakan API dengan
kubectl, penyiapan tambahan diperlukan:
Menyiapkan binding peran
Anda dapat menyiapkan binding peran yang memberi anggota tim akses ke resource di level organisasi atau project.
Untuk mendapatkan izin yang diperlukan untuk menyiapkan binding peran, minta Admin IAM Organisasi Anda untuk memberi Anda peran Admin IAM Organisasi.
Untuk menetapkan peran kepada anggota yang diberi otorisasi, ikuti langkah-langkah berikut:
Konsol
- Login ke konsol GDC.
- Klik Pilih project untuk memilih organisasi atau project.
- Untuk menyiapkan binding peran bagi organisasi, pilih organisasi.
- Untuk menyiapkan binding peran untuk project, pilih project.
- Di menu navigasi, klik Identity and Access > Access.
- Klik Tambahkan anggota.
- Di daftar Penyedia identitas, pilih penyedia identitas.
- Pilih apakah Anda ingin menambahkan pengguna atau grup satu per satu.
- Di kolom Nama pengguna atau alias grup, masukkan nama pengguna, alamat email, atau alias.
- Dalam daftar Peran, pilih peran yang ingin Anda tetapkan kepada pengguna atau grup, seperti Organization Viewer di tingkat organisasi atau Project Creator di tingkat project.
- Klik Tambahkan.
Anggota akan muncul dalam daftar Anggota yang diizinkan.
gdcloud
Pastikan Anda telah menginstal gdcloud CLI.
Login menggunakan perintah
gdcloud auth loginuntuk melakukan autentikasi dengan penyedia identitas Anda. Untuk mengetahui informasi selengkapnya, lihat autentikasi gdcloud CLI.Siapkan binding peran.
Menyiapkan binding peran untuk organisasi:
gdcloud organizations add-iam-policy-binding root \ --member=USER_ACCOUNT \ --role=ROLE_TYPE/ROLEGanti variabel berikut:
USER_ACCOUNT: akun pengguna yang ingin Anda beri peran. Flag ini menerima alamat email pengguna dengan awalan penyedia identitas (user:idpprefix-user@example.com) atau nama akun layanan dengan project akun layanan (serviceAccount:projectName:serviceAccountName).ROLE_TYPE:ClusterRole,Role, atauOrganizationRoleyang binding perannya Anda siapkan.ROLE: nama peran bawaan atau kustom yang ingin Anda tetapkan kepada pengguna (sepertiproject-creator).
Siapkan binding peran untuk project:
gdcloud projects add-iam-policy-binding PROJECT \ --member=USER_ACCOUNT \ --role=ROLE_TYPE/ROLEGanti variabel berikut:
PROJECT: nama project yang konfigurasi pengikatan perannya Anda lakukan.USER_ACCOUNT: akun pengguna yang ingin Anda beri peran. Flag ini menerima alamat email pengguna dengan awalan penyedia identitas (user:idpprefix-user@example.com) atau nama akun layanan dengan project akun layanan (serviceAccount:projectName:serviceAccountName).ROLE_TYPE:RoleatauProjectRoleyang binding perannya Anda siapkan.ROLE: nama peran bawaan atau kustom yang ingin Anda tetapkan kepada pengguna (sepertiproject-viewer).
API
Ekspor variabel lingkungan untuk binding peran:
export YOUR_IAM_ADMIN_KUBECONFIG=YOUR_IAM_ADMIN_KUBECONFIG export USERNAME=IDP_PREFIX-USERNAME export ROLE_NAME=ROLE_NAME export USER_EMAIL=IDP_PREFIX-USER_EMAILGanti kode berikut:
YOUR_IAM_ADMIN_KUBECONFIG: jalur ke file kubeconfig untuk administrator IAM.IDP_PREFIX: awalan penyedia identitas.USERNAME: bagian nama pengguna dari alamat email pengguna sebelum simbol@(sepertipauldaripaul@example.com).ROLE_NAME: nama peran yang dibutuhkan pengguna (sepertiproject-creator). Lihat Definisi peran untuk mengetahui detail tentang peran.USER_EMAIL: alamat email akun pengguna yang ingin Anda tetapkan perannya (sepertipaul@example.com).
Tetapkan pengguna ke
ClusterRole,Role,ProjectRole, atauOrganizationRole:Menetapkan pengguna ke
ClusterRole:kubectl create --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \ clusterrolebinding ${USERNAME}-${ROLE_NAME}-binding \ --clusterrole=${ROLE_NAME} --user=${USER_EMAIL}Untuk kasus ketika
ClusterRolememerlukanRoleBinding, bukanClusterRoleBinding, lihat Definisi peran untuk mengetahui jenis binding yang diperlukan peran dan buat RoleBinding di namespacegpc-system:kubectl create --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \ rolebinding ${USERNAME}-${ROLE_NAME}-binding \ --clusterrole=${ROLE_NAME} --user=${USER_EMAIL} --namespace=gpc-systemMenetapkan pengguna ke
Role:Ekspor namespace tempat binding harus dibuat:
export BINDING_NAMESPACE=BINDING_NAMESPACEJalankan perintah berikut untuk membuat
RoleBinding:kubectl create --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \ rolebinding ${USERNAME}-${ROLE_NAME}-binding \ --role=${ROLE_NAME} --user=${USER_EMAIL} --namespace=${BINDING_NAMESPACE}
Menetapkan pengguna ke
ProjectRole:Buat file
projectrolebinding.yaml:apiVersion: resourcemanager.gdc.goog/v1 kind: ProjectRoleBinding metadata: name: BINDING_NAME namespace: PROJECT_NAME spec: roleRef: apiGroup: resourcemanager.gdc.goog kind: ProjectRole name: ROLE_NAME subjects: - apiGroup: rbac.authorization.k8s.io kind: USER_KIND name: IDP_PREFIX-USER_EMAILGanti kode berikut:
BINDING_NAME: nama untuk binding yang dapat disesuaikan pengguna (sepertiuser-project-creator-binding).PROJECT_NAME: nama project yang perannya Anda berikan.ROLE_NAME: namaProjectRoleyang Anda tetapkan kepada pengguna.USER_KIND: jenis pengguna, yang dapat berupaUser,Group, atauServiceAccount.IDP_PREFIX: awalan penyedia identitas.USER_EMAIL: alamat email akun pengguna yang ingin Anda tetapkan perannya (sepertipaul@example.com).
Terapkan file
projectrolebinding.yaml:kubectl create -f projectrolebinding.yaml
Menetapkan pengguna ke
OrganizationRole:Buat file
organizationrolebinding.yaml:apiVersion: resourcemanager.gdc.goog/v1 kind: OrganizationRoleBinding metadata: name: BINDING_NAME namespace: gpc-system spec: roleRef: apiGroup: resourcemanager.gdc.goog kind: OrganizationRole name: ROLE_NAME subjects: - apiGroup: rbac.authorization.k8s.io kind: USER_KIND name: IDP_PREFIX-USER_EMAILGanti kode berikut:
BINDING_NAME: nama untuk binding yang dapat disesuaikan pengguna (sepertiuser-organization-creator-binding).ROLE_NAME: namaOrganizationRoleyang Anda tetapkan kepada pengguna.USER_KIND: jenis pengguna, yang dapat berupaUser,Group, atauServiceAccount.IDP_PREFIX: awalan penyedia identitas.USER_EMAIL: alamat email akun pengguna yang ingin Anda tetapkan perannya (sepertipaul@example.com).
Terapkan file YAML
organizationrolebinding.yaml:kubectl create -f organizationrolebinding.yaml
Menghapus binding peran
Jika akses tidak lagi diperlukan, hapus anggota dan peran, izin, serta akses terkaitnya.
Untuk menghapus anggota, ikuti langkah-langkah berikut:
Konsol
- Login ke konsol GDC.
- Di menu navigasi, klik Identity and Access > Access.
- Dalam daftar Anggota yang diberi otorisasi, pilih anggota.
- Klik Hapus anggota.
- Saat diminta, klik Hapus anggota untuk mengonfirmasi.
gdcloud
Pastikan Anda telah menginstal gdcloud CLI.
Login menggunakan perintah
gdcloud auth loginuntuk melakukan autentikasi dengan penyedia identitas Anda. Untuk mengetahui informasi selengkapnya, lihat autentikasi gdcloud CLI.Menghapus binding peran.
Menghapus binding peran untuk organisasi:
gdcloud organizations remove-iam-policy-binding root \ --member=USER_ACCOUNT \ --role=ROLE_TYPE/ROLEGanti variabel berikut:
USER_ACCOUNT: akun pengguna yang perannya ingin Anda hapus. Flag ini menerima alamat email pengguna dengan awalan penyedia identitas (user:idpprefix-user@example.com) atau nama akun layanan dengan project akun layanan (serviceAccount:projectName:serviceAccountName).ROLE_TYPE:ClusterRole,Role, atauOrganizationRoleyang binding perannya Anda hapus.ROLE: nama peran bawaan atau kustom yang ingin Anda hapus dari akun pengguna (sepertiproject-creator).
Menghapus binding peran untuk project:
gdcloud projects remove-iam-policy-binding PROJECT \ --member=USER_ACCOUNT \ --role=ROLE_TYPE/ROLEGanti variabel berikut:
PROJECT: nama project tempat Anda menghapus binding peran.USER_ACCOUNT: akun pengguna yang perannya ingin Anda hapus. Flag ini menerima alamat email pengguna dengan awalan penyedia identitas (user:idpprefix-user@example.com) atau nama akun layanan dengan project akun layanan (serviceAccount:projectName:serviceAccountName).ROLE_TYPE:RoleatauProjectRoleyang binding perannya akan Anda hapus.ROLE: nama peran bawaan atau kustom yang ingin Anda hapus dari akun pengguna (sepertiproject-viewer).
API
Ekspor variabel lingkungan untuk binding peran:
export YOUR_IAM_ADMIN_KUBECONFIG=YOUR_IAM_ADMIN_KUBECONFIG export USERNAME=IDP_PREFIX-USERNAME export BINDING_NAMESPACE=BINDING_NAMESPACEGanti kode berikut:
YOUR_IAM_ADMIN_KUBECONFIG: jalur ke file kubeconfig untuk administrator IAM.IDP_PREFIX: awalan penyedia identitas.USERNAME: bagian nama pengguna dari alamat email pengguna sebelum simbol@(sepertipauldaripaul@example.com).BINDING_NAMESPACE: namespace tempat binding dihapus.
Hapus
ClusterRoleBinding,RoleBinding,ProjectRoleBinding, atauOrganizationRoleBindinguntuk mencabut izin yang diberikan kepada akun pengguna:Menghapus
ClusterRoleBindingdari akun pengguna:kubectl --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \ delete clusterrolebinding ${USERNAME}-paMenghapus
RoleBindingdari akun pengguna:kubectl --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \ delete rolebinding ${USERNAME}-pa \ --namespace=${BINDING_NAMESPACE}Menghapus
ProjectRoleBindingdari akun pengguna:kubectl --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \ delete projectrolebinding ${USERNAME}-pa \ --namespace=${BINDING_NAMESPACE}Menghapus
OrganizationRoleBindingdari akun pengguna:kubectl --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \ delete organizationrolebinding ${USERNAME}-pa \ --namespace=gpc-system
Mencabut akses pengguna
Jika anggota keluar dari organisasi atau tim Anda, Anda dapat mencabut aksesnya ke perangkat air-gapped Google Distributed Cloud (GDC). Mencabut akses pengguna akan membuat pengguna tersebut logout dari appliance GDC dengan air gap dan menghapus peran serta izinnya. Anda juga dapat mencantumkan aktivitas dan sesi pengguna dari waktu mulai dan berakhirnya.
Untuk mencabut akses pengguna, lakukan hal berikut:
Dapatkan izin yang Anda perlukan untuk mencabut akses pengguna. Minta Admin IAM Organisasi Anda untuk memberi Anda peran Org Session Admin (
org-session-admin).Mencabut akses pengguna:
gdcloud admin auth revoke --accounts USER_EMAILGanti USER_EMAIL dengan email pengguna yang aksesnya akan dicabut.
Setelah menjalankan perintah, Anda akan melihat output yang mirip dengan berikut ini. Contoh ini mencabut akses dari pengguna
ariel@example.com:Success: NUMBER of sessions revoked for user ariel@example.comDalam contoh ini, variabel NUMBER merujuk pada jumlah sesi aktif yang dimiliki pengguna.
Konfirmasi bahwa Anda telah mencabut akses pengguna dengan menjalankan perintah
gdcloud admin auth revokelagi. Jika berhasil, Anda akan melihat berikut:No sessions found for account: ariel@example.com
Mencantumkan semua pengguna yang aksesnya dicabut
Untuk melihat semua pengguna yang aksesnya dicabut serta aktivitas dan sesi mereka, lakukan hal berikut:
Mencantumkan semua pengguna yang aksesnya dicabut dari waktu mulai dan berakhirnya:
gdcloud admin auth list --format="csv(ACCOUNT, IDENTITY_PROVIDER, CREATION_TIME, EXPIRATION_TIME)"Jika berhasil, Anda akan melihat output yang mirip dengan berikut ini:
account,identity_provider,creation_time,expiration_time ariel@example.com,example-idp,2023-02-15 22:10:52,2023-02-15 23:10:52