Referensi kode error Control Zero

Setiap error yang terlihat pengguna dari SDK dan CLI Control Zero membawa kode E#### yang stabil. Setiap kode memiliki halamannya sendiri di situs ini; klik kode di pesan error mana pun dan Anda akan sampai ke perbaikan kanonisnya.

Kode SDK didefinisikan sekali di katalog error bersama (sdks/error-catalog/error_codes.yaml) dan memiliki arti yang sama di SDK Python dan Node.

Kode diorganisasi berdasarkan area:

Rentang	Area
E1000-E1099	Keamanan dan manajemen secret
E1100-E1199	Autentikasi dan pendaftaran
E1200-E1299	Pemuatan / validasi / bundel kebijakan
E1300-E1399	Cache dan tata letak disk lokal
E1400-E1499	Jaringan dan backend jarak jauh
E1500-E1599	Gerbang persetujuan, subproses hook, integrasi agen
E1600-E1699	Runtime SDK (guard / audit / close)
E1700-E1799	Persetujuan HITL (Human-in-the-Loop) dan secret
E2000-E2099	Deteksi kebocoran kredensial
E3000-E3299	Backend platform (API / SSO)
E4000-E4099	Gateway tata kelola

Keamanan dan secret (E10xx)

• E1001 -- Kunci API ditemukan di file pengaturan agen
• E1002 -- Direktori ~/.controlzero dapat dibaca semua pengguna
• E1003 -- config.yaml dapat dibaca semua pengguna
• E1004 -- Kunci API ditemukan di riwayat shell
• E1005 -- Tidak dapat membaca file pengaturan agen

Autentikasi dan pendaftaran (E11xx)

• E1101 -- Kunci API ditolak (401)
• E1102 -- Token pendaftaran kedaluwarsa
• E1103 -- Kunci API tidak ditemukan
• E1104 -- Format kunci API tidak valid

Pemuatan / validasi / bundel kebijakan (E12xx)

• E1201 -- File kebijakan gagal validasi
• E1202 -- File kebijakan tidak ditemukan
• E1203 -- Tanda tangan bundel kebijakan tidak cocok
• E1204 -- Konflik versi kebijakan
• E1205 -- Bundel kebijakan tidak ada, fail-closed aktif

Cache dan tata letak disk lokal (E13xx)

• E1301 -- Izin direktori cache salah
• E1302 -- Bundel usang untuk kunci yang sudah dirotasi
• E1303 -- Log audit tidak dapat ditulis

Jaringan dan backend jarak jauh (E14xx)

• E1401 -- Backend tidak dapat dijangkau
• E1402 -- Backend mengembalikan 5xx
• E1403 -- Batas laju terlampaui
• E1404 -- Verifikasi TLS gagal
• E1405 -- Fitur tidak tersedia di paket Anda

Gerbang persetujuan dan subproses hook (E15xx)

• E1500 -- Persetujuan dinonaktifkan pada cakupan ini
• E1501 -- Input hook bukan JSON
• E1502 -- Hook kehabisan waktu
• E1503 -- Hook mengembalikan kunci keputusan yang salah
• E1504 -- Kesalahan sintaks hook agen Windows

Runtime SDK (E16xx)

• E1601 -- guard() dipanggil setelah close()
• E1602 -- Nama alat tidak ada di kosakata kanonis
• E1603 -- Hash argumen tidak cocok (pemeriksaan deterministik)

Persetujuan HITL dan secret (E17xx)

Alur persetujuan (human-in-the-loop) berstatus Beta dan tersedia di setiap deployment, termasuk paket hosted (SaaS). Persetujuan nonaktif secara default; seorang administrator mengaktifkannya per cakupan. Lihat Alur Persetujuan untuk ketersediaan dan Siapkan persetujuan untuk pengaturan aktivasinya.

• E1701 -- Permintaan persetujuan kehabisan waktu
• E1702 -- Backend persetujuan tidak dapat dijangkau
• E1703 -- Konflik versi kebijakan persetujuan
• E1704 -- Persetujuan belum dikonfigurasi untuk organisasi ini
• E1705 -- Tidak ada pemberi persetujuan yang tersedia
• E1706 -- Identitas pemohon tidak ada di organisasi
• E1707 -- Identitas pemohon diperlukan
• E1708 -- Klaim identitas pemohon ditolak
• E1709 -- Kebocoran nilai secret di payload
• E1710 -- Persetujuan secret diperlukan
• E1711 -- Secret tidak ditemukan
• E1712 -- Bundel memerlukan SDK yang lebih baru

Deteksi kebocoran kredensial (E20xx)

• E2001 -- Kebocoran kredensial terdeteksi pada output alat

Backend platform (E3xxx)

Dikembalikan oleh API platform Control Zero dalam body error terstruktur { "error": { "code", "reason_code", "request_id", ... } }. reason_code adalah E#### yang stabil; sebutkan request_id kepada dukungan agar error dapat dilacak ke lognya.

Kode	Arti
E3000	Error internal server
E3001	Permintaan gagal validasi
E3002	Sumber daya tidak ditemukan
E3003	Izin ditolak
E3004	Autentikasi diperlukan atau gagal
E3005	Batas laju atau penggunaan terlampaui
E3006	Dependensi upstream tidak tersedia
E3007	Konflik status / sudah ada
E3008	Pelanggaran integritas / lintas-tenant
E3009	Layanan tidak tersedia
E3010	Permintaan cacat format (malformed)
E3011	Token CSRF tidak ada atau tidak valid
E3012	Body permintaan melebihi batas ukuran
E3200	SSO belum dikonfigurasi untuk organisasi ini
E3201	SSO dikonfigurasi tetapi tidak valid
E3202	Identity provider tidak dapat dijangkau
E3203	SSO state missing, expired, or tampered
E3204	Token / assertion SSO ditolak
E3205	Tidak ada pemetaan peran, atau paket tidak mengizinkan peran tersebut
E3206	Akun ditangguhkan atau tidak aktif

Gateway tata kelola (E4xxx)

Dikembalikan oleh gateway tata kelola.

Teks asli berbahasa Inggris -- terjemahan menunggu tinjauan teknis

Enforcement-path failures fail closed: if the gateway cannot complete its policy / DLP / auth checks it denies the request rather than forwarding it.

Kode	Arti
E4000	Error internal gateway (jalur non-penerapan)
E4001	Governance evaluation failed; request denied (fail-closed)
E4002	Permintaan cacat format (malformed)
E4003	Batas laju terlampaui
E4004	Autentikasi diperlukan atau tidak valid
E4005	Gateway tata kelola belum diinisialisasi

Melaporkan error baru yang Anda temui

Jika controlzero doctor melaporkan kode yang halamannya tidak dapat Anda temukan, berarti halamannya belum dipublikasikan. Buka issue di github.com/controlzero/control_zero/issues dan sertakan pesan error lengkap serta output controlzero env-dump Anda (dengan --show-secrets dibiarkan MATI).