Akses OAuth harus diaktifkan untuk organisasi Anda. Proses penyiapan Anda menyediakan
endpoint token regional, issuer, audience, dan metode autentikasi klien.
Jika Anda memerlukan pengaturan ini atau tidak dapat mengakses pengelolaan klien, hubungi
Dukungan Living Security.
Sebelum Anda memulai
- Buat akun layanan dengan hanya izin yang dibutuhkan oleh integrasi.
- Gunakan kredensial manajemen dengan
service_account:managedan setiap izin yang ingin Anda berikan kepada klien baru. Akun target juga harus memiliki izin tersebut. Klien tidak dapat memperluas kewenangan akun mana pun. - Pilih wilayah organisasi. Kredensial API dan token akses OAuth harus digunakan pada host API regional yang sesuai.
- Simpan secret klien dan token di penyimpanan secret sisi server Anda. Jangan pernah menaruhnya dalam kode browser, aplikasi seluler, kontrol sumber, atau log permintaan.
Membuat klien
POST /v1/oauth_clients memerlukan service_account_id, daftar tidak kosong berisi
scopes eksplisit, dan Idempotency-Key. Wildcard tidak diterima. Satu klien mendukung
hingga 100 cakupan, dengan total panjang maksimal 4.096 karakter. Setiap akun
layanan dapat memiliki paling banyak 20 klien atau operasi pembuatan/pembersihan yang belum selesai.
Pencabutan langsung menolak akses API. Klien atau pembuatan yang tidak pasti di sisi penyedia
tetap dihitung terhadap batas hingga pembersihan jarak jauh dikonfirmasi.
Reservasi yang ditinggalkan atau pembuatan yang terbukti gagal sebelum pekerjaan penyedia
dimulai dapat melepaskan slotnya dengan aman. Kunci percobaan ulangnya tetap milik
upaya awal; pulihkan tanda terima tersebut sebelum memutuskan untuk membuat pengganti.
Pilih satu kunci percobaan ulang untuk upaya pembuatan ini dan simpan sebelum mengirim
permintaan. Gunakan 1–255 karakter ASCII yang terlihat, tanpa spasi. Gunakan kembali kunci tersebut dengan
akun, cakupan, prinsipal manajemen, wilayah, dan versi API yang sama setelah respons hilang. Merotasi kredensial manajemen pada akun layanan yang sama
tidak membuat identitas percobaan ulang yang baru.
Instal paket requests Python. Muat nilai lingkungan berikut melalui
pengelolaan secret dan konfigurasi Anda yang biasa:
Python
201 dan berisi resource oauth_client
dengan id, service_account_id, client_id, scopes, status, created_at, dan
client_secret. Respons ditandai Cache-Control: no-store.
idmengidentifikasi resource platform. Simpan untuk pengambilan dan pencabutan.client_idmengidentifikasi klien selama pertukaran token. Ini bukan ID resource platform. Nilainya dapat berupanullsaat pembuatan masih tertunda.client_secrethanya dikembalikan kepada permintaan yang menyelesaikan pembuatan. Setiap permintaan pembuatan berulang mengembalikannull, termasuk percobaan ulang setelah respons keberhasilan hilang. Pengambilan tidak pernah mengembalikan secret.
Memulihkan respons yang hilang atau terputus
Ulangi permintaan pembuatan yang sama dengan kunci percobaan ulang yang tersimpan untuk memulihkan tanda terima resource. Tanda terima mencerminkan status terkini, sehingga klien yang telah dicabut tetap berstatus dicabut. Operasi ini tidak menggunakan kontrak pemutaran ulang respons tersimpan selama 24 jam yang umum dan tidak mengembalikan headerIdempotent-Replayed.
Lihat kesalahan untuk ID permintaan dan detail pemulihan.
Jangan pernah mengirim secret klien atau token akses bersama permintaan dukungan.
Memeriksa dan mencabut
Gunakan kredensial manajemen Anda danid resource platform:
Pencabutan memblokir permintaan API berikutnya dari klien, termasuk permintaan dengan
token yang sudah diterbitkan. Pencabutan tidak membatalkan pekerjaan yang sudah diterima oleh API.
Pembersihan kredensial jarak jauh dapat selesai kemudian. Mengulangi pencabutan aman dilakukan dan
tidak memerlukan kunci percobaan ulang. Lanjutkan menggunakan kredensial manajemen jika klien
yang dicabut itu sendiri merupakan pemanggil API.

