Menunda penghancuran versi secret regional

Halaman ini menjelaskan cara menyiapkan pemusnahan versi secret yang tertunda, memperbarui atau menghapus durasi penundaan pemusnahan, dan memulihkan versi secret yang dijadwalkan untuk dihancurkan.

Secara default, saat pengguna memilih untuk menghancurkan versi secret di Secret Manager, materi secret akan segera dihancurkan dan secara permanen. Namun, pengguna dengan peran Admin Pengelola Secret dapat menyiapkan penghancuran versi secret yang tertunda, yang memastikan bahwa versi secret tidak langsung dihancurkan setelah diminta dan tetap dapat dipulihkan selama durasi yang dapat dikonfigurasi.

Jika pemusnahan tertunda diaktifkan pada secret dan Anda menghancurkan versi secret, hal berikut akan terjadi:

• Versi dinonaktifkan, sehingga mencegah penggunaannya.

• Sistem menjadwalkan versi untuk dihancurkan secara permanen pada akhir periode penundaan.

• Setelah periode penundaan berakhir, versi secret akan dihancurkan secara permanen dan tidak dapat dibatalkan.

Manfaat

Fitur ini memberikan manfaat berikut:

• Lapisan perlindungan tambahan terhadap penghancuran materi rahasia penting secara tidak disengaja atau berbahaya. Setiap pengguna dengan peran Pengelola Versi Secret Secret Manager dapat menghancurkan versi secret. Tindakan ini tidak dapat dibatalkan. Dengan menyiapkan pemusnahan tertunda, Anda dapat mencegah pemusnahan versi secret secara langsung. Anda dapat memberikan akses minimum yang diperlukan kepada pengguna untuk mengelola siklus proses versi secret sehingga Anda dapat memantau dan mencegah pemusnahan data sensitif yang tidak disengaja.

• Menghancurkan versi secret akan memicu notifikasi SECRET_VERSION_DESTROY_SCHEDULED ke topik Pub/Sub yang dikonfigurasi pada secret. Pengguna dengan peran Admin Secret Manager dapat membatalkan pemusnahan terjadwal dan memulihkan versi secret dengan mengaktifkan atau menonaktifkan versi secret.

Sebelum memulai

1. Enable the Secret Manager API.

   Enable the API

2. Menyiapkan autentikasi.

   Select the tab for how you plan to use the samples on this page:

   Console

   When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

   gcloud

   In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

   REST

   Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

   Install the Google Cloud CLI, then initialize it by running the following command:

   gcloud init

   Untuk informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna menyiapkan pemusnahan versi secret yang tertunda, minta administrator untuk memberi Anda peran IAM Secret Manager Admin (roles/secretmanager.admin) pada secret. 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.

Menyiapkan penghapusan tertunda

Anda dapat mengaktifkan penghapusan versi secret yang tertunda saat membuat secret atau saat memperbarui secret. Untuk menyiapkan penghapusan tertunda, gunakan salah satu metode berikut:

Konsol

1. Buka halaman Secret Manager di konsol Google Cloud.

   Buka Secret Manager

2. Di halaman Secret Manager, klik tab Regional secret, lalu klik Create regional secret.

3. Di halaman Buat secret regional, masukkan nama untuk secret di kolom Nama.

4. Masukkan nilai untuk secret (misalnya, abcd1234). Anda juga dapat mengupload file teks yang berisi nilai secret menggunakan opsi Upload file. Tindakan ini akan otomatis membuat versi secret.

5. Pilih lokasi penyimpanan secret regional dari daftar Region.

6. Buka Tunda pemusnahan versi secret, lalu centang kotak Setel durasi untuk pemusnahan tertunda.

7. Di kolom Destruction delay duration, masukkan durasi dalam hari. Nilai minimum yang dapat Anda masukkan adalah 1 hari; nilai maksimumnya adalah 1.000 hari.

8. Klik Buat secret.

   Untuk mengaktifkan fitur ini pada secret yang ada, buka halaman Edit secret, lalu konfigurasikan durasi penundaan pemusnahan.

gcloud

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

