Rancang integrasi kepatuhan Anda

Integrasi Compliance API produksi membuat tiga pilihan desain: bagaimana ia mengonsumsi Activity Feed, bagaimana outputnya berkorelasi dengan sistem "security information and event management" (manajemen informasi dan event keamanan), atau SIEM, Anda, dan di mana salinan jangka panjang aktivitas dan konten disimpan. Pilihan-pilihan ini tidak bergantung pada endpoint itu sendiri; halaman ini membantu Anda mengevaluasi tradeoff-nya.

Halaman ini mengasumsikan Anda telah membaca halaman-halaman berikut:

• Kueri Activity Feed, yang mendefinisikan parameter dan kontrak paginasi yang dirujuk di seluruh halaman ini.
• Ambil dan hapus chat, file, dan proyek, yang mendefinisikan endpoint chat, file, dan proyek serta semantik deleted_at yang dirujuk dalam Rencanakan retensi konten.
• Ambil transkrip sesi, yang mendefinisikan endpoint sesi lokal dan remote.

Pilih pola konsumsi feed

Activity Feed mendukung dua pola konsumsi: "window polling" (polling jendela) periodik yang dibatasi oleh created_at.gte dan created_at.lt, serta pembacaan inkremental berbasis kursor yang menyimpan kursor dari satu respons dan meneruskannya pada permintaan berikutnya. Keduanya mengembalikan objek Activity yang identik; perbedaannya adalah state yang disimpan klien Anda di antara panggilan.

Kedua pola berbagi batasan berikut:

