> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Journaux d'audit

> Suivez toutes les activités API, les événements de sécurité et l'audit de conformité.

Truthlocks maintient des journaux d'audit complets pour la surveillance de la sécurité, les rapports de conformité et le dépannage opérationnel.

## Ce qui est enregistré

Chaque opération API génère un événement d'audit. Cela inclut les opérations réussies, les tentatives échouées et les événements pertinents pour la sécurité.

> [card] Opérations API
>
> * Frappe d'attestation \* Révocation d'attestation \* Émetteur
>   création/modification \* Enregistrement de clé

> [card] Événements de sécurité
>
> * Échecs d'authentification \* Autorisation refusée \* Limite de débit dépassée \*
>   Activité suspecte

> [card] Actions de gouvernance
>
> * Approbation/rejet de l'émetteur \* Suspension de l'émetteur \* Attributions de rôles \* Clé API
>   gestion

> [card] Activité de l'utilisateur
>
> * Connexion/déconnexion utilisateur \* Changements de mot de passe \* Invitations d'utilisateurs \* Changements de rôle

## Structure de l'événement d'audit

Chaque événement d'audit contient un contexte détaillé sur ce qui s'est passé, qui l'a fait et quand :

```json theme={null}
{
  "id": "evt_abc123",
  "timestamp": "2026-01-13T12:34:56.789Z",
  "tenant_id": "tenant-uuid",
  "actor_type": "USER",
  "actor_id": "user-uuid",
  "action": "attestation.mint",
  "resource_type": "attestation",
  "resource_id": "attestation-uuid",
  "service": "trust-registry",
  "outcome": "SUCCESS",
  "metadata": {
    "issuer_id": "issuer-uuid",
    "subject": "user:12345",
    "claim": "email_verified"
  },
  "integrity_hash": "sha256:abc123..."
}
```

| Champ | Type | Description |
| - | - | - |
| `actor_type` | string | Qui a effectué l'action : `USER`, `API_KEY`, ou `SERVICE` |
| `actor_id` | string | UUID de l'utilisateur, de la clé API ou du service qui a déclenché l'événement |
| `action` | string | L'opération effectuée (par exemple, `attestation.mint`) |
| `resource_type` | string | Type de ressource affectée (par exemple, `attestation`, `issuer`, `user`) |
| `resource_id` | string | UUID de la ressource affectée |
| `service` | string | Le service backend qui a traité la requête (par exemple, `trust-registry`, `audit-service`) |
| `outcome` | string | `SUCCESS` ou `FAILURE` |
| `metadata` | objet | Contexte spécifique à l'action tel que l'ID de l'émetteur, le type de réclamation ou les détails de l'erreur |
| `integrity_hash` | chaîne | Hachage SHA-256 pour la vérification de l'intégrité |

## Interrogation des journaux d'audit

### Requête de base

```bash theme={null}
curl -X GET "https://api.truthlocks.com/v1/audit/events?limit=100" \
  -H "X-API-Key: tl_live_your_api_key"
```

### Requête filtrée

```bash theme={null}
curl -X GET "https://api.truthlocks.com/v1/audit/events" \
  -H "X-API-Key: tl_live_your_api_key" \
  -G \
  --data-urlencode "action=attestation.mint" \
  --data-urlencode "actor_id=user-uuid" \
  --data-urlencode "from=2026-01-01T00:00:00Z" \
  --data-urlencode "to=2026-01-31T23:59:59Z" \
  --data-urlencode "limit=50"
```

### Paramètres de filtre

| Paramètre | Type | Description |
| - | - | - |
| `action` | string | Filtrer par type d'action (par exemple, `attestation.mint`) |
| `actor_id` | string | Filtrer par utilisateur ou ID de clé API |
| `resource_type` | string | Filtrer par ressource (attestation, émetteur, utilisateur) |
| `from` | datetime | Événements après cette heure (ISO 8601) |
| `to` | datetime | Événements avant cette heure (ISO 8601) |
| `limit` | entier | Nombre maximal d'événements à retourner (par défaut 50, max 1000) |
| `cursor` | string | Curseur de pagination pour la page suivante |

## Journal d'audit des décisions de politique

