Anda dapat menetapkan alias ke versi secret untuk memudahkan akses. Setelah alias ditetapkan, Anda dapat mengakses versi secret menggunakan aliasnya dengan cara yang sama seperti mengakses versi secret berdasarkan nomor versinya.
Peran yang diperlukan
Untuk mendapatkan izin yang
Anda perlukan untuk menetapkan alias ke versi secret,
minta administrator untuk memberi Anda peran IAM
Admin Secret Manager (roles/secretmanager.admin) pada secret, project, folder, atau organisasi.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Menetapkan alias ke versi secret
Untuk menetapkan alias ke versi secret, gunakan salah satu metode berikut:
Konsol
-
Di Google Cloud konsol, buka halaman Secret Manager.
-
Untuk mengedit secret, gunakan salah satu metode berikut:
-
Klik Tindakan untuk secret yang ingin Anda edit, lalu klik Edit.
-
Klik nama secret untuk membuka halaman detail secret. Di halaman detail secret, klik Edit secret.
-
-
Di halaman Edit secret, buka Version aliases, lalu klik Add alias.
-
Lakukan tindakan berikut:
-
Tentukan nama alias.
-
Pilih versi secret yang akan Anda tetapkan alias ini.
-
-
Klik Update secret.
gcloud
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
- SECRET_ID: ID secret.
- KEY: nama alias versi secret.
- VALUE: nomor versi secret.
Jalankan perintah berikut:
Linux, macOS, atau Cloud Shell
gcloud secrets update SECRET_ID \ --update-version-aliases=KEY=VALUE
Windows (PowerShell)
gcloud secrets update SECRET_ID ` --update-version-aliases=KEY=VALUE
Windows (cmd.exe)
gcloud secrets update SECRET_ID ^ --update-version-aliases=KEY=VALUE
Respons berisi secret yang telah diperbarui.
REST
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
- PROJECT_ID: Project ID Google Cloud
- SECRET_ID: ID secret.
- KEY: nama alias versi secret.
- VALUE: nomor versi secret.
Metode HTTP dan URL:
PATCH https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID?updateMask=version_aliases
Meminta isi JSON:
{'version_aliases': {'KEY': 'VALUE'}}
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
curl
Simpan isi permintaan dalam file bernama request.json,
dan jalankan perintah berikut:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID?updateMask=version_aliases"
PowerShell
Simpan isi permintaan dalam file bernama request.json,
dan jalankan perintah berikut:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID?updateMask=version_aliases" | Select-Object -Expand Content
Anda akan melihat respons JSON seperti berikut:
{
"name": "projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID",
"createTime": "2024-09-04T06:34:32.995517Z",
"etag": "\"16214584d1479c\"",
"versionAliases": {
"nonprod": "1"
}
}
C#
Untuk menjalankan kode ini, siapkan terlebih dahulu lingkungan pengembangan C# dan instal Secret Manager C# SDK. Di Compute Engine atau GKE, Anda harus melakukan autentikasi dengan cakupan cloud-platform.
Go
Untuk menjalankan kode ini, siapkan terlebih dahulu lingkungan pengembangan Go dan instal Secret Manager Go SDK. Di Compute Engine atau GKE, Anda harus melakukan autentikasi dengan cakupan cloud-platform.
Java
Untuk menjalankan kode ini, siapkan terlebih dahulu lingkungan pengembangan Java dan instal Secret Manager Java SDK. Di Compute Engine atau GKE, Anda harus melakukan autentikasi dengan cakupan cloud-platform.
Node.js
Untuk menjalankan kode ini, siapkan terlebih dahulu lingkungan pengembangan Node.js dan instal Secret Manager Node.js SDK. Di Compute Engine atau GKE, Anda harus melakukan autentikasi dengan cakupan cloud-platform.
PHP
Untuk menjalankan kode ini, pelajari terlebih dahulu cara menggunakan PHP di Google Cloud dan instal Secret Manager PHP SDK. Di Compute Engine atau GKE, Anda harus melakukan autentikasi dengan cakupan cloud-platform.
Python
Untuk menjalankan kode ini, siapkan terlebih dahulu lingkungan pengembangan Python dan instal Secret Manager Python SDK. Di Compute Engine atau GKE, Anda harus melakukan autentikasi dengan cakupan cloud-platform.
Ruby
Untuk menjalankan kode ini, siapkan terlebih dahulu lingkungan pengembangan Ruby dan instal Secret Manager Ruby SDK. Di Compute Engine atau GKE, Anda harus melakukan autentikasi dengan cakupan cloud-platform.
Langkah berikutnya
- Pelajari cara mencantumkan versi secret dan melihat detail versi secret.
- Pelajari cara memastikan integritas data saat menambahkan dan mengakses versi secret.