• SECRET_ID: ID secret atau ID yang sepenuhnya memenuhi syarat untuk secret.
• LOCATION: Lokasi secret Google Cloud.
• TTL_DURATION: durasi penundaan penghancuran untuk versi secret. Anda dapat memasukkan durasi dalam format apa pun, misalnya, hari, jam, atau detik. Durasi minimum yang diperlukan adalah 1 hari, sedangkan durasi maksimum dapat ditetapkan ke 1.000 hari.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets create SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION

Windows (PowerShell)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets create SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION

Windows (cmd.exe)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets create SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION

Respons berisi secret yang baru dibuat.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• LOCATION: Lokasi secret Google Cloud.
• PROJECT_ID: project ID Google Cloud.
• SECRET_ID: ID secret atau ID yang sepenuhnya memenuhi syarat untuk secret.
• TTL_DURATION: durasi penundaan penghancuran untuk versi secret. Masukkan durasi dalam detik. Perhatikan bahwa durasi minimum yang diperlukan adalah 1 hari, sedangkan durasi maksimum dapat ditetapkan ke 1.000 hari.

Metode HTTP dan URL:

POST https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets?secretId=SECRET_ID

Isi JSON permintaan:

{
  "version_destroy_ttl":"TTL_DURATION"
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets?secretId=SECRET_ID"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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 POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets?secretId=SECRET_ID" | 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": "\"1621455df3febd\"",
  "versionDestroyTtl": "TTL_DURATION"
}

Penghancuran tertunda tidak berlaku dalam skenario berikut:

• Saat secret dihapus, semua materi secret dan versi secret terkait akan segera dihapus.

• Jika tanggal habis masa berlaku ditetapkan pada secret dan secret berakhir masa berlakunya, semua versi secret akan segera dihancurkan meskipun pemusnahan tertunda diaktifkan pada secret.

Memperbarui durasi penundaan pemusnahan

Untuk memperbarui durasi penundaan pemusnahan, gunakan salah satu metode berikut:

Konsol

1. Buka halaman Secret Manager di konsol Google Cloud.

   Buka Secret Manager

2. Di halaman Secret Manager, klik tab Regional secrets.

3. Untuk mengedit secret, gunakan salah satu metode berikut:

   • Klik Actions untuk secret yang ingin diedit, lalu klik Edit.

   • Klik nama secret untuk membuka halaman detail secret. Di halaman detail secret, klik Edit secret.

4. Di halaman Edit secret, buka bagian Tunda penghapusan versi secret. Perbarui durasi penundaan sesuai kebutuhan, lalu klik Perbarui secret.

gcloud

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

• SECRET_ID: ID secret atau ID yang memenuhi syarat sepenuhnya untuk secret
• LOCATION: Lokasi secret Google Cloud
• TTL_DURATION: durasi penundaan penghancuran untuk versi secret

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets update SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION

Windows (PowerShell)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets update SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION

Windows (cmd.exe)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets update SECRET_ID --location=LOCATION --version-destroy-ttl=TTL_DURATION

Respons berisi secret yang baru dibuat.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• LOCATION: Lokasi secret Google Cloud
• PROJECT_ID: project ID Google Cloud
• SECRET_ID: ID secret atau ID yang memenuhi syarat sepenuhnya untuk secret
• TTL_DURATION: durasi penundaan penghancuran untuk versi secret

Metode HTTP dan URL:

PATCH https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID?updateMask=version_destroy_ttl

Isi JSON permintaan:

{
  "version_destroy_ttl":"TTL_DURATION"
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID?updateMask=version_destroy_ttl"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID?updateMask=version_destroy_ttl" | 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": "\"16214561a80d09\"",
  "versionDestroyTtl": "TTL_DURATION"
}

Versi secret yang terpengaruh oleh durasi penundaan pemusnahan bergantung pada hal berikut:

• Saat pemusnahan tertunda ditetapkan untuk pertama kalinya pada secret, durasi penundaan pemusnahan akan memengaruhi semua versi secret yang aktif (diaktifkan dan dinonaktifkan).

