Referensi hasil Security posture

Endpoint ini mengembalikan satu entri untuk masing-masing dari sebagian besar kontrol keamanan milik suatu organisasi, yang dievaluasi pada saat permintaan, beserta atestasi Security posture yang ditampilkan respons untuk setiap kontrol. Anda memerlukan Compliance Access Key yang mencakup organisasi tersebut, dengan scope read:compliance_org_data atau read:org_audit; Ketersediaan Security posture menjelaskan organisasi mana yang dapat dibaca.

Permintaan

Kirim permintaan GET ke /v1/compliance/organizations/{organization_id}/security_posture. Setiap panggilan membaca satu organisasi, dan respons tidak dipaginasi.

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/organizations/91012d09-e48b-438e-a489-1bebfd8fa6f9/security_posture" \
  -H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  -H "anthropic-version: 2026-10-21"

Respons

Contoh ringkas berikut menampilkan empat dari kontrol yang dapat dimuat dalam respons. Ini adalah respons untuk kunci yang memiliki read:compliance_org_data dan read:compliance_user_data.

{
  "type": "security_posture",
  "organization_id": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
  "evaluated_at": "2027-02-09T09:00:02.417305Z",
  "comments_status": "not_enabled",
  "controls": [
    {
      "id": "sso_enabled",
      "display_name": "Single sign-on (SSO)",
      "section": "identity_access",
      "setting_name": "sso_enabled",
      "status": "passed",
      "rating": "passed",
      "current_value": "On",
      "desired_state": "On",
      "attestation": null
    },
    {
      "id": "directory_sync_enabled",
      "display_name": "Directory sync (SCIM)",
      "section": "identity_access",
      "setting_name": "directory_sync_enabled",
      "status": "failed_check_accepted_risk",
      "rating": "passed",
      "current_value": "Off",
      "desired_state": "On",
      "attestation": {
        "state": "in_force",
        "attested_at": "2026-10-20T15:04:00.220114Z",
        "comment": null,
        "attested_by": {
          "type": "user_actor",
          "user_id": "user_01WxYzAbCdEfGhJkMnPqRsTu"
        }
      }
    },
    {
      "id": "allowed_invite_domains",
      "display_name": "Allowed email domains",
      "section": "identity_access",
      "setting_name": "allowed_invite_domains",
      "status": "descriptive",
      "rating": "descriptive",
      "current_value": "example.com",
      "desired_state": null,
      "attestation": null
    },
    {
      "id": "oauth_conditional_access",
      "display_name": "OAuth conditional access on connected SaaS",
      "section": "connectors_integrations",
      "setting_name": null,
      "status": "not_attested",
      "rating": "not_attested",
      "current_value": null,
      "desired_state": "Completed",
      "attestation": {
        "state": "review_due",
        "attested_at": "2026-11-02T09:30:00.008771Z",
        "comment": null,
        "attested_by": {
          "type": "user_actor",
          "user_id": "user_01AbCdEfGhJkLmNpQrStUvWx"
        }
      }
    }
  ]
}

Setiap field selalu ada, dan field tanpa nilai bernilai null; field tersebut tidak pernah dihilangkan. Nilai waktu memiliki nol atau enam digit pecahan, jadi bandingkan waktu sebagai waktu, bukan sebagai string.

Field tingkat atas

Field controls[]

section adalah salah satu dari identity_access, data_privacy, capabilities, connectors_integrations, chats_desktop_mdm, cowork_admin_console, cowork_desktop_mdm, claude_code_admin_console, claude_code_managed_settings, dan healthy_adoption.

Untuk membandingkan nilai dalam kode, cari setting_name di pengaturan efektif organisasi yang sama. Pencarian ini bisa tidak menemukan apa pun, dan dua kontrol dapat berbagi satu setting_name.

Field attestation

Field attested_by

Nilai status

status memberikan alasan hasil suatu kontrol, dan setiap status memiliki satu rating.

Tidak ada field yang menyebutkan jenis kontrol; untuk failed, current_value yang bernilai null menandakan kontrol manual. Nilai lain dapat ditambahkan, jadi hitung kontrol dengan status yang tidak dikenal berdasarkan rating-nya, dan rating yang tidak dikenal tidak dianggap Lulus. Status review dan keadaan atestasi review_due tidak berkaitan.

Keadaan atestasi

state menyatakan apakah atestasi yang respons tampilkan berlaku.

