Mengelola workload identity pool dan penyedia workload.

Workload Identity Federation memungkinkan Anda memberikan akses ke resourceGoogle Cloud kepada workload eksternal melalui workload identity pool dan penyedia identitas (IdP) yang terhubung. Seiring perubahan persyaratan, Anda dapat membuat, melihat, memperbarui, menghapus, atau membatalkan penghapusan pool dan penyedia menggunakan konsolGoogle Cloud , Google Cloud CLI, atau REST API.

Sebelum memulai

Membuat workload identity pool. Untuk mendapatkan petunjuk, lihat Panduan konfigurasi Workload Identity Federation.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengelola workload identity pool dan penyedia workload, mintalah administrator untuk memberi Anda peran IAM berikut pada project:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk mengelola workload identity pool dan penyedia workload. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengelola workload identity pool dan penyedia workload:

  • Untuk melihat workload identity pool dan penyedia workload:
    • iam.googleapis.com/workloadIdentityPoolProviders.get
    • iam.googleapis.com/workloadIdentityPoolProviders.list
    • iam.googleapis.com/workloadIdentityPools.get
    • iam.googleapis.com/workloadIdentityPools.list
  • Untuk membuat, memperbarui, dan menghapus pool dan penyedia:
    • iam.googleapis.com/workloadIdentityPoolProviders.create
    • iam.googleapis.com/workloadIdentityPoolProviders.delete
    • iam.googleapis.com/workloadIdentityPoolProviders.undelete
    • iam.googleapis.com/workloadIdentityPoolProviders.update
    • iam.googleapis.com/workloadIdentityPools.create
    • iam.googleapis.com/workloadIdentityPools.delete
    • iam.googleapis.com/workloadIdentityPools.undelete
    • iam.googleapis.com/workloadIdentityPools.update

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Mengelola workload identity pool

Bagian ini menunjukkan cara mengelola workload identity pool.

Membuat pool

Untuk membuat workload identity pool dalam sebuah project, lakukan hal berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Penyedia workload dan workload pool baru.

    Buka Penyedia workload dan workload pool baru

  2. Di bagian Create an identity pool, masukkan nama untuk pool.

    Konsol Google Cloud menggunakan nama ini untuk membuat ID pool. Untuk mengubah ID pool, klik Edit. Anda tidak dapat mengubah ID pool nanti.

  3. Opsional: Di kolom Description, masukkan deskripsi untuk pool.
  4. Opsional: Untuk membuat pool dalam status nonaktif, klik tombol Enabled pool.
  5. Klik Lanjutkan.
  6. Di bagian Add a provider to pool dan Configure provider attributes, konfigurasikan penyedia identitas untuk pool. Untuk mengetahui petunjuknya, lihat Membuat penyedia.
  7. Klik Simpan.

gcloud

Perintah gcloud iam workload-identity-pools create membuat workload identity pool dalam project.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • POOL_ID: ID unik untuk workload identity pool—misalnya, my-pool. Harus terdiri dari 4-32 karakter alfanumerik huruf kecil atau tanda hubung, dan tidak boleh diawali dengan gcp-.
  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • DISPLAY_NAME: Opsional. Nama tampilan untuk workload identity pool, maksimal 32 karakter—misalnya, My workload pool.
  • DESCRIPTION: Opsional. Deskripsi workload identity pool, maksimal 256 karakter.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam workload-identity-pools create POOL_ID \
    --project=PROJECT_ID \
    --location="global" \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION"

Windows (PowerShell)

gcloud iam workload-identity-pools create POOL_ID `
    --project=PROJECT_ID `
    --location="global" `
    --display-name="DISPLAY_NAME" `
    --description="DESCRIPTION"

Windows (cmd.exe)

gcloud iam workload-identity-pools create POOL_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --display-name="DISPLAY_NAME" ^
    --description="DESCRIPTION"

Anda akan melihat respons seperti berikut:

Create request issued for: [my-pool]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef] to complete...done.
Created workloadIdentityPool [my-pool].

REST

Metode projects.locations.workloadIdentityPools.create membuat workload identity pool dalam sebuah project.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID unik untuk workload identity pool—misalnya, my-pool. Harus terdiri dari 4-32 karakter alfanumerik huruf kecil atau tanda hubung, dan tidak boleh diawali dengan gcp-.
  • DISPLAY_NAME: Opsional. Nama tampilan untuk workload identity pool, maksimal 32 karakter—misalnya, My workload pool.
  • DESCRIPTION: Opsional. Deskripsi workload identity pool, maksimal 256 karakter.

Metode HTTP dan URL:

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools?workloadIdentityPoolId=POOL_ID

Meminta isi JSON:

{
  "displayName": "DISPLAY_NAME",
  "description": "DESCRIPTION"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Responsnya berisi operasi yang berjalan lama yang mewakili permintaan Anda. Untuk memeriksa apakah pembuatan pool telah selesai, lihat Memeriksa status operasi yang berjalan lama di halaman ini.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": false
}

Mencantumkan pool

Untuk mencantumkan semua workload identity pool dalam sebuah project, lakukan hal berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Workload Identity Pools.

    Buka Workload Identity Pool

  2. Pada tabel, lihat daftar workload identity pool.
  3. Opsional: Untuk menyertakan kumpulan dan penyedia yang dihapus dalam daftar, klik tombol Tampilkan kumpulan dan penyedia yang dihapus.

gcloud

Perintah gcloud iam workload-identity-pools list mencantumkan workload identity pool dalam sebuah project.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project. Untuk menyertakan pool yang dihapus sementara dalam output, tambahkan flag --show-deleted.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam workload-identity-pools list \
    --project=PROJECT_ID \
    --location="global" \
    --format="json"