Chaque évaluation de [politique d'émission](https://docs.truthlocks.com/fr/guides/issuance-policies.md) est automatiquement enregistrée comme un événement d'audit. Chaque enregistrement capture le `decision_id`, la version de la politique, les règles correspondantes, l'heure d'évaluation et un hachage SHA-256 de l'entrée pour la preuve d'altération. Interrogez les décisions de politique en filtrant sur `resource_type=policy_decision`:

```bash theme={null}
curl "https://api.truthlocks.com/v1/audit/events?resource_type=policy_decision&resource_id=dec_7f3a1b" \
  -H "X-API-Key: tl_live_..."
```

Voir [journal d'audit des décisions](https://docs.truthlocks.com/fr/guides/issuance-policies.md#decision-audit-trail) pour la liste complète des champs enregistrés.

## Cas d'utilisation courants

### Enquête de sécurité

Trouver toutes les tentatives d'authentification échouées pour un acteur spécifique :

```http theme={null}
GET /v1/audit/events
  ?action=auth.failure
  &actor_id=user-uuid
  &from=2026-01-12T00:00:00Z
```

### Rapport de conformité

Exporter toutes les opérations d'attestation pour une période donnée :

```http theme={null}
GET /v1/audit/events
  ?resource_type=attestation
  &from=2026-01-01T00:00:00Z
  &to=2026-01-31T23:59:59Z
  &limit=1000
```

### Examen de l'activité de l'utilisateur

Voir tout ce qu'un utilisateur spécifique a fait :

```http theme={null}
GET /v1/audit/events
  ?actor_id=employee-uuid
  &limit=100
```

## Rétention des journaux

| Niveau | Rétention par défaut | Format d'exportation |
| - | - | - |
| Gratuit | 7 jours | JSON uniquement |
| Starter | 30 jours | JSON, CSV |
| Professionnel | 90 jours | JSON, CSV, intégration SIEM |
| Entreprise | 1 an (personnalisable) | Tous les formats + streaming en temps réel |

> [!NOTE]
>
> Pour les exigences de conformité dépassant celles de votre niveau
> période de rétention, configurez l'intégration SIEM pour diffuser les journaux vers votre propre
> infrastructure.

### Politiques de rétention personnalisées

Vous pouvez configurer la durée de conservation des journaux d'audit et si les journaux expirés sont archivés ou supprimés définitivement. Définissez des politiques de conservation globalement ou par environnement.

| Champ | Type | Description |
| :- | :- | :- |
| `retention_days` | integer | Jours de conservation des journaux d'audit (30–3 650) |
| `hard_delete` | boolean | Si `true`, supprime définitivement les journaux expirés. Si `false`, archivez-les. |
| `export_allowed` | boolean | Indique si les exportations d'audit sont autorisées pour cette portée |
| `environment_id` | chaîne | Facultatif. Appliquer cette politique à un environnement spécifique uniquement. |

La politique par défaut conserve les journaux pendant 365 jours, archive (suppression logique) les journaux expirés et autorise les exportations.

**Obtenez votre politique de rétention actuelle :**

```bash theme={null}
curl https://api.truthlocks.com/v1/audit/retention \
  -H "X-API-Key: tl_live_..."
```

```json theme={null}
{
  "retention_days": 365,
  "hard_delete": false,
  "export_allowed": true,
  "environment_id": null
}
```

**Mettre à jour la politique de rétention :**

```bash theme={null}
curl -X PUT https://api.truthlocks.com/v1/audit/retention \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "retention_days": 730,
    "hard_delete": false,
    "export_allowed": true
  }'
```

Lorsqu'une politique spécifique à l'environnement existe, elle prévaut sur la politique globale. Si aucune politique spécifique à l'environnement n'est définie, la politique globale s'applique.

> [!WARNING]
>
> Changer `hard_delete` en `true` supprime définitivement les journaux une fois qu'ils dépassent la fenêtre de rétention. Cette action est irréversible. Assurez-vous d'avoir exporté tous les journaux dont vous avez besoin avant d'activer la suppression définitive.

La mise à jour des paramètres de rétention nécessite la permission `tenant.audit.retention.manage`. La consultation des paramètres nécessite `tenant.audit.retention.read`.

## Intégration SIEM

Les clients d'entreprise peuvent diffuser les journaux d'audit en temps réel vers des systèmes externes d'information et de gestion des événements de sécurité (SIEM).

### Fournisseurs pris en charge

| Fournisseur | Transport | Format |
| :- | :- | :- |
| **Splunk** | HTTP Event Collector (HEC) | JSON |
| **Datadog** | API de gestion des logs | JSON |
| **AWS CloudWatch** | Abonnement aux journaux | JSON |
| **Elastic/ELK** | Ingestion Elasticsearch | JSON |
| **Webhook personnalisé** | HTTP POST | JSON |

Configurez une destination de streaming depuis **Paramètres > Audit > SIEM** dans la console, ou gérez les destinations par programmation via l'[API de configuration SIEM](https://docs.truthlocks.com/fr/api-reference/audit/siem/create.md). Pour des instructions de configuration détaillées par fournisseur, consultez le [guide d'intégration SIEM](https://docs.truthlocks.com/fr/guides/siem-integration.md).

### Créer une destination SIEM

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/audit/siem \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "splunk",
    "endpoint": "https://hec.splunk.example.com:8088/services/collector",
    "token": "your-hec-token",
    "enabled": true
  }'
```

```json theme={null}
{
  "id": "siem_abc123",
  "provider": "splunk",
  "endpoint": "https://hec.splunk.example.com:8088/services/collector",
  "enabled": true,
  "created_at": "2026-06-30T12:00:00Z",
  "status": "active"
}
```

Remplacez `provider` par l'un des éléments suivants : `splunk`, `datadog`, `cloudwatch`, `elastic`, ou `webhook`. Chaque fournisseur nécessite une `endpoint` de destination et un identifiant d'authentification (`token` pour Splunk, Datadog et Elastic ; `access_key_id` et `secret_access_key` pour CloudWatch ; `secret` pour les webhooks personnalisés).

### Lister les destinations SIEM

Récupère toutes les destinations de streaming configurées pour votre locataire.

```bash theme={null}
curl https://api.truthlocks.com/v1/audit/siem \
  -H "X-API-Key: tl_live_..."
```

### Mettre à jour une destination SIEM

Modifier le point de terminaison, les identifiants ou l'état activé d'une destination existante.

```bash theme={null}
curl -X PUT https://api.truthlocks.com/v1/audit/siem/siem_abc123 \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "https://hec-new.splunk.example.com:8088/services/collector",
    "token": "your-new-hec-token",
    "enabled": true
  }'
