Introduzione

​

Autenticazione

​

Consigliato: token Bearer

Authorization: Bearer cbr_live_your_api_key_here

​

Alternativa: intestazione X-Api-Key

X-Api-Key: cbr_live_your_api_key_here

​

Creare chiavi API

1. Accedi alla tua istanza di CaseBender
2. Vai su Account → Chiavi API
3. Fai clic su Crea chiave API
4. Configura nome, descrizione, livello (tier) e ambiti (scope) della chiave
5. Salva subito la chiave: viene mostrata una sola volta e non può essere recuperata in seguito

cbr_live_a1b2c3d4e5f6g7h8i9j0...

​

Usare le chiavi API

​

Con cURL

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

​

Con Python (libreria 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
)

​

Con 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",
    },
  }
);

​

Livelli delle chiavi API

​

Ambiti delle chiavi API

• alerts:read - Leggere gli avvisi
• alerts:write - Creare e aggiornare gli avvisi
• cases:read - Leggere i casi
• cases:write - Creare e aggiornare i casi
• observables:read - Leggere gli observable
• observables:write - Creare e aggiornare gli observable
• users:read - Leggere le informazioni degli utenti
• admin:* - Operazioni amministrative

​

Errori di autenticazione comuni

• 401 Unauthorized:
  • Intestazione Authorization mancante
  • Chiave API non valida o scaduta
  • La chiave API è stata revocata o sospesa
• 403 Forbidden:
  • La chiave API non dispone dell’ambito richiesto per l’operazione
  • Restrizioni di accesso TLP/PAP
• 429 Too Many Requests:
  • Limite di frequenza superato per il tuo livello

​

Buone pratiche di sicurezza

• Non condividere mai la tua chiave API: trattala come una password
• Ruota regolarmente le chiavi API: revoca le chiavi vecchie e creane di nuove periodicamente
• Usa chiavi diverse per applicazioni diverse: così puoi revocare l’accesso per singola applicazione
• Imposta date di scadenza: configura le chiavi API affinché scadano automaticamente quando possibile
• Usa gli ambiti minimi necessari: concedi solo i permessi di cui la tua applicazione ha bisogno

​

Autenticazione legacy (deprecata)

# Deprecato: non utilizzare per nuove integrazioni
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"