Windows (PowerShell)

gcloud iam workload-identity-pools list `
    --project=PROJECT_ID `
    --location="global" `
    --format="json"

Windows (cmd.exe)

gcloud iam workload-identity-pools list ^
    --project=PROJECT_ID ^
    --location="global" ^
    --format="json"

Anda akan melihat respons seperti berikut:

[
  {
    "description": "Workload identity pool for external workloads.",
    "displayName": "My workload pool",
    "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
    "state": "ACTIVE"
  }
]

REST

Metode projects.locations.workloadIdentityPools.list mencantumkan workload identity pool dalam sebuah project.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project. Untuk menyertakan pool yang dihapus sementara dalam respons, tambahkan ?showDeleted=true ke URL permintaan.

Metode HTTP dan URL:

GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "workloadIdentityPools": [
    {
      "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
      "displayName": "My workload pool",
      "description": "Workload identity pool for external workloads.",
      "state": "ACTIVE"
    }
  ]
}

Dapatkan pool

Untuk mendapatkan detail tentang workload identity pool tertentu, lakukan hal berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Workload Identity Pools.

    Buka Workload Identity Pool

  2. Temukan workload identity pool yang ingin Anda lihat, lalu klik nama tampilannya. Konsol Google Cloud menampilkan detail tentang workload identity pool.

gcloud

Perintah gcloud iam workload-identity-pools describe mendapatkan detail tentang workload identity pool.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • POOL_ID: ID workload identity pool—misalnya, my-pool.
  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam workload-identity-pools describe POOL_ID \
    --project=PROJECT_ID \
    --location="global" \
    --format="json"

Windows (PowerShell)

gcloud iam workload-identity-pools describe POOL_ID `
    --project=PROJECT_ID `
    --location="global" `
    --format="json"

Windows (cmd.exe)

gcloud iam workload-identity-pools describe POOL_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --format="json"

Anda akan melihat respons seperti berikut:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
  "displayName": "My workload pool",
  "description": "Workload identity pool for external workloads.",
  "state": "ACTIVE"
}

REST

Metode projects.locations.workloadIdentityPools.get mendapatkan detail tentang workload identity pool.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool—misalnya, my-pool.

Metode HTTP dan URL:

GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
  "displayName": "My workload pool",
  "description": "Workload identity pool for external workloads.",
  "state": "ACTIVE"
}

Memperbarui pool

Anda dapat mengaktifkan atau menonaktifkan workload identity pool. Anda juga dapat mengubah nama tampilan atau deskripsinya.

Untuk memperbarui workload identity pool yang ada, lakukan hal berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Workload Identity Pools.

    Buka Workload Identity Pool

  2. Temukan workload identity pool yang ingin Anda edit.
  3. Klik nama tampilan workload identity pool.
  4. Untuk mengedit nama tampilan workload identity pool, lakukan hal berikut:

    1. Di halaman Pool details, di samping nama tampilan, klik ikon Edit.
    2. Dalam dialog Edit pool display name yang muncul, perbarui nama tampilan.
    3. Klik Simpan.
  5. Untuk menonaktifkan atau mengaktifkan workload identity pool, klik tombol alih Status, lalu klik Nonaktifkan atau Aktifkan.
  6. Untuk mengedit deskripsi, lakukan tindakan berikut:

    1. Di Description, di samping teks deskripsi, klik Edit.
    2. Perbarui deskripsi.
    3. Klik Simpan.

gcloud

Perintah gcloud iam workload-identity-pools update memperbarui workload identity pool yang ada.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • POOL_ID: ID workload identity pool—misalnya, my-pool.
  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • DISPLAY_NAME: Nama tampilan untuk workload identity pool, maksimal 32 karakter—misalnya, My updated pool.
  • DESCRIPTION: Deskripsi workload identity pool, maksimal 256 karakter. Untuk menonaktifkan atau mengaktifkan pool, teruskan juga flag --disabled atau --no-disabled.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam workload-identity-pools update POOL_ID \
    --project=PROJECT_ID \
    --location="global" \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION"

Windows (PowerShell)

gcloud iam workload-identity-pools update POOL_ID `
    --project=PROJECT_ID `
    --location="global" `
    --display-name="DISPLAY_NAME" `
    --description="DESCRIPTION"

Windows (cmd.exe)

gcloud iam workload-identity-pools update POOL_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --display-name="DISPLAY_NAME" ^
    --description="DESCRIPTION"

Anda akan melihat respons seperti berikut:

Update request issued for: [my-pool]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000001-0123456789abcdef] to complete...done.
Updated workloadIdentityPool [my-pool].

REST

Metode projects.locations.workloadIdentityPools.patch memperbarui workload identity pool yang ada.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool—misalnya, my-pool.
  • UPDATE_MASK: Daftar kolom yang dipisahkan koma untuk diupdate—misalnya, displayName,description,disabled.
  • DISPLAY_NAME: Nama tampilan untuk workload identity pool, maksimal 32 karakter—misalnya, My updated pool.
  • DESCRIPTION: Deskripsi workload identity pool, maksimal 256 karakter.
  • DISABLED: Apakah pool dinonaktifkan. Tetapkan ke true untuk menonaktifkan pool atau false untuk mengaktifkannya.

Metode HTTP dan URL:

PATCH https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID?updateMask=UPDATE_MASK

Meminta isi JSON:

{
  "displayName": "DISPLAY_NAME",
  "description": "DESCRIPTION",
  "disabled": DISABLED
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Responsnya berisi operasi yang berjalan lama yang mewakili permintaan Anda. Untuk memeriksa apakah update pool telah selesai, lihat Memeriksa status operasi yang berjalan lama di halaman ini.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000001-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": false
}

