Mengelola penyedia autentikasi Identitas Agen

Di pengelola autentikasi Agent Identity, Anda mengelola penyedia autentikasi dengan mengedit detailnya, mengaktifkan atau menonaktifkannya, atau menghapus dan memulihkannya sesuai kebutuhan.

Sebelum memulai

  1. Pastikan Anda telah memilih metode autentikasi yang benar.
  2. Pastikan Anda memiliki peran yang diperlukan untuk menyelesaikan tugas ini.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna mengelola penyedia autentikasi Agent Identity, minta administrator untuk memberi Anda peran IAM Agent Identity Editor (roles/agentidentity.editor) pada project. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk mengelola penyedia autentikasi Agent Identity. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengelola penyedia autentikasi Agent Identity:

  • agentidentity.authProviders.update
  • agentidentity.authProviders.delete

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

Mengedit penyedia autentikasi

Untuk memperbarui deskripsi atau detail autentikasi penyedia autentikasi, gunakan Google Cloud konsol atau Google Cloud CLI.

Untuk memperbarui penyedia autentikasi, jalankan perintah berikut:

gcloud alpha agent-identity authProviders update AUTH_PROVIDER_NAME \
    --location="LOCATION" \
    --description="NEW_DESCRIPTION" \
    --three-legged-oauth-client-id="NEW_CLIENT_ID" \
    --three-legged-oauth-client-secret="NEW_CLIENT_SECRET" \
    --three-legged-oauth-authorization-url="NEW_ENDPOINT"

Ganti kode berikut:

  • AUTH_PROVIDER_NAME: Nama penyedia autentikasi.
  • LOCATION: Lokasi penyedia autentikasi.
  • NEW_DESCRIPTION: Deskripsi baru untuk penyedia autentikasi.
  • NEW_CLIENT_ID: ID klien baru dari aplikasi pihak ketiga Anda.
  • NEW_CLIENT_SECRET: Secret klien baru dari aplikasi pihak ketiga Anda.
  • NEW_ENDPOINT: URL baru server otorisasi pihak ketiga.

Mengaktifkan atau menonaktifkan penyedia autentikasi

Jika ingin menghentikan sementara agen menggunakan penyedia autentikasi tanpa menghapus penyedia autentikasi, Anda dapat menonaktifkan penyedia autentikasi. Anda dapat mengaktifkannya lagi kapan saja.

  1. Untuk mengaktifkan penyedia autentikasi, jalankan perintah berikut:

    gcloud alpha agent-identity authProviders enable AUTH_PROVIDER_NAME \
    --location="LOCATION"

  2. Untuk menonaktifkan penyedia autentikasi, jalankan perintah berikut:

    gcloud alpha agent-identity authProviders disable AUTH_PROVIDER_NAME \
    --location="LOCATION"

Ganti kode berikut:

  • AUTH_PROVIDER_NAME: Nama penyedia autentikasi.
  • LOCATION: Lokasi penyedia autentikasi.

Menghapus penyedia autentikasi

Jika tidak lagi memerlukan penyedia autentikasi, Anda dapat menghapusnya. Menghapus penyedia autentikasi akan menonaktifkannya dan menempatkannya dalam status penghapusan sementara selama 30 hari. Selama periode ini, Anda dapat memulihkan penyedia autentikasi jika mau. Setelah 30 hari, kebijakan penyedia autentikasi memerlukan waktu satu hari tambahan untuk dihapus. Setelah itu, Anda dapat membuat penyedia autentikasi dengan nama yang sama.

Untuk menghapus penyedia autentikasi, jalankan perintah berikut:

gcloud alpha agent-identity authProviders delete AUTH_PROVIDER_NAME \
    --location="LOCATION"

Ganti kode berikut:

  • AUTH_PROVIDER_NAME: Nama penyedia autentikasi.
  • LOCATION: Lokasi penyedia autentikasi.

Memulihkan penyedia autentikasi yang dihapus

Jika tidak sengaja menghapus penyedia autentikasi, Anda dapat memulihkannya dari status penghapusan sementara dalam waktu 30 hari setelah penghapusan. Selama periode ini, Anda dapat memulihkan penyedia autentikasi jika mau. Setelah 30 hari, kebijakan penyedia autentikasi memerlukan waktu satu hari tambahan untuk dihapus. Setelah itu, Anda dapat membuat penyedia autentikasi dengan nama yang sama.

Untuk memulihkan penyedia autentikasi, jalankan perintah berikut:

gcloud alpha agent-identity authProviders undelete AUTH_PROVIDER_NAME \
    --location="LOCATION"

Ganti kode berikut:

  • AUTH_PROVIDER_NAME: Nama penyedia autentikasi.
  • LOCATION: Lokasi penyedia autentikasi.

Langkah berikutnya