> ## 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.

# Politiques d'émission

> Définissez des politiques basées sur des règles qui contrôlent qui peut créer, vérifier et exporter des attestations dans votre locataire.

Les politiques d'émission vous permettent d'appliquer des exigences de conformité, de juridiction et de confiance pour la frappe, la vérification et les exportations de bundles de preuves. Lorsqu'une politique est active, chaque requête correspondante est évaluée par rapport à vos règles avant de procéder. Les requêtes qui ne correspondent pas sont refusées avec une raison claire.

## Quand utiliser les politiques

Utilisez les politiques d'émission lorsque vous avez besoin de :

* Restreindre la création aux émetteurs dans des juridictions spécifiques (par exemple, uniquement aux États-Unis ou aux États-Unis et à l'UE)
* Exiger un niveau de confiance minimum avant qu'un émetteur ne puisse créer des attestations
* Appliquer des règles différentes pour la création et la vérification
* Contrôler qui peut exporter des lots de preuves ou soumettre des demandes de portabilité des données
* Tester une politique avec des entrées d'échantillon avant de la déployer en production
* Auditer quelle politique était en vigueur lors de la création d'une attestation

Si vous ne créez aucune politique, toutes les demandes de frappe, de vérification et d'exportation sont autorisées par défaut.

## Comment fonctionnent les politiques

Chaque politique contient une ou plusieurs **règles**. Une règle a :

* **Conditions** — vérifications au niveau du champ évaluées par rapport au contexte de la requête (par exemple, `jurisdiction eq US`)
* **Effet** — `ALLOW` ou `DENY` si les conditions correspondent
* **Effet par défaut** — appliqué lorsqu'aucune règle ne correspond

Les règles sont évaluées dans l'ordre. La première règle correspondante détermine le résultat. Si aucune règle ne correspond, l'`default_effect` s'applique.

```json theme={null}
{
  "rules": [
    {
      "id": "us_only",
      "description": "US jurisdiction required",
      "conditions": [
        { "field": "jurisdiction", "op": "eq", "value": "US" }
      ],
      "effect": "ALLOW"
    }
  ],
  "default_effect": "DENY"
}
```

### Opérateurs de condition

| Opérateur | Description | Exemple |
| - | - | - |
| `eq` | Égal à | `{ "field": "jurisdiction", "op": "eq", "value": "US" }` |
| `neq` | Différent de | `{ "field": "trust_tier", "op": "neq", "value": "individual" }` |
| `in` | Correspond à n'importe quelle valeur d'une liste | `{ "field": "trust_tier", "op": "in", "value": ["verified_org", "enterprise"] }` |
| `nin` | Ne correspond à aucune valeur dans une liste | `{ "field": "jurisdiction", "op": "nin", "value": ["CN", "RU"] }` |
| `gt` | Supérieur à (numérique) | `{ "field": "key.age_days", "op": "gt", "value": 90 }` |
| `lt` | Inférieur à (numérique) | `{ "field": "key.age_days", "op": "lt", "value": 365 }` |
| `exists` | Le champ est présent | `{ "field": "jurisdiction", "op": "exists", "value": true }` |

Les conditions prennent en charge la notation par points pour les champs imbriqués (par exemple, `key.age_days`, `key.status`).

### Champs disponibles

Tout champ de l'entrée d'évaluation peut être référencé, y compris les champs imbriqués avec la notation par points. Les champs suivants sont disponibles par défaut :

| Champ | Description |
| - | - |
| `jurisdiction` | La juridiction enregistrée de l'émetteur (code pays ISO) |
| `trust_tier` | Le niveau de confiance de l'émetteur (`individual`, `verified_org`, `regulated_issuer`, `enterprise`) |
| `status` | Le statut actuel de l'émetteur (`ACTIVE`, `suspended`, `revoked`, `SUNSET`, `pending`) |
| `risk_rating` | L'évaluation des risques de l'émetteur (`low`, `medium`, `high`, `CRITICAL`) |
| `assurance_level` | Le niveau d'assurance de l'émetteur (`standard`, `high`, `regulated`) |
| `key.age_days` | Âge de la clé de signature en jours |
| `key.status` | Statut de la clé de signature (`ACTIVE`, `REVOKED`, `EXPIRED`) |
| `key.kid` | Identifiant de la clé de signature |

## Cycle de vie de la politique

Chaque politique a un statut qui contrôle si elle est appliquée :

| Statut | Comportement |
| - | - |
| `DRAFT` | Enregistré mais non appliqué — utilisez ceci pendant que vous itérez sur les règles |
| `ACTIVE` | Appliqué à chaque requête correspondante |
| `DISABLED` | Désactivé temporairement sans supprimer la politique |

Lorsque vous créez une politique, vous choisissez le statut initial. Seules les politiques `ACTIVE` sont évaluées au moment de la requête.

### Transitions de cycle de vie

Les politiques suivent généralement cette progression :

1. **Créer en tant que `DRAFT`** — écrire et affiner vos règles sans affecter le trafic en direct.
2. **Simuler** — tester la politique préliminaire avec des exemples d'entrées à l'aide du [simulateur de politique](#simulating-a-policy).
3. **Activer** — définissez le statut sur `ACTIVE` afin que la politique soit appliquée aux requêtes correspondantes.
4. **Désactiver** — définissez le statut sur `DISABLED` pour arrêter temporairement l'application sans perdre la définition de la politique.
5. **Supprimer** — supprimez entièrement la politique lorsqu'elle n'est plus nécessaire.

Vous pouvez passer de `DRAFT`, `ACTIVE` et `DISABLED` à tout moment en mettant à jour la politique. Chaque changement de statut incrémente la version de la politique, qui est enregistrée avec chaque décision d'évaluation pour l'auditabilité.

> [!NOTE]
>
> La transition d'une politique à `ACTIVE` prend effet immédiatement. Assurez-vous d'avoir testé les règles avec le simulateur avant de les activer.

## Catégories de politique

Les politiques sont limitées à une action spécifique :

| Catégorie | S'applique à |
| - | - |
| `MINT` | Demandes d'émission d'attestations |
| `VERIFY` | Requêtes de vérification |
| `BUNDLE_EXPORT` | Exportation de lots de preuves et demandes de portabilité des données |

Vous pouvez avoir plusieurs politiques actives. Chaque politique s'applique uniquement à sa catégorie.

### Politiques de contrôle des exportations

Les politiques `BUNDLE_EXPORT` contrôlent qui peut exporter des paquets de preuves et soumettre des demandes de portabilité des données. Utilisez-les pour restreindre les exportations par juridiction, niveau de confiance ou tout autre champ dans l'entrée d'évaluation.

```json theme={null}
{
  "rules": [
    {
      "id": "block_non_enterprise",
      "description": "Only enterprise-tier issuers can export bundles",
      "conditions": [
        { "field": "trust_tier", "op": "nin", "value": ["enterprise", "regulated_issuer"] }
      ],
      "effect": "DENY"
    },
    {
      "id": "allow_low_risk",
      "description": "Allow exports for low-risk issuers",
      "conditions": [
        { "field": "risk_rating", "op": "eq", "value": "low" }
      ],
      "effect": "ALLOW"
    }
  ],
  "default_effect": "DENY"
}
```

Pour créer cette politique via l'API, définissez `category` sur `BUNDLE_EXPORT` :

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/policies \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Enterprise Export Only",
    "category": "BUNDLE_EXPORT",
    "status": "ACTIVE",
    "description": "Restrict proof-bundle exports to enterprise issuers with low risk",
    "language": "json_rules",
    "rules": {
      "rules": [
        {
          "id": "block_non_enterprise",
          "description": "Only enterprise-tier issuers can export bundles",
          "conditions": [
            { "field": "trust_tier", "op": "nin", "value": ["enterprise", "regulated_issuer"] }
          ],
          "effect": "DENY"
        }
      ],
      "default_effect": "ALLOW"
    }
  }'
```

### Liaisons de politique

Les liaisons de politique connectent une politique à une cible spécifique afin que le moteur sache quand l'appliquer. Chaque liaison comprend :

| Champ | Type | Description |
| - | - | - |
| `policy_id` | chaîne | L'ID de la politique à lier |
| `target_type` | chaîne | `ISSUER`, `VERIFICATION_PROFILE`, ou `TENANT_DEFAULT` |
| `target_id` | chaîne | UUID de la cible. Omettre pour `TENANT_DEFAULT` afin d'appliquer la politique à toutes les entités. |
| `action` | chaîne | `MINT`, `VERIFY`, ou `BUNDLE_EXPORT` |
| `priority` | integer | Les liaisons de priorité plus élevée sont évaluées en premier |

Lorsque plusieurs liaisons correspondent à une requête, elles sont évaluées par ordre de priorité décroissant. Le premier résultat `DENY` arrête immédiatement l'évaluation.

#### Création d'une liaison via l'API

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/policies/bindings \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "policy_id": "pol_abc123",
    "target_type": "ISSUER",
    "target_id": "iss_def456",
    "action": "MINT",
    "priority": 100
  }'
```

Pour appliquer une politique comme valeur par défaut à l'échelle du locataire, définissez `target_type` sur `TENANT_DEFAULT` et omettez `target_id` :

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/policies/bindings \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "policy_id": "pol_abc123",
    "target_type": "TENANT_DEFAULT",
    "action": "MINT",
    "priority": 10
  }'