Jika lebih dari satu alasan berlaku, respons memberikan yang pertama dari check_passing, setting_changed, dan review_due. Sejak pukul 00.00 UTC pada tanggal berakhirnya, atestasi tidak berlaku. Respons tidak memuat tanggal berakhir, jadi state yang menentukan; tanggal berakhir yang tersimpan adalah review_date milik aktivitas atestasi. Anggap state yang tidak dikenal sebagai tidak berlaku.

Bagaimana atestasi ditampilkan dalam respons

Respons menampilkan sebagian atestasi dan menghilangkan yang lain, jadi attestation yang bernilai null tidak membuktikan bahwa tidak ada yang mengatestasi.

Setiap baris kecuali dua baris terakhir berlaku selama atestasi masih berlaku. Pada kontrol otomatis, atestasi tidak berlaku selama nilai yang dibaca pemeriksaan berbeda dari nilai saat atestasi tersebut disimpan. Setiap atestasi yang respons tampilkan pada kontrol otomatis adalah risiko diterima. Activity Feed juga mencatat atestasi dari jenis-jenis yang dihilangkan dari respons.

Menghitung hasil

Periksa empat hal saat Anda menghitung kontrol berdasarkan rating.

Siapa yang mengatestasi, dan komentar

attested_by hanya diisi untuk kunci yang memiliki read:compliance_user_data bersama read:compliance_org_data, atau yang memiliki read:org_audit. Kunci yang hanya memiliki read:compliance_user_data mendapat 403. user_id di attested_by sama dengan user_id milik actor pada aktivitas atestasi. attested_by hanya berisi ID pengguna: Daftar pengguna organisasi memberikan nama dan alamat email setiap anggota saat ini. Sebelum Anda menambahkan scope ini, lihat Siapa yang dapat melihat siapa yang melakukan atestasi.

Endpoint ini tidak mengembalikan komentar, bahkan ketika halaman Security posture menampilkannya: setiap comment bernilai null, dan comments_status bernilai not_enabled atau not_permitted. Jadi, not_enabled dan komentar yang bernilai null tidak berarti atestasi tersebut tidak memiliki komentar. comments_status menjelaskan cara membaca komentar yang bernilai null, dan skema mendefinisikan nilai berikut.

Nilai lain dapat ditambahkan; anggap nilai yang tidak dikenal sebagai unavailable.

Error

Error menggunakan body yang sama seperti bagian lain dari Compliance API; tabel ini mencantumkan error yang dikembalikan endpoint ini dengan caranya sendiri.

Penyebab 404:

• organization_id bukan UUID, tidak merujuk ke organisasi mana pun, atau merujuk ke organisasi yang telah dihapus.
• organization_id merujuk ke organisasi induk, organisasi di bawah induk lain, atau organisasi yang tidak dicakup oleh kunci organisasi tunggal.
• Organisasi tidak menggunakan Claude Enterprise, atau Security posture tidak tersedia untuknya, seperti pada organisasi Claude Console.
• Halaman Security posture telah dinonaktifkan untuk organisasi (lihat Ketersediaan Security posture).
• Security posture tersedia untuk organisasi, tetapi endpoint tidak melayaninya.
• Ketersediaan tidak dapat diperiksa; permintaan berikutnya dapat berhasil.

Setiap 404 memiliki body yang sama, begitu pula path yang tidak ada.

Kesegaran data dan efek samping

Endpoint ini mengevaluasi setiap kontrol saat Anda memanggilnya, dan evaluated_at adalah waktu tersebut.

• Perubahan dari beberapa menit terakhir mungkin belum terlihat.
• Hasil dapat berubah tanpa ada pengaturan yang berubah, misalnya ketika tanggal berakhir tiba atau Anthropic mengubah nilai yang direkomendasikan.
• Jika Anthropic mengubah kata-kata suatu nilai saat ini, risiko diterima pada nilai tersebut tidak berlaku.
• Panggilan tidak menyimpan hasil apa pun dan tidak membuat atestasi apa pun berhenti berlaku.
• Setiap permintaan yang lolos pemeriksaan kunci, scope, dan versi tanpa parameter kueri mencatat satu aktivitas compliance_api_accessed, baik berhasil maupun gagal; url-nya menyebutkan organisasi yang dibaca, dan organization_uuid bernilai null untuk kunci organisasi induk.