Menghapus pool

Saat menghapus workload identity pool, Anda juga akan menghapus penyedia workload identity pool. Akibatnya, identitas dalam pool kehilangan akses ke resourceGoogle Cloud .

Anda dapat membatalkan penghapusan pool hingga 30 hari setelah menghapusnya. Setelah 30 hari, penghapusan bersifat permanen. Hingga pool dihapus secara permanen, Anda tidak dapat menggunakan kembali nama yang sama saat membuat workload identity pool baru.

Untuk menghapus workload identity pool dan IdP-nya, lakukan langkah berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Workload Identity Pools.

    Buka Workload Identity Pool

  2. Temukan workload identity pool yang ingin Anda hapus, lalu klik nama tampilannya.
  3. Klik Hapus pool, lalu klik Hapus. Workload identity pool dan IdP-nya akan dihapus.

gcloud

Perintah gcloud iam workload-identity-pools delete menghapus workload identity pool.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • POOL_ID: ID workload identity pool yang akan dihapus—misalnya, my-pool.
  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam workload-identity-pools delete POOL_ID \
    --project=PROJECT_ID \
    --location="global"

Windows (PowerShell)

gcloud iam workload-identity-pools delete POOL_ID `
    --project=PROJECT_ID `
    --location="global"

Windows (cmd.exe)

gcloud iam workload-identity-pools delete POOL_ID ^
    --project=PROJECT_ID ^
    --location="global"

Anda akan melihat respons seperti berikut:

Delete request issued for: [my-pool]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000002-0123456789abcdef] to complete...done.
Deleted workloadIdentityPool [my-pool].

REST

Metode projects.locations.workloadIdentityPools.delete menghapus workload identity pool.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool yang akan dihapus—misalnya, my-pool.

Metode HTTP dan URL:

DELETE https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Responsnya berisi operasi yang berjalan lama yang mewakili permintaan Anda. Untuk memeriksa apakah penghapusan pool telah selesai, lihat Memeriksa status operasi yang berjalan lama di halaman ini.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000002-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": false
}

Membatalkan penghapusan pool

Anda dapat memulihkan workload identity pool yang dihapus hingga 30 hari setelah penghapusan.

Untuk membatalkan penghapusan pool, lakukan hal berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Workload Identity Pools.

    Buka Workload Identity Pool

  2. Klik tombol Tampilkan kumpulan dan penyedia yang dihapus.
  3. Temukan workload identity pool yang ingin Anda batalkan penghapusannya, lalu klik ikon Pulihkan.
  4. Klik Pulihkan. Pool dan penyedianya terpulihkan.

gcloud

Perintah gcloud iam workload-identity-pools undelete memulihkan workload identity pool yang dihapus untuk sementara.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • POOL_ID: ID workload identity pool yang dihapus untuk dipulihkan—misalnya, my-pool.
  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam workload-identity-pools undelete POOL_ID \
    --project=PROJECT_ID \
    --location="global"

Windows (PowerShell)

gcloud iam workload-identity-pools undelete POOL_ID `
    --project=PROJECT_ID `
    --location="global"

Windows (cmd.exe)

gcloud iam workload-identity-pools undelete POOL_ID ^
    --project=PROJECT_ID ^
    --location="global"

Anda akan melihat respons seperti berikut:

Undelete request issued for: [my-pool]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000003-0123456789abcdef] to complete...done.
Undeleted workloadIdentityPool [my-pool].

REST

Metode projects.locations.workloadIdentityPools.undelete memulihkan workload identity pool yang dihapus untuk sementara.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool yang dihapus untuk dipulihkan—misalnya, my-pool.

Metode HTTP dan URL:

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID:undelete

Meminta isi JSON:

{}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Responsnya berisi operasi yang berjalan lama yang mewakili permintaan Anda. Untuk memeriksa apakah pemulihan pool telah selesai, lihat Memeriksa status operasi yang berjalan lama di halaman ini.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000003-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": false
}

Mengelola penyedia workload identity pool

Bagian ini menunjukkan cara mengelola penyedia workload identity pool.

Membuat penyedia

Untuk membuat penyedia workload identity pool di workload identity pool yang ada, lakukan hal berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Workload Identity Pools.

    Buka Workload Identity Pool

  2. Temukan workload identity pool yang ingin Anda tambahi provider, lalu klik nama tampilan-nya.
  3. Klik Tambahkan penyedia.
  4. Pilih jenis penyedia yang akan dibuat:

    • AWS: IdP Amazon Web Services (AWS).
    • OpenID Connect (OIDC): IdP yang kompatibel dengan OIDC. Hal ini termasuk Microsoft Azure.
  5. Masukkan nama untuk penyedia.

    Konsol Google Cloud akan menggunakan nama ini untuk membuat ID penyedia. Untuk mengubah ID penyedia, klik Edit. Anda tidak dapat mengubah ID penyedia nanti.

  6. Lengkapi kolom yang tersisa untuk penyedia Anda:

    • AWS: Masukkan ID akun AWS Anda.
    • OIDC: Masukkan URL penerbit. Untuk Azure, URL penerbit menggunakan format https://sts.windows.net/AZURE_TENANT_ID. Untuk penyedia lain, lihat dokumentasi penyedia.

    Setelah selesai, klik Lanjutkan.

  7. Untuk mengonfigurasi pemetaan atribut, klik Edit pemetaan. Pemetaan atribut memungkinkan Anda menggunakan informasi tentang identitas eksternal untuk memberikan akses ke subset identitas tersebut.

  8. Opsional: Untuk memberikan kondisi atribut, yang menentukan identitas yang dapat melakukan autentikasi, klik Tambahkan kondisi lalu masukkan ekspresi Common Expression Language (CEL) yang valid. Untuk mengetahui detailnya, lihat Kondisi atribut.
  9. Klik Simpan. Penyedia workload identity pool telah dibuat.