```

> [!TIP]
>
> Utilisez des valeurs de priorité plus élevées pour des liaisons plus spécifiques. Par exemple, attribuez la priorité `100` à une liaison au niveau de l'émetteur et `10` au paramètre par défaut du locataire afin que la politique spécifique à l'émetteur soit évaluée en premier.

## Création d'une politique

### Depuis la console

1. Allez dans **Politiques** dans la barre latérale de la console
2. Cliquez sur **Créer une politique**
3. Entrez un nom, sélectionnez une catégorie (`MINT`, `VERIFY`, ou `BUNDLE_EXPORT`), et choisissez un statut
4. Rédigez vos règles au format JSON ou utilisez un modèle
5. Cliquez sur **Déployer la politique** — si le statut est `ACTIVE`, elle prend effet immédiatement

### À partir d'un modèle

La console comprend quatre modèles prêts à l'emploi que vous pouvez ajouter en un clic :

| Modèle | Catégorie | Description |
| - | - | - |
| Autoriser la juridiction américaine | MINT | Autoriser uniquement la frappe par des émetteurs basés aux États-Unis |
| Organisation vérifiée uniquement | MINT | Exiger un niveau de confiance `verified_org` ou supérieur |
| Autoriser tout (Permissif) | MINT | Autoriser toutes les frappes — à utiliser avec prudence |
| Vérifier - US et UE uniquement | VÉRIFIER | N'accepter que les vérifications provenant des juridictions des États-Unis ou de l'UE |

Pour utiliser un modèle, ouvrez l'onglet **Modèles** sur la page des politiques et cliquez sur **Utiliser le modèle**. La politique est créée et activée immédiatement. Vous pouvez la modifier ensuite pour personnaliser les règles.

### Via l'API

Définissez `status` sur `DRAFT` si vous souhaitez enregistrer la politique sans l'appliquer pour le moment.

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/policies \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "US Issuers Only",
    "category": "MINT",
    "status": "ACTIVE",
    "description": "Restrict minting to US-based issuers",
    "language": "json_rules",
    "rules": {
      "rules": [
        {
          "id": "us_only",
          "description": "US jurisdiction required",
          "conditions": [
            { "field": "jurisdiction", "op": "eq", "value": "US" }
          ],
          "effect": "ALLOW"
        }
      ],
      "default_effect": "DENY"
    }
  }'
```

