Identité et intégration
UUID des dossiers : conserver l’identité sans en faire un droit d’accès
Un identifiant UUID peut servir à retrouver un objet entre plusieurs systèmes. Sa forme ne précise pas si l’objet est une commande, une tentative ou un événement, et sa connaissance ne doit pas suffire pour ouvrir un dossier. Définissez son rôle avant de l’utiliser dans le support.
Ce que documentent les sources
RFC 9562 décrit plusieurs versions d’UUID et indique de ne pas les utiliser comme capacités de sécurité dont la seule possession accorde un accès.
IETF : RFC 9562, UUID — consulté le . Format et génération d’identifiants ; ne garantit ni unicité parfaite de votre implémentation, ni résultat métier, ni autorisation d’accès.
Nommer l’objet et la responsabilité d’identité
Pour chaque UUID, conservez type d’objet, producteur et relation avec les références métier. Une tentative peut recevoir un nouvel identifiant sans constituer une nouvelle réservation. Demandez à quelle étape l’identité est créée et quels consommateurs la conservent. Le support doit retrouver l’objet sans comparer seulement des chaînes de même forme issues de plusieurs périmètres.
Préserver les représentations dans les échanges
Faites préciser format de stockage, lecture et comparaison dans les outils utilisés. Préparez des références fictives pour vérifier import, export et recherche, avec valeurs absentes ou mal formées. Une conversion ou une troncature peut rendre le rapprochement impossible. Les règles de génération et de gestion d’un doublon doivent être documentées par l’équipe technique selon la version retenue, sans déduire un ordre métier de la forme de l’identifiant.
Séparer référence de dossier et autorisation
Un lien contenant un UUID doit encore être soumis aux contrôles d’accès appropriés. La recette examine qui peut lire l’objet et comment le support partage une référence autorisée. Pendant une migration, conservez les correspondances nécessaires aux dossiers ouverts et les limites de conservation. Une identité reconnue ne doit pas devenir une confirmation du produit, du paiement ou de l’état final.
Deux situations à rapprocher
Deux tentatives deviennent deux réservations supposées
Scénario fictif : un logiciel reçoit deux UUID de tentative et les compte comme deux ventes. Rapprochez type d’objet et référence métier avant toute conclusion.
Une référence est tronquée dans l’export
Scénario fictif : une colonne conserve seulement une partie de l’UUID. Faites rejouer le trajet import-export et retrouver la valeur complète dans le circuit autorisé.
Conserver la décision et sa prochaine suite
| Point | Preuve à retrouver | Contrôle proposé |
|---|---|---|
| Objet | Commande, tentative ou événement | Nommer le rôle de l’identité. |
| Producteur | Système et étape de création | Rapprocher le périmètre. |
| Version | Convention UUID retenue | Faire documenter la génération. |
| Échange | Stockage et représentation | Préserver la valeur complète. |
| Lien | Références métier associées | Éviter une conclusion fondée sur la forme. |
| Doublon | Décision technique et métier | Examiner l’objet déjà retrouvé. |
| Accès | Droits du lecteur | Ne pas faire de l’UUID une permission. |
| Migration | Correspondances et dossiers ouverts | Conserver la reprise utile. |
Le registre doit expliquer l’objet identifié, sa correspondance et les contrôles d’accès nécessaires à sa lecture. Les états du dossier viennent de leurs preuves propres. La convention UUID est documentée sans promesse d’unicité ou de confidentialité absolue.
Erreurs à éviter
- Compter les tentatives comme des commandes.
- Tronquer une identité pour la rendre plus lisible.
- Accorder l’accès à la seule possession de l’UUID.
La fiche de contrôle permet de suivre les points à confirmer. Le registre associé conserve le périmètre, les preuves et la décision ; ses champs peuvent être remplis dans l’atelier avec des données fictives ou anonymisées.
Nommer les points du dossier
- Rôle d’un UUID de dossier : Type d’objet et responsabilité associés à un identifiant UUID.
- Représentation UUID d’échange : Forme complète utilisée pour conserver et comparer la référence.
- Correspondance UUID et métier : Lien retrouvé entre identité technique et référence de dossier.
- Séparation d’identité et permission : Distinction entre référence d’un objet et droit de le consulter.
Sources et périmètre des faits documentés
La date de consultation figure avec chaque référence. Les méthodes d’essai et recommandations de ce guide sont éditoriales ; les conditions d’accès et d’usage se vérifient dans la documentation actuelle.
- IETF : RFC 9562, UUID — Format et génération d’identifiants ; ne garantit ni unicité parfaite de votre implémentation, ni résultat métier, ni autorisation d’accès. (consultée le )
Questions fréquentes
Questions utiles avant de décider
La forme UUID indique-t-elle le type métier ?
Le contrat doit préciser l’objet et son producteur.
Un UUID est-il un secret d’accès ?
La référence ne remplace pas les contrôles d’autorisation ; la RFC met en garde contre cet usage.
Que préserver lors d’une migration ?
Les identités complètes et les correspondances nécessaires aux dossiers ouverts.