Jetons ciblés et révocation

Gardez les données personnelles hors des jetons

Un exemple utilise des jetons opaques imprévisibles avec une portée et une expiration côté serveur. Exiger l'authentification du destinataire en plus du token pour limiter l'impact du vol.

token_hash

Une valeur de recherche pour les jetons correspondants. Gardez les jetons bruts hors des journaux et des écrans d’administration ordinaires.

audience

Le destinataire autorisé. Rejeter l'utilisation par un autre partenaire d'intégration.

scope / purpose

Données autorisées et finalité. Ne optez pas par défaut pour des autorisations larges.

resource_ref

Le relevé de commande ou de livraison. Empêcher l'utilisation pour un autre enregistrement.

expires_at / remaining_uses

Limite d’expiration et d’utilisation. Rejetez les jetons expirés et consommés côté serveur.

Usage unique et réponses perdues

L’identifiant référence une adresse. Le jeton ajoute des conditions liées à une commande, une application et des champs. Protégez les deux. Un jeton à usage unique est consommé après un accès réussi ; la répétition de la réponse n’est pas garantie. En cas de perte, vérifiez l’état avant de réémettre.

Expiration, révocation et modifications

Enregistrez une nouvelle adresse au lieu de modifier l’existante. Consultez le lien, transmettez sa Version comme expectedVersion, modifiez la commande puis émettez un jeton pour sa nouvelle version. Les jetons des anciennes versions sont bloqués. Émettre un autre jeton à version identique ne révoque pas les précédents. Vérifiez les autres commandes et la conservation avant suppression. Le texte déjà transmis ne peut être rappelé.

Transitions d'état

actif → consommé / expiré / révoqué. Ne réactivez jamais un état révoqué.

Mise en cache

Limitez le délai de révocation. Les opérations à haut risque doivent vérifier l’autorité de l’État.

Limites

La révocation ne peut pas récupérer les données personnelles déjà récupérées par un partenaire.

DATA / INTEGRATION EXAMPLE

Exemple de données et d'intégration

Ces échantillons expliquent la conception. Les noms et valeurs des champs sont donnés à titre indicatif et ne constituent pas une référence API exécutable.

{
  "operation": "Delivery token issuance example",
  "request": {
    "proxy_id": "nym_example_01",
    "resource_ref": "order_example_01",
    "audience": "carrier-a",
    "scope": [
      "shipping.address.read"
    ],
    "expires_in_seconds": 600,
    "max_uses": 1
  },
  "response": {
    "token": "tok_example_not_a_real_token",
    "expires_in_seconds": 600
  }
}

600 secondes et une utilisation sont des exemples. Un JWT signé à lui seul ne garantit pas une révocation anticipée ou une utilisation unique ; une gestion étatique supplémentaire est nécessaire.

Conceptions techniques associées

Intégration conçue pour vos workflows.

Cartographiez les données conservées, les partenaires et les actions requises pour identifier les moyens de réduire l’exposition.