Configurer la Compliance API

La Compliance API utilise deux types de clés, et celle que vous créez dépend du produit Claude utilisé par votre organisation. Les propriétaires principaux et les propriétaires d'organisation créent des Compliance Access Keys dans claude.ai ; ces clés donnent accès à l'intégralité de la Compliance API. La clé d'un propriétaire principal peut couvrir toutes les organisations rattachées à l'organisation parente ; la clé d'un propriétaire d'organisation couvre uniquement sa propre organisation. Les administrateurs d'organisation créent des clés Admin API dans Claude Console ; ces clés donnent accès uniquement au flux d'activité.



De quelle clé avez-vous besoin ?

Un locataire Claude Enterprise possède une organisation parente qui centralise l'identité, le SSO et le SCIM pour chaque organisation de charge de travail qui en dépend. Ces organisations de charge de travail sont les organisations liées de l'organisation parente.



Configurer la Compliance API

La configuration se fait en un seul flux : activez la Compliance API pour votre organisation, puis créez une Compliance Access Key dans claude.ai. Une organisation Claude Console crée plutôt une clé Admin API après l'activation ; les clés Admin API n'accèdent qu'au flux d'activité.



Créer une clé Admin API

Suivez les étapes décrites dans Créer une clé Admin API, puis définissez la clé comme variable d'environnement :

export ANTHROPIC_ADMIN_KEY=sk-ant-admin01-...

Ce nom de variable distinct évite que la clé Admin API n'écrase une Compliance Access Key si vous provisionnez les deux. Les exemples cURL de ce guide lisent la clé depuis $ANTHROPIC_COMPLIANCE_ACCESS_KEY ; substituez $ANTHROPIC_ADMIN_KEY lorsque vous appelez le flux d'activité avec une clé Admin API.

Les clés Admin API ne portent la portée read:compliance_activities que si la Compliance API était activée pour l'organisation au moment de la création de la clé ; voir Configurer la Compliance API. Aucune autre portée de la Compliance API ne peut leur être accordée, de sorte que les appels à tout point de terminaison autre que le flux d'activité renvoient 403 Forbidden.

Pour le rôle de cette même clé dans la gestion de votre organisation Claude Console, voir Admin API.



Vérifier les portées de votre clé

Pour inspecter les portées d'une clé que vous possédez déjà, utilisez l'un des indicateurs suivants.

• Préfixe de la clé. sk-ant-admin01- est une clé Admin API (porte uniquement read:compliance_activities, sous réserve du moment d'activation décrit dans la section précédente). sk-ant-api01- est une Compliance Access Key ; ses portées correspondent au sous-ensemble que vous avez sélectionné lors de la création.
• Interface des paramètres. Ouvrez la section Keys dans claude.ai > Organization settings > API, ou la section Admin keys dans Claude Console > Settings > Admin keys, et consultez la colonne Scopes pour la clé.
• Réponses d'erreur. Un appel qui dépasse les portées de la clé renvoie une erreur 403 avec un message au format Missing required scopes. Got: [<scopes the key carries>] Needed: [<scopes the endpoint requires>]. Voir Gérer les erreurs de la Compliance API pour le catalogue complet des erreurs.

{
  "error": {
    "type": "permission_error",
    "message": "Missing required scopes. Got: ['read:compliance_activities'] Needed: ['read:compliance_user_data']"
  }
}



Gérer et faire tourner les clés

Supprimez une Compliance Access Key depuis le même tableau Keys où vous l'avez créée : accédez à claude.ai > Organization settings > API. Supprimez une clé Admin API depuis Claude Console > Settings > Admin keys.

La suppression d'une clé prend effet à la requête suivante : il n'y a pas de période de grâce. Les Compliance Access Keys n'expirent pas d'elles-mêmes.

Pour faire tourner une clé sans interruption de service :

1. Créez une nouvelle clé avec les mêmes portées.
2. Mettez à jour votre intégration pour utiliser la nouvelle clé.
3. Vérifiez que l'intégration fonctionne avec la nouvelle clé.
4. Supprimez l'ancienne clé.

Les curseurs de pagination stockés avant une rotation restent valides : les curseurs sont liés à l'organisation, pas à la clé.

Si une Compliance Access Key est divulguée, supprimez-la immédiatement, auditez le flux d'activité à la recherche d'activités compliance_api_accessed effectuées par la clé compromise, et faites tourner tous les identifiants en aval auxquels la clé divulguée pouvait accéder. Passez activity_types[]=compliance_api_accessed pour délimiter la requête, puis, dans votre client, conservez les activités dont actor.type est api_actor et dont actor.api_key_id correspond à la clé compromise ; voir Comprendre l'objet Activity pour le schéma de l'acteur.



Étapes suivantes