---
title: Menyiapkan Compliance API
url: https://platform.claude.com/docs/id/manage-claude/compliance-api-access
description: Aktifkan Compliance API untuk organisasi Anda, lalu buat Compliance Access Key (dengan izin terbatas cakupan) atau kunci Admin API, dan pelajari mana yang harus digunakan.
---
Organisasi Claude Enterprise dan organisasi Claude Console mandiri yang memenuhi syarat memiliki akses swalayan ke Compliance API. Halaman ini menjelaskan cara mengaktifkan Compliance API untuk organisasi Anda dan membuat kunci API.
**Peran yang diperlukan:** admin organisasi (Claude Console), atau pemilik utama atau pemilik organisasi (claude.ai).
Compliance API menggunakan dua jenis kunci, dan kunci mana yang Anda buat bergantung pada produk Claude yang digunakan organisasi Anda. Pemilik utama dan pemilik organisasi membuat Compliance Access Key di claude.ai; kunci ini membuka akses ke seluruh Compliance API. Kunci milik pemilik utama dapat mencakup setiap organisasi di bawah organisasi induk; kunci milik pemilik organisasi hanya mencakup organisasinya sendiri. Admin organisasi membuat kunci Admin API di Claude Console; kunci ini hanya membuka akses ke [Activity Feed](https://platform.claude.com/docs/id/manage-claude/compliance-activity-feed).
## Kunci mana yang Anda perlukan?
| Jenis kunci | Dibuat di | Digunakan untuk | Berfungsi dengan Compliance API? |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| **Compliance Access Key** (`sk-ant-api01-...`) | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | Activity Feed, chat, file, proyek, sesi (di aplikasi seperti Cowork dan Claude Code), pengguna, metadata organisasi, dan pengaturan organisasi | Ya (semua endpoint) |
| **Kunci Admin API** (`sk-ant-admin01-...`) | Halaman [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) di Claude Console | [Admin API](https://platform.claude.com/docs/id/manage-claude/admin-api) dan Activity Feed Compliance API | Hanya Activity Feed |
| **Kunci Analytics API** | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | Claude Enterprise Analytics API (lihat [Analytics API](https://platform.claude.com/docs/id/manage-claude/analytics-api)) | Tidak |
| **Kunci Claude API** (`sk-ant-api03-...`) | Halaman [API keys](https://platform.claude.com/settings/keys) (`platform.claude.com/settings/keys`) di Claude Console | Memanggil model Claude melalui [Claude API](https://platform.claude.com/docs/id/api/overview) | Tidak |
Tenant Claude Enterprise memiliki satu **organisasi induk** ("parent organization") yang memusatkan identitas, SSO, dan SCIM untuk setiap organisasi beban kerja di bawahnya. Organisasi beban kerja ini adalah **organisasi tertaut** ("linked organizations") milik induk tersebut.
**Organisasi induk Claude Enterprise tidak muncul di Claude Console (`platform.claude.com`).** Organisasi induk tidak memiliki beban kerja, tidak memiliki kunci Claude API, dan tidak memiliki kunci Admin API. Buat Compliance Access Key di **Organization settings** claude.ai, bukan di Claude Console.
## Menyiapkan Compliance API
Penyiapan terdiri dari satu alur: aktifkan Compliance API untuk organisasi Anda, lalu buat Compliance Access Key di claude.ai. Organisasi Claude Console sebaliknya [membuat kunci Admin API](https://platform.claude.com/docs/id/manage-claude/compliance-api-access#create-an-admin-api-key) setelah pengaktifan; kunci Admin API hanya dapat menjangkau [Activity Feed](https://platform.claude.com/docs/id/manage-claude/compliance-activity-feed).
Compliance Access Key dengan `read:compliance_user_data` dapat membaca setiap chat, file, proyek, dan transkrip sesi di setiap organisasi tertaut, termasuk konten yang belum pernah dilihat oleh pemilik utama. Kunci dengan `delete:compliance_user_data` dapat menghapus chat, file, dan proyek secara permanen. Perlakukan Compliance Access Key seperti kredensial database produksi: simpan di secrets manager, jangan pernah di source control atau konfigurasi forwarder SIEM.
Tempat Anda mengaktifkan Compliance API bergantung pada cara organisasi Anda disiapkan:
* **Organisasi Claude Enterprise:** Pemilik utama mengaktifkan Compliance API di [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access). Pengaktifan terjadi di tingkat organisasi induk dan diteruskan ke setiap organisasi tertaut, baik claude.ai maupun Claude Console.
* **Organisasi Claude Console mandiri:** Admin organisasi mengaktifkan toggle **Compliance API** di halaman [Compliance](https://platform.claude.com/settings/security) (`platform.claude.com/settings/security`) di Claude Console. Pengaktifan bersifat swalayan untuk organisasi yang memenuhi syarat, dan perubahan berlaku segera. Jika halaman menampilkan error halaman tidak ditemukan, atau tidak menampilkan bagian **Compliance API**, berarti Anda tidak memiliki peran admin, organisasi Anda tertaut ke organisasi induk (Compliance API diaktifkan dari organisasi induk), atau organisasi Anda tidak memenuhi syarat untuk pengaktifan swalayan; hubungi tim akun Anda atau [dukungan Anthropic](https://support.claude.com) jika Anda tidak yakin mana yang berlaku.
* **Organisasi Claude Console yang tertaut ke organisasi induk:** Tidak ada yang perlu diaktifkan di Claude Console. Minta pemilik utama organisasi induk Anda untuk mengaktifkan Compliance API di claude.ai, atau hubungi tim akun Anda.
**Menonaktifkan Compliance API menghentikan perekaman aktivitas.** Admin organisasi dapat menonaktifkan Compliance API kapan saja dengan toggle **Compliance API** yang sama yang digunakan untuk mengaktifkannya. Selama Compliance API nonaktif, tidak ada peristiwa aktivitas yang direkam untuk organisasi Anda, sehingga [Activity Feed](https://platform.claude.com/docs/id/manage-claude/compliance-activity-feed) tidak menerima peristiwa baru. Jika organisasi Anda terdaftar dalam [Access Transparency](https://platform.claude.com/docs/id/manage-claude/access-transparency), menonaktifkan Compliance API juga menghentikan pengiriman peristiwa Access Transparency. Aktivitas yang tidak direkam selama Compliance API nonaktif tidak dapat dipulihkan kemudian. Mengaktifkan kembali Compliance API melanjutkan perekaman sejak saat itu; aktivitas yang sudah direkam tidak dihapus. Untuk organisasi Claude Enterprise, pengaturan Compliance API di claude.ai juga mengatur penangkapan transkrip untuk [sesi lokal](https://platform.claude.com/docs/id/manage-claude/compliance-sessions#retrieve-local-sessions) (sesi di mesin pengguna): penangkapan dimulai saat Compliance API diaktifkan dan berhenti selama nonaktif, dan konten transkrip dari sesi yang berjalan selama nonaktif tidak ditangkap dan tidak dapat dipulihkan kemudian.
Organisasi Claude Console mandiri menggunakan kunci Admin API, bukan Compliance Access Key: setelah pengaktifan, lewati langkah-langkah selanjutnya dan [buat kunci Admin API baru](https://platform.claude.com/docs/id/manage-claude/compliance-api-access#create-an-admin-api-key) sebagai gantinya. Langkah-langkah selanjutnya menyediakan Compliance Access Key, yang hanya tersedia bagi organisasi yang merupakan bagian dari tenant Claude Enterprise.
Akses sebuah kunci ditetapkan saat kunci dibuat. Tentukan organisasi mana yang dicakup kunci tersebut:
* Kunci untuk **organisasi induk** dapat mengakses setiap organisasi di bawah organisasi induk.
* Kunci untuk **satu organisasi** hanya dapat mengakses organisasi tersebut.
Masuk ke claude.ai. Pemilik utama organisasi induk dapat membuat kunci dengan cakupan mana pun. Pemilik organisasi hanya dapat membuat kunci yang dibatasi pada organisasinya sendiri.
Jika halaman **API** yang dijelaskan pada langkah berikutnya tidak terlihat, atau scope kepatuhan tidak tersedia saat membuat kunci, berarti peran Anda tidak dapat membuat Compliance Access Key, atau Compliance API belum diaktifkan untuk organisasi Anda (kembali ke langkah pertama).
Buka [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) dan temukan bagian **Keys**.
Klik **Create key**, beri nama kunci, dan pilih satu atau beberapa scope dari tabel berikut. Klik **Create**.
| Cakupan | Memberikan |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `read:compliance_activities` | Membaca Activity Feed. Kunci yang mencakup organisasi induk membaca peristiwa untuk organisasi induk dan semua organisasi tertaut. |
| `read:compliance_user_data` | Membaca chat, pesan, file, proyek, metadata dan transkrip sesi pengguna, pengguna organisasi, preferensi pengguna, dan anggota grup |
| `delete:compliance_user_data` | Menghapus chat, file, dan proyek pengguna |
| `read:compliance_org_data` | Membaca metadata organisasi (nama, jenis, peran, dan grup) serta pengaturan efektif yang berlaku untuk organisasi di bawah organisasi induk. Daftar pengguna dan keanggotaan grup memerlukan `read:compliance_user_data`. |
Dengan Plugins API, `read:compliance_org_data` juga membaca inventaris plugin dan marketplace plugin organisasi Anda melalui Admin API, termasuk plugin pribadi anggota beserta file-filenya. Inventaris tersebut mengidentifikasi anggota: inventaris memuat ID pengguna setiap anggota yang memiliki atau membuat plugin, atau yang menerima plugin yang dibagikan secara individual, serta alamat email pembuat plugin selama mereka masih menjadi anggota; lihat [Membaca plugin dan marketplace plugin](https://platform.claude.com/docs/id/manage-claude/compliance-org-data#read-plugins-and-plugin-marketplaces).
Pilih kumpulan scope terkecil yang dibutuhkan integrasi Anda:
* Pipeline audit yang hanya membaca Activity Feed hanya memerlukan `read:compliance_activities`.
* Alat eDiscovery yang membaca chat dan file tetapi tidak pernah menghapusnya tidak memerlukan `delete:compliance_user_data`.
* Jika alur kerja Anda membaca sekaligus menghapus, gunakan **dua kunci** dengan scope terpisah sehingga kunci baca yang bocor tidak dapat menghapus data.
Scope Compliance Access Key tidak dapat diubah setelah dibuat. Untuk mengubah scope, buat kunci baru dengan scope yang Anda inginkan, lalu hapus kunci lama.
Salin secret key yang ditampilkan (diawali dengan `sk-ant-api01-`) dan simpan di secrets manager Anda. Secret lengkap hanya ditampilkan satu kali.
Tetapkan kunci sebagai variabel lingkungan agar contoh shell dalam panduan ini dapat membacanya:
```bash
export ANTHROPIC_COMPLIANCE_ACCESS_KEY=sk-ant-api01-...
```
## Membuat kunci Admin API
Compliance API harus sudah [diaktifkan untuk organisasi Claude Console Anda](https://platform.claude.com/docs/id/manage-claude/compliance-api-access#set-up-the-compliance-api) sebelum kunci Admin API dapat memanggil Activity Feed.
Ikuti langkah-langkah di [Membuat kunci Admin API](https://platform.claude.com/docs/id/manage-claude/admin-api-keys#create-a-key-for-a-claude-console-organization), lalu tetapkan kunci sebagai variabel lingkungan:
```bash
export ANTHROPIC_ADMIN_KEY=sk-ant-admin01-...
```
Nama variabel yang berbeda mencegah kunci Admin API menimpa Compliance Access Key jika Anda menyediakan keduanya. Contoh cURL dalam panduan ini membaca kunci dari `$ANTHROPIC_COMPLIANCE_ACCESS_KEY`; ganti dengan `$ANTHROPIC_ADMIN_KEY` saat memanggil [Activity Feed](https://platform.claude.com/docs/id/manage-claude/compliance-activity-feed) dengan kunci Admin API.
Kunci Admin API membawa scope `read:compliance_activities` hanya jika Compliance API telah diaktifkan untuk organisasi pada saat kunci dibuat; lihat [Menyiapkan Compliance API](https://platform.claude.com/docs/id/manage-claude/compliance-api-access#set-up-the-compliance-api). Kunci ini tidak dapat diberi scope Compliance API lainnya, sehingga panggilan ke endpoint apa pun selain Activity Feed mengembalikan [403 Forbidden](https://platform.claude.com/docs/id/manage-claude/compliance-errors#403-forbidden).
Untuk peran kunci yang sama dalam mengelola organisasi Claude Console Anda, lihat [Admin API](https://platform.claude.com/docs/id/manage-claude/admin-api).
## Memeriksa scope kunci Anda
Untuk memeriksa scope pada kunci yang sudah Anda miliki, gunakan salah satu sinyal berikut.
* **Prefiks kunci.** `sk-ant-admin01-` adalah kunci Admin API (hanya membawa `read:compliance_activities`, bergantung pada waktu pengaktifan yang dijelaskan di bagian sebelumnya). `sk-ant-api01-` adalah Compliance Access Key; cakupannya adalah subset yang Anda pilih saat pembuatan.
* **UI pengaturan.** Untuk Compliance Access Key, buka bagian **Keys** di [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) dan baca kolom **Scopes** untuk kunci tersebut. Kunci Admin API, yang tercantum di halaman [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) di Claude Console, tidak memiliki cakupan yang dapat dipilih.
* **Respons error.** Panggilan yang melebihi cakupan kunci akan mengembalikan 403 dengan pesan dalam format `Missing required scopes. Got: [] Needed one of: []` (`Needed: [...]` pada endpoint penghapusan). Lihat [Menangani error Compliance API](https://platform.claude.com/docs/id/manage-claude/compliance-errors#403-forbidden) untuk katalog error lengkap.
```json
{
"error": {
"type": "permission_error",
"message": "Missing required scopes. Got: ['read:compliance_activities'] Needed one of: ['read:compliance_user_data', 'read:org_audit']"
}
}
```
## Mengelola dan merotasi kunci
Hapus Compliance Access Key dari tabel **Keys** yang sama tempat Anda membuatnya: buka [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access). Hapus kunci Admin API dari halaman [Admin keys](https://platform.claude.com/settings/admin-keys) (`platform.claude.com/settings/admin-keys`) di Claude Console.
Penghapusan kunci berlaku pada permintaan berikutnya: tidak ada masa tenggang. Compliance Access Key tidak kedaluwarsa dengan sendirinya.
Untuk merotasi kunci tanpa gangguan layanan:
1. Buat kunci baru dengan scope yang sama.
2. Perbarui integrasi Anda untuk menggunakan kunci baru.
3. Verifikasi bahwa integrasi berhasil dengan kunci baru.
4. Hapus kunci lama.
Kursor paginasi yang disimpan sebelum rotasi tetap valid: kursor dicakup ke organisasi, bukan ke kunci.
Jika Compliance Access Key bocor, segera hapus, audit [Activity Feed](https://platform.claude.com/docs/id/manage-claude/compliance-activity-feed) untuk aktivitas `compliance_api_accessed` oleh kunci yang disusupi, dan rotasi kredensial hilir apa pun yang dapat dijangkau oleh kunci yang bocor tersebut. Teruskan `activity_types[]=compliance_api_accessed` untuk membatasi cakupan kueri, lalu di klien Anda, pertahankan aktivitas yang `actor.type`-nya adalah `api_actor` dan `actor.api_key_id`-nya cocok dengan kunci yang disusupi; lihat [Memahami objek Activity](https://platform.claude.com/docs/id/manage-claude/compliance-activity-feed#understand-the-activity-object) untuk skema actor.
## Langkah selanjutnya
Baca peristiwa aktivitas seluruh organisasi dengan kunci apa pun yang memiliki `read:compliance_activities`.
Gunakan Compliance Access Key dengan `read:compliance_user_data` untuk mengambil chat, file, dan proyek claude.ai, dan `delete:compliance_user_data` untuk menghapusnya.
Gunakan Compliance Access Key dengan `read:compliance_user_data` untuk mencantumkan sesi yang dijalankan pengguna Anda di aplikasi dan agen Claude, seperti Cowork dan Claude Code, serta mengambil transkripnya.