• Jika durasi penundaan pemusnahan diperbarui atau dihapus, perubahan tersebut hanya akan ditampilkan pada versi secret baru tempat tindakan pemusnahan dicoba. Versi secret yang sudah dijadwalkan untuk dihancurkan akan terus dihancurkan pada waktu pemusnahan yang dijadwalkan.

Menonaktifkan penghancuran tertunda

Untuk menonaktifkan pemusnahan versi yang tertunda, gunakan salah satu metode berikut:

Konsol

1. Buka halaman Secret Manager di konsol Google Cloud.

   Buka Secret Manager

2. Di halaman Secret Manager, klik tab Regional secrets.

3. Untuk mengedit secret, gunakan salah satu metode berikut:

   • Klik Actions untuk secret yang ingin diedit, lalu klik Edit.

   • Klik nama secret untuk membuka halaman detail secret. Di halaman detail secret, klik Edit secret.

4. Di halaman Edit secret, buka Tunda pemusnahan versi secret. Hapus centang pada kotak Set duration for delayed destruction, lalu klik Update secret.

gcloud

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

• SECRET_ID: ID secret atau ID yang memenuhi syarat sepenuhnya untuk secret
• LOCATION: Lokasi secret Google Cloud

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets update SECRET_ID --location=LOCATION --remove-version-destroy-ttl

Windows (PowerShell)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets update SECRET_ID --location=LOCATION --remove-version-destroy-ttl

Windows (cmd.exe)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets update SECRET_ID --location=LOCATION --remove-version-destroy-ttl

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• LOCATION: Lokasi secret Google Cloud
• PROJECT_ID: project ID Google Cloud
• SECRET_ID: ID secret atau ID yang memenuhi syarat sepenuhnya untuk secret

Metode HTTP dan URL:

PATCH https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID?updateMask=version_destroy_ttl

Isi JSON permintaan:

{}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID?updateMask=version_destroy_ttl"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID?updateMask=version_destroy_ttl" | 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": "\"16214564f18f19\""
}

Menjadwalkan versi secret untuk pemusnahan tertunda

Untuk menjadwalkan versi secret untuk pemusnahan tertunda, gunakan salah satu metode berikut:

Konsol

1. Buka halaman Secret Manager di konsol Google Cloud.

   Buka Secret Manager

2. Di halaman Secret Manager, klik tab Regional secrets, lalu klik secret untuk mengakses versinya. Penghancuran versi yang tertunda harus dikonfigurasi pada secret ini.

3. Di halaman detail secret, di tab Versions, pilih versi secret yang ingin Anda hancurkan.

4. Klik Tindakan, lalu klik Hapus.

5. Pada dialog konfirmasi yang muncul, masukkan secret ID untuk mengonfirmasi, lalu klik Jadwalkan versi yang dipilih untuk dihancurkan.

gcloud

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

• SECRET_VERSION_ID: ID versi atau ID yang memenuhi syarat sepenuhnya untuk versi
• SECRET_ID: ID secret atau ID yang memenuhi syarat sepenuhnya untuk secret
• LOCATION: Lokasi secret Google Cloud

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets versions destroy SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

Windows (PowerShell)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets versions destroy SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

Windows (cmd.exe)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets versions destroy SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• LOCATION: Lokasi secret Google Cloud
• PROJECT_ID: project ID Google Cloud
• SECRET_ID: ID secret atau ID yang memenuhi syarat sepenuhnya untuk secret
• VERSION_ID: ID versi atau ID yang memenuhi syarat sepenuhnya untuk versi

Metode HTTP dan URL:

POST https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:destroy

Isi JSON permintaan:

{}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:destroy"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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 POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:destroy" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID",
  "createTime": "2024-09-04T06:41:57.859674Z",
  "state": "DISABLED",
  "etag": "\"16214579184a2c\"",
  "scheduledDestroyTime": "2024-09-05T13:15:28.357251843Z"
}

Versi secret akan segera dinonaktifkan dan dijadwalkan untuk dihancurkan setelah masa berlaku penundaan pemusnahan berakhir. Anda dapat melihat tanggal dan waktu yang tepat saat versi akan dihapus di kolom Dijadwalkan untuk dihapus pada di tabel Versi.

Memulihkan versi secret

