Passer au contenu principal
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.

Opérateurs de condition

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 :

Cycle de vie de la politique

Chaque politique a un statut qui contrôle si elle est appliquée : 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.
  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é.
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 : 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.
Pour créer cette politique via l’API, définissez category sur BUNDLE_EXPORT :

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 : 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

Pour appliquer une politique comme valeur par défaut à l’échelle du locataire, définissez target_type sur TENANT_DEFAULT et omettez target_id :
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 : 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.
Response

Liste des politiques

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 :
Response
La réponse comprend quatre champs :
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 — interrogez resource_type=policy_decision dans le journal d’audit pour le récupérer.
Si aucune règle ne correspond, la réponse reflète le default_effect :

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 :
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 :

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 :
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.
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é

SDK du moteur de politique

Évaluer les politiques par programme à l’aide du SDK pour une intégration personnalisée scénarios.

Référence de l'API de politique

Créer, lister, évaluer et supprimer des politiques via l’API REST.

Exportations de conformité

Exporter les données d’audit aux formats SOC 2, GDPR et HIPAA pour la conformité rapports.

Gouvernance

Utilisez des flux de travail de gouvernance pour l’approbation de l’émetteur et les changements de statut.