Introducción

​

Autenticación

​

Recomendado: Token Bearer

Authorization: Bearer cbr_live_your_api_key_here

​

Alternativa: Encabezado X-Api-Key

X-Api-Key: cbr_live_your_api_key_here

​

Crear claves de API

1. Inicie sesión en su instancia de CaseBender
2. Vaya a Cuenta → Claves de API
3. Haga clic en Crear clave de API
4. Configure el nombre, la descripción, el nivel (tier) y los ámbitos (scopes) de la clave
5. Guarde la clave inmediatamente: se muestra solo una vez y no se puede recuperar después

cbr_live_a1b2c3d4e5f6g7h8i9j0...

​

Usar claves de 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 (biblioteca 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",
    },
  }
);

​

Niveles de claves de API

​

Ámbitos de claves de API

• alerts:read - Leer alertas
• alerts:write - Crear y actualizar alertas
• cases:read - Leer casos
• cases:write - Crear y actualizar casos
• observables:read - Leer observables
• observables:write - Crear y actualizar observables
• users:read - Leer información de usuarios
• admin:* - Operaciones administrativas

​

Errores de autenticación comunes

• 401 Unauthorized:
  • Falta el encabezado Authorization
  • Clave de API inválida o expirada
  • La clave de API ha sido revocada o suspendida
• 403 Forbidden:
  • La clave de API carece del ámbito requerido para la operación
  • Restricciones de acceso TLP/PAP
• 429 Too Many Requests:
  • Se superó el límite de tasa para su nivel

​

Buenas prácticas de seguridad

• Nunca comparta su clave de API: trátela como una contraseña
• Rote las claves de API con regularidad: revoque las claves antiguas y cree nuevas periódicamente
• Use claves diferentes para aplicaciones diferentes: esto le permite revocar el acceso por aplicación
• Establezca fechas de expiración: configure las claves de API para que expiren automáticamente cuando sea posible
• Use los ámbitos mínimos necesarios: otorgue solo los permisos que su aplicación necesita

​

Autenticación heredada (obsoleta)

# Obsoleto: no lo use para nuevas integraciones
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"