gcloud

Membuat penyedia AWS

Perintah gcloud iam workload-identity-pools providers create-aws membuat penyedia workload identity pool AWS.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • PROVIDER_ID: ID unik untuk penyedia—misalnya, my-aws-provider. Harus terdiri dari 4-32 karakter alfanumerik huruf kecil atau tanda hubung, dan tidak boleh diawali dengan gcp-.
  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool untuk menambahkan penyedia—misalnya, my-pool.
  • DISPLAY_NAME: Opsional. Nama tampilan untuk penyedia, maksimal 32 karakter—misalnya, My AWS provider.
  • AWS_ACCOUNT_ID: ID akun AWS 12 digit Anda—misalnya, 123456789012.
  • ATTRIBUTE_CONDITION: Opsional. Ekspresi Common Expression Language (CEL) yang membatasi identitas yang dapat melakukan autentikasi—misalnya, attribute.aws_role == 'arn:aws:sts::123456789012:assumed-role/my-role'.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam workload-identity-pools providers create-aws PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --display-name="DISPLAY_NAME" \
    --account-id="AWS_ACCOUNT_ID" \
    --attribute-condition="ATTRIBUTE_CONDITION"

Windows (PowerShell)

gcloud iam workload-identity-pools providers create-aws PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --display-name="DISPLAY_NAME" `
    --account-id="AWS_ACCOUNT_ID" `
    --attribute-condition="ATTRIBUTE_CONDITION"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers create-aws PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --display-name="DISPLAY_NAME" ^
    --account-id="AWS_ACCOUNT_ID" ^
    --attribute-condition="ATTRIBUTE_CONDITION"

Anda akan melihat respons seperti berikut:

Create request issued for: [my-aws-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000010-0123456789abcdef] to complete...done.
Created workloadIdentityPoolProvider [my-aws-provider].

Membuat penyedia OIDC

Perintah gcloud iam workload-identity-pools providers create-oidc membuat penyedia workload identity pool OIDC.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • PROVIDER_ID: ID unik untuk penyedia—misalnya, my-oidc-provider. Harus terdiri dari 4-32 karakter alfanumerik huruf kecil atau tanda hubung, dan tidak boleh diawali dengan gcp-.
  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool untuk menambahkan penyedia—misalnya, my-pool.
  • DISPLAY_NAME: Opsional. Nama tampilan untuk penyedia, maksimal 32 karakter—misalnya, My OIDC provider.
  • ISSUER_URI: URL HTTPS penerbit OIDC—misalnya, https://idp.example.com atau https://sts.windows.net/AZURE_TENANT_ID.
  • DISCOVERY_URI: Opsional. URL untuk mengambil dokumen discovery OIDC, yang menggantikan URL ISSUER_URI/.well-known/openid-configuration default—misalnya, https://idp.example.com/.well-known/custom-openid-configuration. Skema, host, dan port harus cocok dengan ISSUER_URI, dan jalur harus berisi segmen /.well-known/ yang diikuti dengan akhiran yang tidak kosong.
  • ATTRIBUTE_CONDITION: Opsional. Ekspresi Common Expression Language (CEL) yang membatasi identitas yang dapat melakukan autentikasi—misalnya, assertion.sub.startsWith('repo:my-org/').
  • ACTOR_PROVIDERS: Opsional. Nama resource lengkap hingga tiga penyedia workload identity pool dalam pool yang sama yang diizinkan untuk menerbitkan token aktor untuk penyedia ini—misalnya, projects/my-project/locations/global/workloadIdentityPools/my-pool/providers/my-actor-provider. ID project di setiap nama resource harus cocok dengan format project ID atau nomor project yang Anda gunakan untuk penyedia ini. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi delegasi identitas dan token aktor.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --display-name="DISPLAY_NAME" \
    --issuer-uri="ISSUER_URI" \
    --discovery-uri="DISCOVERY_URI" \
    --attribute-mapping="google.subject=assertion.sub" \
    --attribute-condition="ATTRIBUTE_CONDITION" \
    --actor-providers="ACTOR_PROVIDERS"

Windows (PowerShell)

gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --display-name="DISPLAY_NAME" `
    --issuer-uri="ISSUER_URI" `
    --discovery-uri="DISCOVERY_URI" `
    --attribute-mapping="google.subject=assertion.sub" `
    --attribute-condition="ATTRIBUTE_CONDITION" `
    --actor-providers="ACTOR_PROVIDERS"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --display-name="DISPLAY_NAME" ^
    --issuer-uri="ISSUER_URI" ^
    --discovery-uri="DISCOVERY_URI" ^
    --attribute-mapping="google.subject=assertion.sub" ^
    --attribute-condition="ATTRIBUTE_CONDITION" ^
    --actor-providers="ACTOR_PROVIDERS"

Anda akan melihat respons seperti berikut:

Create request issued for: [my-oidc-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000011-0123456789abcdef] to complete...done.
Created workloadIdentityPoolProvider [my-oidc-provider].

REST

Membuat penyedia AWS

Metode projects.locations.workloadIdentityPools.providers.create membuat penyedia workload identity pool AWS.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool untuk menambahkan penyedia—misalnya, my-pool.
  • PROVIDER_ID: ID unik untuk penyedia—misalnya, my-aws-provider. Harus terdiri dari 4-32 karakter alfanumerik huruf kecil atau tanda hubung, dan tidak boleh diawali dengan gcp-.
  • DISPLAY_NAME: Opsional. Nama tampilan untuk penyedia, maksimal 32 karakter—misalnya, My AWS provider.
  • AWS_ACCOUNT_ID: ID akun AWS 12 digit Anda—misalnya, 123456789012.
  • ATTRIBUTE_CONDITION: Opsional. Ekspresi Common Expression Language (CEL) yang membatasi identitas yang dapat melakukan autentikasi—misalnya, attribute.aws_role == 'arn:aws:sts::123456789012:assumed-role/my-role'.

Metode HTTP dan URL:

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers?workloadIdentityPoolProviderId=PROVIDER_ID

Meminta isi JSON:

{
  "displayName": "DISPLAY_NAME",
  "aws": {
    "accountId": "AWS_ACCOUNT_ID"
  },
  "attributeCondition": "ATTRIBUTE_CONDITION"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Responsnya berisi operasi yang berjalan lama yang mewakili permintaan Anda. Untuk memeriksa apakah pembuatan penyedia telah selesai, lihat Memeriksa status operasi yang berjalan lama di halaman ini.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000010-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Membuat penyedia OIDC

Metode projects.locations.workloadIdentityPools.providers.create membuat penyedia workload identity pool OIDC.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool untuk menambahkan penyedia—misalnya, my-pool.
  • PROVIDER_ID: ID unik untuk penyedia—misalnya, my-oidc-provider. Harus terdiri dari 4-32 karakter alfanumerik huruf kecil atau tanda hubung, dan tidak boleh diawali dengan gcp-.
  • DISPLAY_NAME: Opsional. Nama tampilan untuk penyedia, maksimal 32 karakter—misalnya, My OIDC provider.
  • ISSUER_URI: URL HTTPS penerbit OIDC—misalnya, https://idp.example.com atau https://sts.windows.net/AZURE_TENANT_ID.
  • DISCOVERY_URI: Opsional. URL untuk mengambil dokumen discovery OIDC, yang menggantikan URL ISSUER_URI/.well-known/openid-configuration default—misalnya, https://idp.example.com/.well-known/custom-openid-configuration. Skema, host, dan port harus cocok dengan ISSUER_URI, dan jalur harus berisi segmen /.well-known/ yang diikuti dengan akhiran yang tidak kosong.
  • ATTRIBUTE_CONDITION: Opsional. Ekspresi Common Expression Language (CEL) yang membatasi identitas yang dapat melakukan autentikasi—misalnya, assertion.sub.startsWith('repo:my-org/').
  • ACTOR_PROVIDERS: Opsional. Nama resource lengkap hingga tiga penyedia workload identity pool dalam pool yang sama yang diizinkan untuk menerbitkan token aktor untuk penyedia ini—misalnya, projects/my-project/locations/global/workloadIdentityPools/my-pool/providers/my-actor-provider. ID project di setiap nama resource harus cocok dengan format project ID atau nomor project yang Anda gunakan untuk penyedia ini. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi delegasi identitas dan token aktor.

Metode HTTP dan URL:

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers?workloadIdentityPoolProviderId=PROVIDER_ID

Meminta isi JSON:

{
  "displayName": "DISPLAY_NAME",
  "oidc": {
    "issuerUri": "ISSUER_URI",
    "discoveryUri": "DISCOVERY_URI"
  },
  "attributeMapping": {
    "google.subject": "assertion.sub"
  },
  "attributeCondition": "ATTRIBUTE_CONDITION",
  "actorProviders": [
    "ACTOR_PROVIDERS"
  ]
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Responsnya berisi operasi yang berjalan lama yang mewakili permintaan Anda. Untuk memeriksa apakah pembuatan penyedia telah selesai, lihat Memeriksa status operasi yang berjalan lama di halaman ini.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000011-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Mencantumkan penyedia

Untuk mencantumkan penyedia workload identity pool dalam sebuah project, lakukan hal berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Workload Identity Pools.

    Buka Workload Identity Pool

  2. Agar dapat melihat penyedia untuk workload identity pool, klik ikon Luaskan node untuk pool.

gcloud

Perintah gcloud iam workload-identity-pools providers list mencantumkan penyedia dalam workload identity pool.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool yang penyedianya ingin Anda cantumkan—misalnya, my-pool. Untuk menyertakan penyedia yang dihapus sementara dalam output, tambahkan flag --show-deleted.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam workload-identity-pools providers list \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --format="json"

Windows (PowerShell)

gcloud iam workload-identity-pools providers list `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --format="json"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers list ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --format="json"

Anda akan melihat respons seperti berikut:

[
  {
    "attributeMapping": {
      "google.subject": "assertion.sub"
    },
    "displayName": "My OIDC provider",
    "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
    "oidc": {
      "issuerUri": "https://idp.example.com"
    },
    "state": "ACTIVE"
  }
]

REST

Metode projects.locations.workloadIdentityPools.providers.list mencantumkan penyedia dalam workload identity pool.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool yang penyedianya ingin Anda cantumkan—misalnya, my-pool. Untuk menyertakan penyedia yang dihapus sementara dalam respons, tambahkan ?showDeleted=true ke URL permintaan.

Metode HTTP dan URL:

GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "workloadIdentityPoolProviders": [
    {
      "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
      "displayName": "My OIDC provider",
      "state": "ACTIVE",
      "attributeMapping": {
        "google.subject": "assertion.sub"
      },
      "oidc": {
        "issuerUri": "https://idp.example.com"
      }
    }
  ]
}

Mendapatkan penyedia

Untuk mendapatkan detail terkait penyedia workload identity pool tertentu, lakukan hal berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Workload Identity Pools.

    Buka Workload Identity Pool

  2. Temukan workload identity pool yang berisi penyedia, lalu klik ikon Luaskan node untuk pool.
  3. Temukan penyedia workload identity pool yang ingin Anda lihat, lalu klik ikon Edit. Konsol Google Cloud menampilkan informasi mendetail tentang penyedia tersebut.

