Mengelola akses untuk agen yang di-deploy

Konsol

1. Buka halaman IAM.

   Buka IAM

2. Pilih project yang sesuai dengan project Google Cloud Anda.

3. Temukan Principal yang cocok dengan akun layanan yang digunakan sebagai identitas agen Anda.

4. Peran agen yang di-deploy dapat ditemukan di kolom Peran.

gcloud

Pertama, instal dan lakukan inisialisasi gcloud CLI. Kemudian, jalankan perintah berikut:

gcloud projects get-iam-policy PROJECT_ID_OR_NUMBER \
  --flatten="bindings[].members" \
  --filter="bindings.members:serviceAccount:PRINCIPAL" \
  --format="value(bindings.role)"

di mana

• PROJECT_ID_OR_NUMBER adalah ID atau nomor project Anda, dan
• PRINCIPAL didasarkan pada akun layanan yang digunakan saat agen di-deploy di Vertex AI Agent Engine.

Untuk mengetahui detailnya, buka dokumentasi IAM dan referensi CLI.

Python

Pertama, instal library klien dengan menjalankan

pip install google-api-python-client

Kemudian, lakukan autentikasi diri Anda, dan jalankan perintah berikut untuk mencantumkan peran agen yang di-deploy:

from google.cloud import resourcemanager_v3
from google.iam.v1 import iam_policy_pb2

project_id = "PROJECT_ID"
principal = "PRINCIPAL"

crm_service = resourcemanager_v3.ProjectsClient()
policy = crm_service.get_iam_policy(iam_policy_pb2.GetIamPolicyRequest(
    resource=f"projects/{project_id}"
))
for binding in policy.bindings:
    for member in binding.members:
        if principal in member:
            print(binding.role)

Tempat PRINCIPAL didasarkan pada akun layanan yang digunakan saat agen di-deploy di Vertex AI Agent Engine.

Konsol (direkomendasikan)

1. Buka halaman IAM.

   Buka IAM

2. Pilih project yang sesuai dengan project Google Cloud Anda.

3. Temukan Principal yang cocok dengan akun layanan yang digunakan sebagai identitas agen Anda.

4. Tambahkan peran yang diperlukan ke Akun Utama dengan mengklik tombol edit, menambahkan peran, sebelum mengklik tombol simpan.

gcloud

Pertama, instal dan lakukan inisialisasi gcloud CLI. Kemudian, jalankan perintah berikut:

gcloud projects add-iam-policy-binding PROJECT_ID --member=PRINCIPAL --role=ROLE_NAME

di mana

• PRINCIPAL didasarkan pada akun layanan yang digunakan saat agen di-deploy di Vertex AI Agent Engine.
• ROLE_NAME adalah nama peran yang ingin Anda berikan. Untuk mengetahui daftar peran bawaan, lihat Memahami peran.

Untuk mengetahui detailnya, buka dokumentasi IAM dan referensi CLI.

Python

Sebaiknya jangan tulis kode Python Anda sendiri untuk memberikan atau mencabut peran bagi agen yang di-deploy. Sebagai gantinya, sebaiknya gunakan konsol Google Cloud atau gcloud untuk operasi satu kali, atau Terraform untuk mengelola kontrol akses IAM secara terprogram. Jika Anda ingin atau perlu melakukannya di Python, lihat dokumentasi untuk library klien IAM.

Konsol (direkomendasikan)

1. Buka halaman IAM.

   Buka IAM

2. Pilih project yang sesuai dengan project Google Cloud Anda.

3. Temukan Principal yang cocok dengan akun layanan yang digunakan sebagai identitas agen Anda.

4. Cabut peran dari Akun utama dengan mengklik tombol edit, menghapus peran yang sesuai, sebelum mengklik tombol simpan.

gcloud

Pertama, instal dan lakukan inisialisasi gcloud CLI. Kemudian, jalankan perintah berikut:

gcloud projects remove-iam-policy-binding PROJECT_ID --member=PRINCIPAL --role=ROLE_NAME

di mana

• PRINCIPAL didasarkan pada akun layanan yang digunakan saat agen di-deploy di Vertex AI Agent Engine.
• ROLE_NAME adalah nama peran yang ingin Anda cabut. Untuk mengetahui daftar peran bawaan, lihat Memahami peran.

Untuk mengetahui detailnya, buka dokumentasi IAM dan referensi CLI.

Python