```

### Supprimer une destination SIEM

Supprimer une destination de streaming. Les événements en cours sont vidés avant la suppression de la destination.

```bash theme={null}
curl -X DELETE https://api.truthlocks.com/v1/audit/siem/siem_abc123 \
  -H "X-API-Key: tl_live_..."
```

### Livraison et mise en mémoire tampon

Une fois activé, chaque événement d'audit est diffusé en temps réel vers votre destination, parallèlement au journal standard de la plateforme. Si la destination est inaccessible, les événements sont mis en mémoire tampon et réessayés avec un délai d'attente exponentiel pendant 24 heures maximum. Vous pouvez surveiller l'état de la livraison dans le champ `status` renvoyé par le point de terminaison de liste — les valeurs possibles sont `active`, `degraded` (nouvelle tentative) et `failed`.

> [!WARNING]
>
> **Fonctionnalité Entreprise :** Le streaming de logs en temps réel nécessite le niveau Entreprise.
> Contactez le service commercial pour obtenir de l'aide à l'installation.

## Prochaines étapes

> [card] [Intégration SIEM](https://docs.truthlocks.com/guides/siem-integration.md)
>
> Diffusez les événements d'audit vers Splunk, Datadog, CloudWatch, Elastic ou un webhook personnalisé.

> [card] [Exportations de conformité](https://docs.truthlocks.com/guides/compliance-exports.md)
>
> Exporter les données d'audit aux formats SOC 2, GDPR et HIPAA.

> [card] [Renforcement contre les abus](https://docs.truthlocks.com/security/abuse-hardening.md)
>
> Détecter et prévenir les abus à l'aide des données d'audit.

> [card] [Limites de débit](https://docs.truthlocks.com/ops/limits.md)
>
> Comprendre le comportement de limitation de débit dans les journaux d'audit.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.