Anda dapat memulihkan versi secret yang dijadwalkan untuk dihancurkan dengan mengaktifkan atau menonaktifkan versi secret.

Mengaktifkan versi secret yang dijadwalkan untuk dihancurkan

Untuk mengaktifkan versi secret yang dijadwalkan untuk dihancurkan, gunakan salah satu metode berikut:

Konsol

1. Buka halaman Secret Manager di konsol Google Cloud.

   Buka Secret Manager

2. Di halaman Secret Manager, klik tab Regional secrets, lalu klik secret untuk mengakses versinya.

3. Di halaman detail secret, di tab Versions, pilih versi secret yang dijadwalkan untuk dihancurkan.

4. Klik Tindakan, lalu klik Aktifkan.

5. Pada dialog konfirmasi yang muncul, klik Aktifkan versi yang dipilih.

gcloud

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

• SECRET_VERSION_ID: ID versi atau ID yang memenuhi syarat sepenuhnya untuk versi
• SECRET_ID: ID secret atau ID yang memenuhi syarat sepenuhnya untuk secret
• LOCATION: Lokasi secret Google Cloud

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets versions enable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

Windows (PowerShell)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets versions enable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

Windows (cmd.exe)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets versions enable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• LOCATION: Lokasi secret Google Cloud
• PROJECT_ID: project ID Google Cloud
• SECRET_ID: ID secret atau ID yang memenuhi syarat sepenuhnya untuk secret
• VERSION_ID: ID versi atau ID yang memenuhi syarat sepenuhnya untuk versi

Metode HTTP dan URL:

POST https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:enable

Isi JSON permintaan:

{}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:enable"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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 POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:enable" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID",
  "createTime": "2024-09-04T06:41:57.859674Z",
  "state": "ENABLED",
  "etag": "\"1621457b3c1459\""
}

Menonaktifkan versi secret yang dijadwalkan untuk dimusnahkan

Untuk menonaktifkan versi secret yang dijadwalkan untuk dihancurkan, gunakan salah satu metode berikut:

Konsol

1. Buka halaman Secret Manager di konsol Google Cloud.

   Buka Secret Manager

2. Di halaman Secret Manager, klik tab Regional secrets, lalu klik secret untuk mengakses versinya.

3. Di halaman detail secret, di tab Versions, pilih versi secret yang dijadwalkan untuk dihancurkan.

4. Klik Tindakan, lalu klik Nonaktifkan.

5. Pada dialog konfirmasi yang muncul, klik Nonaktifkan versi yang dipilih.

gcloud

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

• SECRET_VERSION_ID: ID versi atau ID yang memenuhi syarat sepenuhnya untuk versi
• SECRET_ID: ID secret atau ID yang memenuhi syarat sepenuhnya untuk secret
• LOCATION: Lokasi secret Google Cloud

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets versions disable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

Windows (PowerShell)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets versions disable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

Windows (cmd.exe)

Catatan: Pastikan Anda telah menginisialisasi Google Cloud CLI dengan autentikasi dan sebuah project dengan menjalankan gcloud init; atau gcloud auth login dan gcloud config set project.

gcloud secrets versions disable SECRET_VERSION_ID --secret=SECRET_ID --location=LOCATION

Respons berisi versi secret yang dinonaktifkan.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• LOCATION: Lokasi secret Google Cloud
• PROJECT_ID: project ID Google Cloud
• SECRET_ID: ID secret atau ID yang memenuhi syarat sepenuhnya untuk secret
• VERSION_ID: ID versi atau ID yang memenuhi syarat sepenuhnya untuk versi

Metode HTTP dan URL:

POST https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:disable

Isi JSON permintaan:

{}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:disable"

PowerShell

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

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 POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://secretmanager.LOCATION.rep.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID/versions/VERSION_ID:disable" | Select-Object -Expand Content

Anda akan melihat respons JSON yang mirip dengan berikut ini:

{
  "name": "projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID",
  "createTime": "2024-09-04T06:41:57.859674Z",
  "state": "DISABLED",
  "etag": "\"1621457b3c1459\""
}

Langkah selanjutnya

• Pelajari cara memastikan integritas data.
• Pelajari praktik terbaik.