MPC · Permintaan Penandatanganan
Ada tiga masalah penandatanganan yang terpisah: mengautentikasi permintaan HTTP, mengotorisasi penarikan tertentu, dan membuat tanda tangan blockchain dengan MPC peserta. Melewati pemeriksaan pertama tidak menggantikan dua pemeriksaan lainnya.
Otentikasi permintaan API
API saat ini menggunakan HMAC-SHA256 dengan pengidentifikasi kunci dan rahasia API. Permintaan kanonisnya berisi lima baris, dipisahkan oleh baris baru, tanpa baris baru di belakangnya:
Gunakan metode huruf besar HTTP dan minta jalur tanpa host. Urutkan kunci kueri, pertahankan urutan nilai berulang dan terapkan pengkodean formulir URL, termasuk + untuk spasi. Baris kueri kosong jika tidak ada kueri. Hash byte isi yang tepat menggunakan SHA-256, termasuk isi kosong untuk permintaan tanpa isi.
Hitung HMAC-SHA256 menggunakan rahasia yang diberikan sebagai UTF-8 byte; jangan mendekode hex hanya karena terlihat heksadesimal. Encode hasilnya sebagai hex huruf kecil. Bidang header dipisahkan oleh spasi:
Contoh penandatanganan hanya-baca
Pembantu perpustakaan standar ini membuat header untuk permintaan deposit; itu tidak mengirim permintaan. Muat kredensial dengan aman di aplikasi Anda dan kirimkan jalur yang dikembalikan tanpa perubahan ke URL dasar yang disediakan untuk lingkungan Anda.
Jaga agar jam tetap tersinkronisasi. Proksi yang mengubah jalur, kueri, atau isi setelah penandatanganan dapat membatalkan autentikasi. Untuk kegagalan autentikasi, periksa alasan respons dan pengenal permintaan sebelum mencoba lagi; jangan pernah mencatat header rahasia atau otorisasi penuh.
Otorisasi penarikan API
Alur penarikan API perusahaan saat ini juga memerlukan otorisasi pelanggan Ed25519 di client_authorization. Ini mengikat konteks transaksi yang dimaksudkan, termasuk pengidentifikasi permintaan, tujuan, aset, dan jumlah. Registrasi kunci publik atau konfigurasi kepercayaannya bergantung pada pengaturan penyimpanan kunci.
Gunakan paket integrasi yang cocok untuk menghasilkan muatan kanonik, tanda tangan, dan kunci publik. Kunci otorisasi ini terpisah dari rahasia HMAC dan MPC yang dibagikan. Pertahankan kunci pribadinya di bawah kendali pelanggan. Konfirmasikan versi payload dan aturan validitas selama integrasi alih-alih membuat format khusus dari ikhtisar ini.
Setelah permintaan diterima, pemeriksaan dan persetujuan bisnis masih dapat berlaku, diikuti dengan penandatanganan MPC dan konfirmasi berantai. Melihat transaksi dan percobaan ulang.