Lewati ke konten utama

Rotasi Secret dan Tes

Merotasi secret​

Ganti secret secara berkala, atau segera jika dicurigai bocor.

Rotasi secret webhook: setelah rotasi, secret lama dan baru sama-sama menandatangani selama masa tumpang tindih 24 jam, jadi header membawa dua nilai v1, lalu secret lama berhentiTumpang tindih 24 jam (bisa 0–72)Secret lamawhsec_…a1B2Secret baruwhsec_…k9ZqwaktuRotasi secretSecret lama berhentiX-Etalasse-Signaturet=…,v1=lamat=…,v1=baru,v1=lamat=…,v1=baruPasang secret baru di server Anda123
(1) Setelah rotasi, (2) secret lama dan baru sama-sama menandatangani, jadi header membawa dua nilai v1, (3) sampai masa tumpang tindih habis dan secret lama berhenti.

(1) Setelah rotasi, (2) secret lama dan baru sama-sama menandatangani, jadi header membawa dua nilai v1, (3) sampai masa tumpang tindih habis dan secret lama berhenti.

  1. Buka detail endpoint, pilih Rotasi secret.
  2. Tentukan jam tumpang tindih (0 sampai 72, bawaan 24).
  3. Salin secret baru. Seperti saat dibuat, secret baru hanya tampil sekali.
  4. Pasang secret baru di server Anda sebelum masa tumpang tindih habis.

Selama masa tumpang tindih, secret baru dan lama sama-sama menandatangani setiap pengiriman, jadi header berisi dua nilai v1. Server yang memeriksa semua nilai v1 (contoh kode) bisa berganti tanpa downtime. Endpoint menampilkan status Rotasi dan waktu berakhirnya secret lama.

Jam tumpang tindihEfek
0Secret lama langsung tidak berlaku
1-72Dua tanda tangan sampai waktu habis
waspada

Dengan 0 jam, pengiriman yang masih memakai secret lama di server Anda akan gagal verifikasi. Pakai 0 hanya jika secret lama bocor.

Mengirim tes​

Tombol Kirim tes mengirim event webhook.test berisi contoh pesanan ke endpoint, dan langsung menampilkan hasilnya: berhasil atau tidak, kode HTTP, latensi, galat, dan cuplikan respons.

  • Dikirim sekali, tanpa percobaan ulang.
  • Tidak dihitung ke penghitung kegagalan, baik berhasil maupun gagal, sehingga tes tidak pernah menonaktifkan endpoint.
  • Dibatasi 10 kali per menit per toko.
  • Muncul di log dengan jenis test.

Kode galat yang mungkin muncul:

GalatArti
TIMEOUTTidak membalas dalam 8 detik
CONNECT_FAILEDGagal tersambung ke server
ADDRESS_BLOCKEDNama host mengarah ke alamat yang tidak diizinkan
HTTP_503 (dan kode lain)Server membalas non-2xx dengan kode tersebut

Event webhook.test tidak bisa dilangganan; hanya muncul dari tombol tes.

Halaman terkait​