Obtenir l'accès à l'API Compliance

L'API Compliance 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 créent des clés d'accès Compliance dans claude.ai ; ces clés donnent accès à l'intégralité de l'API Compliance. 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.

Demander l'accès à l'API Compliance

Contactez votre représentant Anthropic pour demander l'accès. L'activation s'effectue au niveau de l'organisation parente et se propage à chaque organisation liée, qu'il s'agisse de claude.ai ou de Claude Console. Ce qui change après l'activation dépend du produit Claude utilisé par votre organisation.

Après l'activation : organisations claude.ai

Une fois qu'Anthropic a activé l'API Compliance pour votre organisation parente, le propriétaire principal peut créer des clés d'accès Compliance depuis la section Keys sur claude.ai > Organization settings > API.

Après l'activation : organisations Claude Console

Une fois qu'Anthropic a activé l'API Compliance pour votre organisation parente, les clés Admin API créées à partir de ce moment portent le « scope » (portée) read:compliance_activities. Les clés Admin API créées avant l'activation continuent de fonctionner avec l'Admin API, mais appeler le flux d'activité avec l'une d'elles renvoie 403 Forbidden ; créez une nouvelle clé Admin API pour obtenir cette portée.

Créer une clé d'accès Compliance

Créer une clé Admin API

Les clés Admin API portent la portée read:compliance_activities uniquement si l'API Compliance a été activée pour l'organisation avant la création de la clé ; voir Après l'activation : organisations Claude Console. Aucune autre portée de l'API Compliance 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, consultez 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 clé d'accès Compliance ; 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>]. Consultez Gérer les erreurs de l'API Compliance 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 clé d'accès Compliance 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 clés d'accès Compliance 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 clé d'accès Compliance est divulguée, supprimez-la immédiatement, auditez le flux d'activité pour les 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 ; consultez Comprendre l'objet Activity pour le schéma de l'acteur.

Étapes suivantes