Sebaiknya jangan tulis kode Python Anda sendiri untuk memberikan atau mencabut peran bagi agen yang di-deploy. Sebagai gantinya, sebaiknya gunakan konsol Google Cloud atau gcloud untuk operasi satu kali, atau Terraform untuk mengelola kontrol akses IAM secara terprogram. Jika Anda ingin atau perlu melakukannya di Python, lihat dokumentasi untuk library klien IAM.

Konsol

1. Buka halaman Secret Manager.

   Buka Secret Manager

2. Di halaman Secret Manager, klik Buat Secret.

3. Di kolom Name, masukkan nama untuk secret (misalnya, my-secret).

4. Opsional: Untuk menambahkan versi secret saat membuat secret awal, di kolom Secret value, masukkan nilai untuk secret tersebut (misalnya, abcd1234).

5. Buka Label, lalu klik Tambahkan label.

6. Masukkan kunci dan nilai yang sesuai untuk membuat label.

7. Klik Buat secret.

gcloud

Pertama, instal dan lakukan inisialisasi gcloud CLI. Kemudian, jalankan perintah berikut:

gcloud secrets create SECRET_ID --replication-policy="automatic"
gcloud secrets versions add SECRET_ID --data-file="FILE_PATH"

di mana

• SECRET_ID adalah ID rahasia atau ID yang sepenuhnya memenuhi syarat untuk rahasia.
• FILE_PATH adalah jalur lengkap (termasuk nama file) ke file yang berisi detail versi.

Untuk mengetahui detailnya, buka dokumentasi Secret Manager untuk membuat secret dan versi secret, atau referensi CLI untuk membuat secret dan versi secret.

Python

Pertama, instal library klien dengan menjalankan

pip install google-cloud-secret-manager

Kemudian, autentikasi diri Anda, dan jalankan perintah berikut

from google.cloud import secretmanager
import google_crc32c

client = secretmanager.SecretManagerServiceClient()
secret = client.create_secret(request={
    "parent": "projects/PROJECT_ID",
    "secret_id": "SECRET_ID",
    "secret": {  # google.cloud.secretmanager_v1.types.Secret
        # Required. The replication policy cannot be changed after the Secret has been created.
        "replication": {"automatic": {}},
        # Optional. Labels to associate with the secret.
        "labels": {"type": "api_key", "provider": "anthropic"},
        # Optional. The secret's time-to-live in seconds with format (e.g.,
        # "900s" for 15 minutes). If specified, the secret versions will be
        # automatically deleted upon reaching the end of the TTL period.
        "ttl": "TTL",
    },
})

anthropic_api_key = "API_KEY"  # The secret to be stored.
payload_bytes = anthropic_api_key.encode("UTF-8")
# Optional. Calculate payload checksum.
crc32c = google_crc32c.Checksum()
crc32c.update(payload_bytes)

version = client.add_secret_version(request={
    "parent": secret.name,
    "payload": {
        "data": payload_bytes,
        "data_crc32c": int(crc32c.hexdigest(), 16),  # Optional.
    },
})
print(f"Added secret version: {version.name}")

Konsol

1. Buka halaman Secret Manager.

   Buka Secret Manager

2. Di halaman Secret Manager, klik nama secret yang akan dideskripsikan.

3. Halaman Detail secret mencantumkan informasi tentang secret.

gcloud

Pertama, instal dan lakukan inisialisasi gcloud CLI. Kemudian, jalankan perintah berikut:

gcloud secrets versions describe VERSION_ID --secret=SECRET_ID

di mana

• VERSION_ID adalah ID versi secret, dan
• SECRET_ID adalah ID rahasia atau ID yang sepenuhnya memenuhi syarat untuk rahasia.

Untuk mengetahui detailnya, buka dokumentasi Secret Manager, atau referensi CLI.

Python

Pertama, instal library klien dengan menjalankan

pip install google-cloud-secret-manager

Kemudian, autentikasi diri Anda, dan jalankan perintah berikut

from google.cloud import secretmanager

client = secretmanager.SecretManagerServiceClient()
name = client.secret_path("PROJECT_ID", "SECRET_ID")
response = client.get_secret(request={"name": name})

Konsol

1. Buka halaman Secret Manager.

   Buka Secret Manager

2. Di tabel Secrets, klik kolom Filter.

3. Pilih properti filter dan nilai yang sesuai, misalnya Location:asia-east1.

4. Tabel akan otomatis difilter berdasarkan nilai yang dimasukkan.

