Log Audit dan Operasi

Log Audit dan Operasi

Tujuan: riwayat operasi kueri untuk tindakan penyedia, pelaksanaan pekerjaan, dan pemecahan masalah.

Aliran UI

1. UI memuat log terbaru per akun.
2. Filter pengguna mencatat berdasarkan peristiwa tugas/pekerjaan/email/kredensial.
3. UI memperlihatkan halaman detail cakupan untuk setiap log.
4. UI dapat menjalankan pembersihan terkontrol untuk log lama menggunakan search-delete dry-run terlebih dahulu.

Alur Perpustakaan Klien

const logs = await api.logs.list(accountId, { limit: 50, offset: 0 });
const filtered = await api.logs.search(accountId, {
  query: "smtp_send_message",
  limit: 20,
});
if (filtered.data.length > 0) {
  await api.logs.get(filtered.data[0].id);
}

Alur HTTP/curl

API_BASE_URL="https://api.inbox-manager.com"

curl -sS "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/logs?limit=20&offset=0" \
  -H "authorization: Bearer ${BEARER_TOKEN}"

curl -sS -X POST "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/logs/search" \
  -H "authorization: Bearer ${BEARER_TOKEN}" \
  -H "content-type: application/json" \
  --data '{"query":"imap_fetch_body","limit":20,"offset":0}'

curl -sS "${API_BASE_URL}/api/logs/${LOG_ID}" \
  -H "authorization: Bearer ${BEARER_TOKEN}"

curl -sS -X POST "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/logs/search-delete" \
  -H "authorization: Bearer ${BEARER_TOKEN}" \
  -H "content-type: application/json" \
  --data '{"query":"debug","dry_run":true,"limit":100,"older_than":"2026-01-01T00:00:00.000Z"}'

Catatan

• Log mencakup akun dan aplikasi.
• Kebijakan keamanan mengecualikan teks biasa kredensial dari log.
• older_than diperlukan untuk search-delete.