Filtrer et exporter les logs d'audit par acteur, action et période

Le journal d'audit de Coffrify enregistre chaque événement significatif au sein de votre workspace : appels API, mutations de ressources, connexions, changements de permissions, etc. Deux endpoints permettent d'en exploiter la valeur : GET /v1/audit pour interroger et filtrer en temps réel, et POST /v1/audit/export pour générer un export de conformité complet (CSV ou JSON) stocké sur Scaleway avec un lien de téléchargement valable 24 heures. La rétention des entrées dépend du plan : Free 30 jours, Pro 1 an, Ultra/Entreprise 7 ans.

Authentification

Les deux endpoints requièrent une clé API valide transmise dans l'en-tête Authorization: Bearer <clé>. Les formats acceptés sont cof_live_… (production), cof_test_… (test) et cof_sandbox_… (sandbox). Le scope requis diffère selon l'endpoint : GET /v1/audit exige le scope audit:read, tandis que POST /v1/audit/export exige le scope audit:export. Ces scopes sont cumulatifs : une clé possédant audit:export n'obtient pas automatiquement audit:read.

Paramètres de requête, GET /v1/audit

La lecture du journal accepte plusieurs filtres (action, acteur, type de ressource, plage de dates) et la pagination par curseur. Le tableau ci-dessous les détaille.

Corps de la requête, POST /v1/audit/export

L'export déclare le format (CSV ou JSON) et la plage de dates à extraire. Le tableau ci-dessous liste les champs acceptés.

Les exemples ci-dessous filtrent le journal, puis lancent un export. Choisissez votre langage.

# Lister les logs d'audit avec filtres
curl -G https://api.coffrify.com/v1/audit \
  -H "Authorization: Bearer cof_live_xxxxxxxxxxxxxxxxxxxx" \
  --data-urlencode "action=api.post.transfers" \
  --data-urlencode "since=2026-05-01T00:00:00Z" \
  --data-urlencode "until=2026-05-31T23:59:59Z" \
  --data-urlencode "limit=50"
 
# Declencher un export CSV
curl -X POST https://api.coffrify.com/v1/audit/export \
  -H "Authorization: Bearer cof_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"format":"csv","since":"2026-05-01T00:00:00Z","until":"2026-05-31T23:59:59Z"}'

Réponse, GET /v1/audit

La réponse liste les entrées (data) et fournit un next_cursor pour la page suivante. Chaque entrée trace l'acteur, l'action et la ressource concernée.

{
  "object": "list",
  "data": [
    {
      "id": "aud_01HZ9XQAB3D2M7PFKTVN8CWRES",
      "created_at": "2026-05-28T14:23:11.452Z",
      "action": "api.post.transfers",
      "actor_id": "usr_01HZ3KQAB3D2M7PFKTVN8CWRES",
      "actor_type": "api_key",
      "actor_label": "req_01HZ9XQAB3D2M7PF",
      "resource_type": "transfer",
      "resource_id": "trf_01HZ9XQAB3D2M7PFKTVN8CWR42",
      "ip_address": "82.64.12.55",
      "country_code": "FR",
      "status": "success",
      "http_method": "POST",
      "route": "/api/v1/transfers",
      "http_status": 201,
      "latency_ms": 143,
      "metadata": {}
    }
  ],
  "next_cursor": "MjAyNi0wNS0yOFQxNDoyMzoxMS40NTJafGF1ZF8wMUhaOVhRQUIzRDJNN1BGS1RWTjhDV1JFUw",
  "has_more": true,
  "limit": 100,
  "note": "Audit retention follows the workspace plan: Free 30 days, Pro 1 year, Ultra/Entreprise 7 years."
}

Réponse, POST /v1/audit/export

L'export renvoie une URL de téléchargement temporaire, le format et le nombre de lignes (row_count). Récupérez le fichier rapidement : l'URL expire.

{
  "object": "audit_export",
  "format": "csv",
  "row_count": 12847,
  "filename": "coffrify-audit-ws_01HZ3KQAB3-2026-05-31.csv",
  "download_url": "https://coffrify-transfer.s3.fr-par.scw.cloud/_exports/ws_01HZ3KQAB3/audit/1748700191000-coffrify-audit-ws_01HZ3KQAB3-2026-05-31.csv?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=...&X-Amz-Expires=86400&X-Amz-Signature=...",
  "expires_at": "2026-06-01T10:23:11.000Z",
  "range": {
    "since": "2026-05-01T00:00:00Z",
    "until": "2026-05-31T23:59:59Z"
  },
  "note": "Le fichier est conservé 24 h puis automatiquement purgé. Téléchargez-le rapidement."
}

Erreurs

Les erreurs portent sur une plage de dates invalide, un trop grand volume ou un scope manquant. Le tableau ci-dessous indique la résolution.

Voir aussi

• Référence GET /v1/audit
• Référence POST /v1/audit/export
• Comprendre la pagination par curseur
• Gérer les rate limits et les retries
• Scopes et permissions des clés API
• Recevoir des événements par Webhook