5. (Opsional) Untuk memfilter versi rahasia: pilih rahasia untuk mengakses versinya, lalu gunakan opsi Filter di tabel Versi.

gcloud

Pertama, instal dan lakukan inisialisasi gcloud CLI.

Untuk mencantumkan semua secret project, jalankan perintah berikut:

gcloud secrets list --filter="FILTER"

dengan FILTER adalah string (misalnya name:asecret OR name:bsecret) atau ekspresi reguler (misalnya name ~ "secret_ab.*").

Untuk mencantumkan semua versi secret, jalankan perintah berikut:

gcloud secrets versions list SECRET_ID

dengan SECRET_ID adalah ID rahasia atau ID yang sepenuhnya memenuhi syarat untuk rahasia.

Untuk mengetahui detailnya, buka dokumentasi Secret Manager untuk memfilter secret dan mencantumkan versi secret, atau referensi CLI untuk mencantumkan secret dan versi secret.

Python

Pertama, instal library klien dengan menjalankan

pip install google-cloud-secret-manager

Kemudian, autentikasi diri Anda, dan jalankan perintah berikut

from google.cloud import secretmanager
client = secretmanager.SecretManagerServiceClient()
for secret in client.list_secrets(request={
    "parent": "projects/PROJECT_ID",
    "filter": "FILTER", # e.g. "labels.provider=anthropic"
}):
    print(f"Found secret: {secret.name}")

Konsol

1. Buka halaman Secret Manager.

   Buka Secret Manager

2. Di halaman Secret Manager, klik kotak centang di samping nama secret.

3. Jika Panel Info ditutup, klik Tampilkan Panel Info untuk menampilkannya.

4. Di Panel Info, pilih tab Label.

5. Klik Tambahkan label, lalu masukkan kunci dan nilai untuk label.

6. Klik Simpan.

gcloud

Pertama, instal dan lakukan inisialisasi gcloud CLI. Kemudian, jalankan perintah berikut:

gcloud secrets update SECRET_ID --update-labels=KEY=VALUE

di mana

• SECRET_ID adalah ID rahasia atau ID yang sepenuhnya memenuhi syarat untuk rahasia,
• KEY adalah kunci label, dan
• VALUE adalah nilai label yang sesuai.

Untuk mengetahui detailnya, buka dokumentasi Secret Manager atau referensi CLI.

Python

Pertama, instal library klien dengan menjalankan

pip install google-cloud-secret-manager

Kemudian, autentikasi diri Anda, dan jalankan perintah berikut

from google.cloud import secretmanager
client = secretmanager.SecretManagerServiceClient()
name = client.secret_path("PROJECT_ID", "SECRET_ID")
response = client.update_secret(request={
    "secret": {
        "name": name,
        "labels": {"type": "api_key", "provider": "anthropic"}, # updated labels
    },
    "update_mask": {"paths": ["labels"]},
})
print(f"Updated secret: {response.name}")

Konsol

1. Buka halaman Secret Manager.

   Buka Secret Manager

2. Di halaman Secret Manager, di kolom Tindakan untuk secret, klik Lihat lebih banyak.

3. Di menu, pilih Hapus.

4. Dalam dialog Hapus rahasia, masukkan nama rahasia.

5. Klik tombol Hapus rahasia.

gcloud

Pertama, instal dan lakukan inisialisasi gcloud CLI.

Untuk menghapus versi rahasia, jalankan perintah berikut:

gcloud secrets versions destroy VERSION_ID --secret=SECRET_ID

di mana

• VERSION_ID adalah nama resource versi secret, dan
• SECRET_ID adalah ID rahasia atau ID yang sepenuhnya memenuhi syarat untuk rahasia.

Untuk menghapus secret dan semua versinya, jalankan perintah berikut:

gcloud secrets delete SECRET_ID

dengan SECRET_ID adalah ID rahasia atau ID yang sepenuhnya memenuhi syarat untuk rahasia

Untuk mengetahui detailnya, buka dokumentasi Secret Manager untuk menghapus secret dan menghancurkan versi secret, atau referensi CLI untuk menghapus secret dan menghancurkan versi secret.

Python

Pertama, instal library klien dengan menjalankan

pip install google-cloud-secret-manager

Kemudian, autentikasi diri Anda, dan jalankan perintah berikut

from google.cloud import secretmanager
client = secretmanager.SecretManagerServiceClient()
name = client.secret_path("PROJECT_ID", "SECRET_ID")
client.delete_secret(request={"name": name})