• Aktivitas dapat dikueri dalam 1 menit setelah terjadi dan disimpan selama 6 tahun. Pencatatan tidak bersifat retroaktif: pencatatan dimulai ketika Compliance API pertama kali diaktifkan untuk organisasi Anda, dan aktivitas dari sebelum pengaktifan tidak diisi ulang (backfill).
• limit maksimum untuk setiap halaman adalah 5.000.
• Nilai kursor adalah string opaque yang tidak boleh Anda parse.
• Permintaan dibatasi hingga 600 per menit per organisasi induk, dibagi bersama di seluruh kunci, seluruh organisasi tertaut, dan seluruh endpoint /v1/compliance/*; tidak seperti endpoint sesi lokal, endpoint sesi remote memiliki anggaran permintaan kedua di atasnya. Lihat 429 Too Many Requests untuk header respons dan kontrak retry.

Window polling

Tetapkan created_at.lt setidaknya 1 menit di masa lalu sehingga setiap aktivitas dalam jendela sudah dapat dikueri. Gunakan created_at.gte untuk batas bawah dan created_at.lt untuk batas atas sehingga jendela yang berurutan tersusun rapat tanpa celah atau tumpang tindih; gunakan kembali nilai lt jendela sebelumnya sebagai gte jendela berikutnya.

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/activities" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --data-urlencode "created_at.gte=2026-04-20T07:00:00Z" \
  --data-urlencode "created_at.lt=2026-04-20T08:00:00Z" \
  --data-urlencode "limit=5000"

Ketika respons memiliki has_more: true, jendela berisi lebih dari satu halaman aktivitas. Lakukan paginasi di dalam jendela dengan meneruskan last_id respons sebagai after_id pada permintaan berikutnya (berhenti ketika has_more bernilai false), atau pilih jendela waktu yang lebih kecil. Lihat Paginasi hasil untuk kontrak lengkapnya.

Bahkan dengan penyusunan yang rapi, aktivitas yang terindeks setelah jendelanya ditutup tidak akan pernah muncul di jendela berikutnya. Lakukan deduplikasi pada id aktivitas dan perlebar setiap jendela baru sehingga tumpang tindih dengan jendela sebelumnya selama beberapa menit, atau jalankan proses rekonsiliasi periodik yang mengueri ulang jendela yang lebih lama.

Pembacaan inkremental berbasis kursor

first_id="activity_01XyDMpzjS89pFZXqSFUBDr6"  # first_id from a previous response

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/activities" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --data-urlencode "limit=5000" \
  --data-urlencode "before_id=$first_id"

Lakukan paginasi hingga has_more bernilai false, lalu simpan first_id dari respons terakhir dan teruskan tanpa perubahan sebagai before_id pada eksekusi berikutnya untuk mengambil aktivitas yang lebih baru dari kursor yang disimpan. Untuk berjalan ke arah sebaliknya untuk backfill, simpan last_id dan teruskan sebagai after_id. Untuk referensi lengkap kursor-vs-page-token dan semantik retry, lihat Paginasi hasil.

Loop catch-up produksi mengambil aktivitas yang tercatat sejak polling terakhir Anda dengan menggerakkan iterasi berdasarkan has_more dan first_id:

cursor = stored_cursor
loop:
  page = GET /v1/compliance/activities?before_id={cursor}&limit=5000
  store(page.data)
  if page.first_id is not null:
    cursor = page.first_id
  if not page.has_more: break
persist(cursor)

Kursor tetap berlaku setelah rotasi kunci; lihat Kelola dan rotasi kunci.

Korelasikan dengan SIEM Anda

Setiap Activity membawa field yang dapat Anda join dengan event yang sudah ada di SIEM Anda (Splunk, Datadog, Microsoft Sentinel, Cribl, atau sejenisnya):

actor.user_id dan actor.email_address ada ketika actor.type adalah user_actor. actor.ip_address dan actor.user_agent tidak ada pada beberapa tipe actor, seperti anthropic_actor dan scim_directory_sync_actor. Periksa diskriminator sebelum membaca field-field ini. user_id adalah pengidentifikasi stabil dan opaque untuk akun pengguna: nilainya konsisten di seluruh endpoint Compliance API dan payload aktivitas, dan tidak berubah ketika email atau nama tampilan pengguna berubah. Gunakan user_id, bukan email_address, sebagai kunci join utama.

Panggilan ke Compliance API itu sendiri menghasilkan aktivitas compliance_api_accessed. Ingest aktivitas ini bersama tipe aktivitas lainnya sehingga SIEM Anda mencatat siapa yang mengueri data kepatuhan, dan kapan. Teruskan activity_types[]=compliance_api_accessed untuk membatasi kueri, lalu di klien Anda, baca actor.api_key_id dari setiap aktivitas yang actor.type-nya adalah api_actor untuk mengatribusikan akses tersebut ke Compliance Access Key atau kunci Admin API tertentu.

Rencanakan retensi konten

Lima horizon retensi mengatur apa yang dapat Anda ambil nanti:

Untuk mempelajari bagaimana bagian lain Claude Platform menangani retensi, lihat API dan retensi data.

Putuskan antara ekspor-dan-arsip dan pengambilan API sesuai permintaan sebagai berikut:

• Jika horizon legal-hold atau audit Anda melebihi 6 tahun untuk metadata aktivitas atau transkrip sesi, ekspor halaman Activity Feed dan transkrip sesi ke arsip Anda sendiri saat Anda mengingestnya.
• Jika kebijakan retensi konten Anda lebih pendek dari horizon eDiscovery Anda, ekspor konten chat dan file sebelum jendela retensi berakhir; Compliance API tidak dapat mengembalikan konten yang sudah dihapus oleh retensi. Hal yang sama berlaku untuk transkrip sesi lokal, yang mengikuti periode retensi percakapan kustom organisasi Anda ketika periode terbatas ditetapkan, bahkan ketika periode tersebut lebih pendek dari 6 tahun. Endpoint sesi lokal berhenti mengembalikan pesan yang lebih lama dari periode organisasi Anda saat ini segera setelah pengaturan berubah, dan memperpanjang periode di kemudian hari tidak memulihkan transkrip yang sudah kedaluwarsa, jadi ekspor transkrip apa pun yang harus Anda simpan melampaui periode tersebut.
• Jika Anda harus menyimpan konten chat setelah pengguna menghapusnya di claude.ai (misalnya, di bawah legal hold), ekspor konten chat, file, dan artifact ke arsip Anda sendiri saat Anda mengingestnya; Compliance API tidak dapat mengembalikan konten yang sudah dihapus pengguna.
• Jika suatu alur kerja mungkin mengeluarkan hard-delete Compliance API (misalnya, penegakan DLP), ambil dan arsipkan konten target terlebih dahulu. Tidak ada jendela pemulihan setelah hard-delete.

Dalam semua kasus lainnya, andalkan pengambilan API langsung dan hindari memelihara salinan paralel.

Jaminan pengiriman dan kelengkapan

Perlakukan Activity Feed sebagai at-least-once: traversal yang dipaginasi dengan benar mengembalikan setiap aktivitas setidaknya sekali, tetapi retry setelah kegagalan parsial dapat mengirim ulang aktivitas yang sudah Anda simpan. Lakukan deduplikasi pada field id aktivitas.

Endpoint list tidak mengembalikan field total_count atau checksum. Untuk membuktikan bahwa suatu eksekusi ekspor sudah lengkap, catat:

• Kursor awal dan last_id terminal.
• Jumlah catatan yang diekspor.
• Timestamp eksekusi dan request-id halaman terakhir.

Volume aktivitas bukanlah pemeriksaan kelengkapan. Tipe aktivitas claude_*_viewed, seperti claude_chat_viewed, mengikuti pola pemuatan masing-masing aplikasi (lihat Pahami objek Activity). Periode dengan pesan chat tetapi tanpa aktivitas claude_chat_viewed tidak dengan sendirinya menunjukkan data yang hilang. Sebagai gantinya, andalkan traversal dan proses tumpang tindih atau rekonsiliasi yang dijelaskan dalam Window polling.

Endpoint konten (chat, file, proyek, lampiran proyek, serta transkrip sesi lokal dan remote) hanya melayani data Claude Enterprise. Activity Feed menampilkan event administratif dan sumber daya di seluruh organisasi. Compliance API tidak mencakup:

• Teks prompt atau respons model dari Claude Console, atau dari beban kerja Claude API yang diautentikasi dengan kunci API.
• Aktivitas di perangkat dalam sesi lokal yang tidak pernah dikirim ke Anthropic, seperti file lokal yang tidak dibaca Claude.
• Penggunaan Claude Code yang diautentikasi dengan kunci API Claude Console, dijalankan melalui platform cloud pihak ketiga (Amazon Bedrock, Google Cloud, atau Microsoft Foundry), atau dijalankan di Claude Code di web.
• Sesi lokal dari organisasi dengan kesiapan HIPAA diaktifkan, dan sesi lokal yang berlaku zero data retention.
• Blok thinking, serta gambar atau konten biner lainnya, di dalam transkrip sesi (transkrip hanya membawa prompt pengguna, respons asisten, dan aktivitas alat; transkrip sesi lokal menampilkan blok text placeholder di tempat konten biner dihilangkan).
• File asli untuk lampiran chat yang disimpan claude.ai sebagai teks terekstrak, seperti beberapa unggahan Word, PowerPoint, dan PDF (endpoint konten file mengembalikan teks terekstrak; lihat Ambil file dan artifact).
• Prompt sistem sesi lokal (pesan penanda menggantikannya).
• Definisi alat dan konfigurasi server MCP dalam transkrip sesi (lokal atau remote), serta metadata sitasi pada blok text dalam transkrip sesi lokal.
• Konten transkrip sesi lokal dalam organisasi yang kunci enkripsi yang dikelola pelanggan-nya saat ini tidak dapat digunakan. Permintaan tersebut mengembalikan 503 Service Unavailable, dan metadata sesi tetap terdaftar.
• Konten yang dihapus oleh kebijakan retensi organisasi Anda.
• Konten chat yang dihapus pengguna di claude.ai (chat tetap terdaftar, dengan deleted_at terisi).
• Konten yang di-hard-delete melalui Compliance API.

Lihat FAQ Compliance API untuk informasi lebih lanjut tentang apa yang ditangkap dan tidak ditangkap oleh Compliance API.

Untuk chain of custody, simpan catatan yang diekspor dengan metadata provenans: endpoint sumber, parameter kueri, timestamp eksekusi, dan hash konten setiap catatan.

Langkah selanjutnya