gcloud

Perintah gcloud iam workload-identity-pools providers describe mendapatkan detail tentang penyedia workload identity pool.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • PROVIDER_ID: ID penyedia workload identity pool—misalnya, my-oidc-provider.
  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool yang berisi penyedia—misalnya, my-pool.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam workload-identity-pools providers describe PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --format="json"

Windows (PowerShell)

gcloud iam workload-identity-pools providers describe PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --format="json"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers describe PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --format="json"

Anda akan melihat respons seperti berikut:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
  "displayName": "My OIDC provider",
  "state": "ACTIVE",
  "attributeMapping": {
    "google.subject": "assertion.sub"
  },
  "oidc": {
    "issuerUri": "https://idp.example.com"
  }
}

REST

Metode projects.locations.workloadIdentityPools.providers.get mendapatkan detail tentang penyedia workload identity pool.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool yang berisi penyedia—misalnya, my-pool.
  • PROVIDER_ID: ID penyedia workload identity pool—misalnya, my-oidc-provider.

Metode HTTP dan URL:

GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
  "displayName": "My OIDC provider",
  "state": "ACTIVE",
  "attributeMapping": {
    "google.subject": "assertion.sub"
  },
  "oidc": {
    "issuerUri": "https://idp.example.com"
  }
}

Memperbarui penyedia

Anda dapat mengaktifkan atau menonaktifkan penyedia workload identity pool. Anda juga dapat memperbarui informasi akun dan pemetaan atributnya, serta nama tampilan dan deskripsinya.

Untuk memperbarui penyedia workload identity pool yang ada, lakukan hal berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Workload Identity Pools.

    Buka Workload Identity Pool

  2. Temukan workload identity pool yang berisi penyedia, lalu klik ikon Luaskan node untuk pool.

  3. Temukan penyedia workload identity pool yang ingin Anda edit, lalu klik ikon Edit .

  4. Edit informasi penyedia, lalu klik Simpan.

gcloud

Mengupdate penyedia AWS

Perintah gcloud iam workload-identity-pools providers update-aws memperbarui penyedia workload identity pool AWS yang ada.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • PROVIDER_ID: ID penyedia yang akan diupdate—misalnya, my-aws-provider.
  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool yang berisi penyedia—misalnya, my-pool.
  • DISPLAY_NAME: Nama tampilan untuk penyedia, maksimal 32 karakter—misalnya, Updated AWS provider.
  • DESCRIPTION: Deskripsi penyedia, maksimal 256 karakter. Untuk menonaktifkan atau mengaktifkan penyedia, teruskan juga flag --disabled atau --no-disabled.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam workload-identity-pools providers update-aws PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION"

Windows (PowerShell)