```json Response theme={null}
{
  "id": "pol_abc123",
  "name": "US Issuers Only",
  "category": "MINT",
  "status": "ACTIVE",
  "description": "Restrict minting to US-based issuers",
  "rules": { "..." },
  "version": 1,
  "created_at": "2026-03-31T10:00:00Z"
}
```

## Liste des politiques

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

Retourne un tableau de toutes les politiques pour le locataire actuel.

## Simulation d'une politique

Avant de vous fier à une politique en production, utilisez le simulateur pour tester comment elle évalue une entrée donnée. Dans la console, ouvrez l'onglet **Simulateur** sur la page des politiques, sélectionnez une politique et entrez une entrée de test.

Vous pouvez également appeler directement le point de terminaison d'évaluation :

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/policies/evaluate \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "action": "MINT",
    "target_type": "ISSUER",
    "input": {
      "jurisdiction": "US",
      "trust_tier": "ENTERPRISE"
    }
  }'
```

```json Response theme={null}
{
  "allowed": true,
  "matched_rules": ["us_only"],
  "reasons": [],
  "decision_id": "dec_7f3a1b"
}
```

La réponse comprend quatre champs :

| Champ | Type | Description |
| - | - | - |
| `allowed` | boolean | Indique si la requête a passé toutes les politiques actives |
| `matched_rules` | tableau de chaînes | ID des règles qui ont correspondu à l'entrée. Vide lorsqu'aucune règle n'a correspondu et que l'effet par défaut a été appliqué. |
| `reasons` | tableau de chaînes | Explication lisible par l'homme lorsqu'une requête est refusée. Toujours un tableau vide lorsque `allowed` est `true`. |
| `decision_id` | chaîne | Identifiant unique pour cette évaluation — utilisez-le pour rechercher l'enregistrement de décision complet dans le [journal d'audit](https://docs.truthlocks.com/fr/security/audit.md#policy-decision-audit-trail). |

> [!NOTE]
>
> Si vous vous appuyiez auparavant sur `evaluation_ms` dans la réponse d'évaluation pour la surveillance des performances, ce champ a été supprimé de la réponse de l'API. Il est toujours enregistré dans le [journal d'audit des décisions](#decision-audit-trail) — interrogez `resource_type=policy_decision` dans le [journal d'audit](https://docs.truthlocks.com/fr/security/audit.md#policy-decision-audit-trail) pour le récupérer.

Si aucune règle ne correspond, la réponse reflète le `default_effect` :

```json theme={null}
{
  "allowed": false,
  "matched_rules": [],
  "reasons": ["Default policy effect: DENY"],
  "decision_id": "dec_9c2d4e"
}
```

## Journal d'audit des décisions

Chaque évaluation de politique est enregistrée automatiquement. Chaque décision capture la version de la politique, les règles correspondantes et un hachage SHA-256 de l'entrée pour la preuve d'altération. Utilisez les enregistrements de décision pour retracer pourquoi une demande spécifique a été autorisée ou refusée.

La réponse d'évaluation inclut un `decision_id` que vous pouvez référencer dans les requêtes d'audit :

```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_..."
```

L'enregistrement d'audit comprend des champs qui ne font pas partie de la réponse de l'API d'évaluation, tels que `evaluation_ms` et `input_hash` :

| Champ de décision | Description |
| - | - |
| `decision_id` | Identifiant unique de cette évaluation |
| `policy_id` | La politique qui a été évaluée |
| `policy_version` | Version de la politique au moment de l'évaluation |
| `allowed` | Si la requête a été autorisée |
| `matched_rules` | ID de règles qui ont correspondu à l'entrée |
| `evaluation_ms` | Temps passé à évaluer, en millisecondes (piste d'audit uniquement) |
| `input_hash` | Hachage SHA-256 de l'entrée d'évaluation |

## Suppression d'une politique

Supprimez une politique de la console en cliquant sur l'icône de suppression sur la carte de la politique, ou via l'API :

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

> [!WARNING]
>
> La suppression d'une politique prend effet immédiatement. Toutes les demandes de frappe ou de vérification en attente qui étaient soumises à la politique ne seront plus évaluées par rapport à celle-ci.

## Exemple : politique multi-règles

Combinez plusieurs règles pour exprimer des exigences complexes. Les règles sont évaluées dans l'ordre — la première correspondance l'emporte.

```json theme={null}
{
  "rules": [
    {
      "id": "block_individual",
      "description": "Block individual-tier issuers",
      "conditions": [
        { "field": "trust_tier", "op": "eq", "value": "individual" }
      ],
      "effect": "DENY"
    },
    {
      "id": "allow_us_eu",
      "description": "Allow US or EU jurisdictions",
      "conditions": [
        { "field": "jurisdiction", "op": "in", "value": ["US", "EU"] }
      ],
      "effect": "ALLOW"
    }
  ],
  "default_effect": "DENY"
}
```

Cette politique refuse les émetteurs de niveau individuel quelle que soit la juridiction, autorise les émetteurs américains et européens à tout autre niveau de confiance, et refuse tous les autres.

## Lié

> [card] [SDK du moteur de politique](https://docs.truthlocks.com/policy.md)
>
> Évaluer les politiques par programme à l'aide du SDK pour une intégration personnalisée
> scénarios.

> [card] [Référence de l'API de politique](https://docs.truthlocks.com/api-reference/policies/create.md)
>
> Créer, lister, évaluer et supprimer des politiques via l'API REST.

> [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 pour la conformité
> rapports.

> [card] [Gouvernance](https://docs.truthlocks.com/api-reference/governance/list-requests.md)
>
> Utilisez des flux de travail de gouvernance pour l'approbation de l'émetteur et les changements de statut.


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