authentication.
Setiap panggilan di bawah ini ditujukan ke API manajemen Authentication untuk aplikasi Anda. MANAGEMENT_BASE adalah:
openapi-authentication.json di bawah tag Setup, yang menjadi sumber pembuatan ulang SDK server.
Kredensial mana yang digunakan
Salah satu dari tiga kredensial dapat digunakan, dan masing-masing hanya dibatasi pada apa yang telah disetujui pemiliknya.
Kredensial berikut ditolak dengan
403 di setiap rute pengaturan, apa pun yang diminta:
- Rahasia utama aplikasi.
- Token dari
POST /programmatic/login, yang diterbitkan untuk aplikasi, bukan untuk konsol. - Kunci tanpa cakupan
authentication, termasuk kunci yang dibuat dengan setiap sumber daya pada tingkat tertinggi: kunci tersebut tercantum sebagai akses penuh, membiarkanscopeskosong, dan tidak diterima di rute ini. - Kunci dari aplikasi lain, grant yang hanya mencakup
didit:verification, dan grant yang disetujui untuk organisasi lain.
401. Grant atau kunci tetap memiliki batasannya sendiri: grant dibatasi oleh cakupan, organisasi, dan peran orang tersebut; kunci dibatasi oleh cakupan, daftar izin IP, dan tanggal kedaluwarsanya.
Setujui akses
Dengan kunci API bernama
Buka Developers -> API keys di Business Console dan buat kunci API untuk aplikasi yang sedang Anda siapkan. Berikan resourceauthentication akses baca atau tulis. Read mencakup setiap panggilan yang membaca pengaturan (GET). Write mencakup setiap panggilan yang mengubah pengaturan (POST, PUT, PATCH, DELETE) dan juga membaca pengaturan tersebut. Lihat Kunci API untuk masa berlaku, daftar IP yang diizinkan, dan rotasi. Satu kunci API hanya milik satu aplikasi dan hanya berfungsi untuk aplikasi itu.
Melalui koneksi MCP
Agen yang terhubung ke server MCP Didit menggunakan izin yang disetujui pemiliknya di layar persetujuan, dengandidit:management. Lihat Autentikasi MCP.
Untuk pemilik tanpa kata sandi
Pemberian kode perangkat (RFC 8628) memungkinkan pemilik yang masuk dengan Google, kunci sandi, atau kode yang dikirim lewat email untuk menyetujui akses yang sama dari browser mana pun, tanpa mengetikkan kata sandi. Lihat masuk tanpa browser.Aktifkan kode email
PUT methods/{name}/ menerima enabled, dan tidak ada parameter lain untuk metode yang tidak memerlukan kredensial.
credential_source: null. Metode yang selalu aktif tidak dapat dinonaktifkan: permintaan tersebut merespons dengan {"enabled": "always_on"}.
Mengaktifkan Google
Metode sosial menggunakan kredensial aplikasi OAuth Anda sendiri, atau aplikasi uji Didit pada aplikasi sandbox.Dengan aplikasi Google Anda sendiri
callback_uri yang dikembalikan oleh respons tersebut di penyedia Anda. Rahasia hanya dapat ditulis: tidak ada respons yang mengembalikannya, dan client_id adalah satu-satunya bagian yang bisa dibaca kembali. Mengaktifkan metode tanpa kredensial, jika sebelumnya belum ada kredensial yang tersimpan, akan menghasilkan {"credentials": "required"}.
Dengan aplikasi uji Didit (didit_test)
Aplikasi sandbox dapat menggunakan aplikasi sosial milik Didit sebagai pengganti aplikasi Anda sendiri, yang cukup untuk menyelesaikan pengaturan dan membuktikan bahwa pengaturan itu berfungsi:
didit_test mencakup Google, Microsoft, Apple dan GitHub, hanya pada aplikasi sandbox.
GET pada konfigurasi menyebutkan penyedia yang dapat dilayani aplikasi uji untuk aplikasi ini dalam didit_test_credentials. Nilainya false untuk keempat penyedia pada aplikasi produksi.
Membaca ulang pengaturan
GET pada MANAGEMENT_BASE adalah pembacaan ulang: setiap metode dengan enabled dan credential_source, beserta URL callback, aturan sesi, dan kebijakan pendaftaran.
GET sudah menunjukkan mana yang aktif dan mana yang tidak. enabled di bagian atas bernilai false jika Autentikasi dinonaktifkan untuk aplikasi. Setiap perubahan pengaturan yang dilakukan dengan izin manajemen atau kunci API bernama akan mengembalikan 409 dengan {"detail": "product_disabled"}, dan tidak ada yang disimpan. Tidak ada panggilan pengaturan yang mengaktifkan Autentikasi: seseorang mengaktifkannya untuk aplikasi di konsol, dan panggilan Anda berfungsi sejak saat itu.
Sisa penyiapan
Izin akses atau kunci hanya mendapatkan pengaturan dan penghitungnya, tidak pernah data pengguna akhir:
users/, sessions/, sign-ins/, overview/, organisasi pelanggan, peran, impor, sesi agen, dan email uji tetap memerlukan sesi konsol.
Pengaturan agent_humans_only berlaku untuk seluruh aplikasi. Hanya pemilik atau admin organisasi yang dapat mengubahnya. Kunci bernama menerima 403 owner_or_admin_required. Mengaktifkan pengaturan ini juga memerlukan passkey yang sudah didaftarkan (passkey_required).