gcloud iam workload-identity-pools providers update-aws PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --display-name="DISPLAY_NAME" `
    --description="DESCRIPTION"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers update-aws PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --display-name="DISPLAY_NAME" ^
    --description="DESCRIPTION"

Anda akan melihat respons seperti berikut:

Update request issued for: [my-aws-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000012-0123456789abcdef] to complete...done.
Updated workloadIdentityPoolProvider [my-aws-provider].

Memperbarui penyedia OIDC

Perintah gcloud iam workload-identity-pools providers update-oidc memperbarui penyedia workload identity pool AWS yang ada.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • PROVIDER_ID: ID penyedia OIDC yang akan diupdate—misalnya, my-oidc-provider.
  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool yang berisi penyedia—misalnya, my-pool.
  • DISPLAY_NAME: Nama tampilan untuk penyedia, maksimal 32 karakter—misalnya, Updated OIDC provider.
  • DESCRIPTION: Deskripsi penyedia, maksimal 256 karakter.
  • ISSUER_URI: URL HTTPS penerbit OIDC—misalnya, https://idp.example.com. Untuk menonaktifkan atau mengaktifkan penyedia, teruskan juga flag --disabled atau --no-disabled.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION" \
    --issuer-uri="ISSUER_URI"

Windows (PowerShell)

gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --display-name="DISPLAY_NAME" `
    --description="DESCRIPTION" `
    --issuer-uri="ISSUER_URI"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --display-name="DISPLAY_NAME" ^
    --description="DESCRIPTION" ^
    --issuer-uri="ISSUER_URI"

Anda akan melihat respons seperti berikut:

Update request issued for: [my-oidc-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000013-0123456789abcdef] to complete...done.
Updated workloadIdentityPoolProvider [my-oidc-provider].

REST

Metode projects.locations.workloadIdentityPools.providers.patch memperbarui penyedia workload identity pool yang ada.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool yang berisi penyedia—misalnya, my-pool.
  • PROVIDER_ID: ID penyedia yang akan diupdate—misalnya, my-aws-provider.
  • UPDATE_MASK: Daftar kolom yang dipisahkan koma untuk diupdate—misalnya, displayName,description,disabled.
  • DISPLAY_NAME: Nama tampilan untuk penyedia, maksimal 32 karakter—misalnya, Updated AWS provider.
  • DESCRIPTION: Deskripsi penyedia, maksimal 256 karakter.
  • DISABLED: Apakah penyedia dinonaktifkan. Tetapkan ke true untuk menonaktifkan penyedia atau false untuk mengaktifkannya.

Metode HTTP dan URL:

PATCH https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID?updateMask=UPDATE_MASK

Meminta isi JSON:

{
  "displayName": "DISPLAY_NAME",
  "description": "DESCRIPTION",
  "disabled": DISABLED
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Responsnya berisi operasi yang berjalan lama yang mewakili permintaan Anda. Untuk memeriksa apakah update penyedia telah selesai, lihat Memeriksa status operasi yang berjalan lama di halaman ini.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000012-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Menghapus penyedia

Saat Anda menghapus penyedia workload identity pool, identitas penyedia akan kehilangan akses ke resource Google Cloud .

Anda dapat membatalkan penghapusan penyedia hingga 30 hari setelah menghapusnya. Setelah 30 hari, penghapusan bersifat permanen. Sebelum penyedia dihapus secara permanen, Anda tidak dapat menggunakan kembali namanya saat membuat penyedia baru.

Untuk menghapus penyedia workload identity pool, lakukan tindakan berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Workload Identity Pools.

    Buka Workload Identity Pool

  2. Temukan workload identity pool yang berisi provider, lalu klik nama tampilan-nya.

  3. Di panel Penyedia, temukan penyedia yang ingin Anda hapus, lalu klik ikon Hapus.

  4. Klik Hapus untuk menghapus penyedia.

gcloud

Perintah gcloud iam workload-identity-pools providers delete menghapus penyedia workload identity pool.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • PROVIDER_ID: ID penyedia workload identity pool yang akan dihapus—misalnya, my-oidc-provider.
  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool yang berisi penyedia—misalnya, my-pool.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam workload-identity-pools providers delete PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID"

Windows (PowerShell)

gcloud iam workload-identity-pools providers delete PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers delete PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID"

Anda akan melihat respons seperti berikut:

Delete request issued for: [my-oidc-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000014-0123456789abcdef] to complete...done.
Deleted workloadIdentityPoolProvider [my-oidc-provider].

REST

Metode projects.locations.workloadIdentityPools.providers.delete menghapus penyedia workload identity pool.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool yang berisi penyedia—misalnya, my-pool.
  • PROVIDER_ID: ID penyedia workload identity pool yang akan dihapus—misalnya, my-oidc-provider.

Metode HTTP dan URL:

DELETE https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Responsnya berisi operasi yang berjalan lama yang mewakili permintaan Anda. Untuk memeriksa apakah penghapusan penyedia telah selesai, lihat Memeriksa status operasi yang berjalan lama di halaman ini.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000014-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Membatalkan penghapusan penyedia

Anda dapat memulihkan penyedia workload identity pool yang dihapus hingga 30 hari setelah Anda menghapusnya. Untuk membatalkan penghapusan penyedia, ikuti langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Workload Identity Pools.

    Buka Workload Identity Pool

  2. Klik tombol Tampilkan kumpulan dan penyedia yang dihapus.

  3. Temukan workload identity pool yang berisi penyedia, lalu klik ikon Luaskan node untuk pool.

  4. Temukan penyedia yang ingin Anda batalkan penghapusannya, lalu klik ikon Pulihkan.

  5. Klik Pulihkan. Penyedia akan dipulihkan.

gcloud

Perintah gcloud iam workload-identity-pools providers undelete memulihkan penyedia workload identity pool yang dihapus untuk sementara.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • PROVIDER_ID: ID penyedia workload identity pool yang dihapus untuk dipulihkan—misalnya, my-oidc-provider.
  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool yang berisi penyedia—misalnya, my-pool.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam workload-identity-pools providers undelete PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID"

Windows (PowerShell)

gcloud iam workload-identity-pools providers undelete PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers undelete PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID"

Anda akan melihat respons seperti berikut:

Undelete request issued for: [my-oidc-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000015-0123456789abcdef] to complete...done.
Undeleted workloadIdentityPoolProvider [my-oidc-provider].

REST

Metode projects.locations.workloadIdentityPools.providers.undelete memulihkan penyedia workload identity pool yang dihapus untuk sementara.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.
  • POOL_ID: ID workload identity pool yang berisi penyedia—misalnya, my-pool.
  • PROVIDER_ID: ID penyedia workload identity pool yang dihapus untuk dipulihkan—misalnya, my-oidc-provider.

Metode HTTP dan URL:

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID:undelete

Meminta isi JSON:

{}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Responsnya berisi operasi yang berjalan lama yang mewakili permintaan Anda. Untuk memeriksa apakah pemulihan penyedia telah selesai, lihat Memeriksa status operasi yang berjalan lama di halaman ini.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000015-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Memeriksa status operasi yang berjalan lama

Saat Anda menggunakan REST API, metode apa pun yang membuat, memperbarui, menghapus, atau memulihkan workload identity pool atau penyedia akan menampilkan operasi yang berjalan lama (LRO). Operasi yang berjalan lama akan melacak status permintaan dan menunjukkan apakah perubahan sudah selesai.

gcloud

Perintah gcloud iam workload-identity-pools operations describe menampilkan status operasi yang berjalan lama.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • OPERATION_NAME: Nama resource lengkap operasi dari kolom name respons asli:

    • Operasi pool: projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/operations/OPERATION_ID
    • Operasi penyedia: projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID/operations/OPERATION_ID

    Untuk operasi penyedia, jalankan perintah gcloud iam workload-identity-pools providers operations describe.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam workload-identity-pools operations describe OPERATION_NAME

Windows (PowerShell)

gcloud iam workload-identity-pools operations describe OPERATION_NAME

Windows (cmd.exe)

gcloud iam workload-identity-pools operations describe OPERATION_NAME

Anda akan melihat respons seperti berikut:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPool",
    "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
    "displayName": "My workload pool",
    "description": "Workload identity pool for external workloads.",
    "state": "ACTIVE"
  }
}

REST

Metode projects.locations.workloadIdentityPools.operations.get menampilkan status operasi yang berjalan lama.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • OPERATION_NAME: Nama resource lengkap operasi dari kolom name respons asli:

    • Operasi pool: projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/operations/OPERATION_ID
    • Operasi penyedia: projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID/operations/OPERATION_ID

Metode HTTP dan URL:

GET https://iam.googleapis.com/v1/OPERATION_NAME

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPool",
    "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
    "displayName": "My workload pool",
    "description": "Workload identity pool for external workloads.",
    "state": "ACTIVE"
  }
}

Jika kolom done operasi adalah false atau dihilangkan, terus pantau statusnya dengan mendapatkan operasi tersebut berulang kali. Gunakan backoff eksponensial terpotong untuk menambahkan penundaan di antara permintaan. Saat kolom done ditetapkan ke true, operasi akan selesai.

Mengelola batasan untuk Workload Identity Federation

Anda dapat menggunakan batasan kebijakan organisasi untuk membatasi penggunaan resource di organisasi Google Cloud Anda.

Bagian ini menjelaskan batasan yang direkomendasikan saat Anda menggunakan Workload Identity Federation.

Mengelola IdP yang diizinkan

Sebagai administrator organisasi, Anda dapat menentukan IdP yang diizinkan untuk bergabung dengan organisasi Anda.

Untuk mengelola IdP yang diizinkan, aktifkan batasan daftar constraints/iam.workloadIdentityPoolProviders dalam kebijakan organisasi untuk organisasi Anda. Batasan ini menentukan URI penerbit dari penyedia yang diizinkan. Anda dapat menggunakan konsolGoogle Cloud atau Google Cloud CLI untuk mengaktifkan batasan ini.

Agar hanya mengizinkan penggabungan dari AWS, buat satu batasan dengan URI https://sts.amazonaws.com. Contoh berikut menunjukkan cara membuat batasan ini menggunakan gcloud CLI:

gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \
     https://sts.amazonaws.com --organization=ORGANIZATION_NUMBER

Anda juga dapat menentukan ID akun AWS yang memiliki akses ke resourceGoogle Cloud Anda. Untuk menentukan ID akun, gunakan batasan daftar constraints/iam.workloadIdentityPoolAwsAccounts:

gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolAwsAccounts \
    ACCOUNT_ID --organization=ORGANIZATION_NUMBER

Agar hanya mengizinkan penggabungan dari satu penyedia OIDC, buat satu batasan dengan issuer_uri penyedia yang diizinkan. Misalnya, perintah berikut hanya mengizinkan federasi dari tenant Azure tertentu:

gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \
     https://sts.windows.net/AZURE_TENANT_ID --organization=ORGANIZATION_NUMBER

Federasi dari IdP SAML bersifat khusus karena kunci publik yang digunakan untuk memvalidasi pernyataan disediakan saat IdP SAML dikonfigurasi. Akibatnya, pengguna berbahaya mungkin mencoba mengupload dokumen metadata SAML dengan ID entitas IdP organisasi Anda menggunakan kunci publik. Membatasi penggabungan menggunakan ID entitas dalam skenario ini hanya memberikan keamanan yang ilusif.

Untuk mengurangi risiko ini, sebaiknya Anda hanya mengizinkan workload identity pool dibuat dengan penggabungan SAML di project Google Cloud yang dikelola organisasi Anda secara terpusat. Kemudian, sesuai kebutuhan, berikan identitas eksternal dalam workload identity pool tersebut akses ke resource di seluruh organisasi Anda.

Untuk mengizinkan penggabungan dari IdP SAML, buat batasan yang mengizinkan kata kunci khusus KEY_UPLOAD.

gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \
     KEY_UPLOAD --organization=ORGANIZATION_NUMBER

Anda dapat mengulangi perintah tersebut untuk mengizinkan penggabungan dari penyedia tambahan.

Untuk memblokir penggabungan dari semua penyedia:

  1. Buat file YAML yang berisi hal berikut:

    constraint: constraints/iam.workloadIdentityPoolProviders
    listPolicy:
      allValues: DENY
  2. Teruskan file ke perintah gcloud resource-manager org-policies set-policy:

    gcloud resource-manager org-policies set-policy FILE_NAME.yaml \
        --organization=ORGANIZATION_NUMBER

Membatasi pembuatan kunci akun layanan

Workload Identity Federation memungkinkan Anda mengakses resource Google Cloud dari luar Google Cloud tanpa menggunakan kunci akun layanan. Jika tidak pernah menggunakan kunci akun layanan untuk mengautentikasi, Anda dapat membantu mengurangi risiko dengan menonaktifkan pembuatan kunci.

Untuk menonaktifkan pembuatan kunci akun layanan, terapkan batasan boolean iam.disableServiceAccountKeyCreation dalam kebijakan organisasi untuk organisasi Anda. Anda juga dapat menerapkan batasan boolean iam.disableServiceAccountKeyUpload, yang akan menonaktifkan upload kunci publik untuk akun layanan.

Anda dapat menggunakan Google Cloud console atau gcloud CLI untuk mengaktifkan batasan ini. Misalnya, perintah gcloud CLI berikut mengaktifkan kedua batasan:

gcloud resource-manager org-policies enable-enforce \
    constraints/iam.disableServiceAccountKeyCreation \
    --organization=ORGANIZATION_NUMBER
gcloud resource-manager org-policies enable-enforce \
    constraints/iam.disableServiceAccountKeyUpload \
    --organization=ORGANIZATION_NUMBER

Memantau Workload Identity Federation

Anda dapat menggunakan metrik Cloud Monitoring untuk memantau peristiwa autentikasi pool dan penyedia workload identity. Untuk daftar metrik yang tersedia, lihat metrik IAM.

Langkah berikutnya

Pelajari lebih lanjut Workload Identity Federation.