Introduction

​

Authentification

​

Recommandé : jeton Bearer

Authorization: Bearer cbr_live_your_api_key_here

​

Alternative : en-tête X-Api-Key

X-Api-Key: cbr_live_your_api_key_here

​

Créer des clés d’API

1. Connectez-vous à votre instance CaseBender
2. Accédez à Compte → Clés d’API
3. Cliquez sur Créer une clé d’API
4. Configurez le nom, la description, le niveau (tier) et les portées (scopes) de la clé
5. Enregistrez la clé immédiatement : elle n’est affichée qu’une seule fois et ne peut pas être récupérée ultérieurement

cbr_live_a1b2c3d4e5f6g7h8i9j0...

​

Utiliser les clés d’API

​

Avec cURL

curl -X GET https://your-instance.casebender.com/api/v1/alerts \
  -H "Authorization: Bearer YOUR_API_KEY_HERE" \
  -H "Content-Type: application/json"

​

Avec Python (bibliothèque requests)

import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY_HERE",
    "Content-Type": "application/json"
}

response = requests.get(
    "https://your-instance.casebender.com/api/v1/alerts",
    headers=headers
)

​

Avec JavaScript/Node.js (fetch)

const response = await fetch(
  "https://your-instance.casebender.com/api/v1/alerts",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY_HERE",
      "Content-Type": "application/json",
    },
  }
);

​

Niveaux de clés d’API

​

Portées des clés d’API

• alerts:read - Lire les alertes
• alerts:write - Créer et mettre à jour les alertes
• cases:read - Lire les dossiers
• cases:write - Créer et mettre à jour les dossiers
• observables:read - Lire les observables
• observables:write - Créer et mettre à jour les observables
• users:read - Lire les informations des utilisateurs
• admin:* - Opérations administratives

​

Erreurs d’authentification courantes

• 401 Unauthorized :
  • En-tête Authorization manquant
  • Clé d’API invalide ou expirée
  • La clé d’API a été révoquée ou suspendue
• 403 Forbidden :
  • La clé d’API ne dispose pas de la portée requise pour l’opération
  • Restrictions d’accès TLP/PAP
• 429 Too Many Requests :
  • Limite de débit dépassée pour votre niveau

​

Bonnes pratiques de sécurité

• Ne partagez jamais votre clé d’API : traitez-la comme un mot de passe
• Faites tourner régulièrement les clés d’API : révoquez les anciennes clés et créez-en de nouvelles périodiquement
• Utilisez des clés différentes pour des applications différentes : cela vous permet de révoquer l’accès par application
• Définissez des dates d’expiration : configurez les clés d’API pour qu’elles expirent automatiquement lorsque c’est possible
• Utilisez les portées minimales requises : n’accordez que les autorisations dont votre application a besoin

​

Authentification héritée (obsolète)

# Obsolète : ne pas utiliser pour de nouvelles intégrations
curl -X GET https://your-instance.casebender.com/api/v1/alerts \
  -H "x-api-key: YOUR_ACCESS_KEY" \
  -H "x-api-secret: YOUR_SECRET_KEY"