Aller au contenu

Visibilité des champs par étiquettes

Un champ peut porter une ou plusieurs étiquettes de sensibilité. Un rôle déclare quelles étiquettes il peut voir dans sa liste visible_tags. Facet cache tout autre champ en lecture, refuse d’écrire dans les champs cachés, et retire leurs valeurs du journal d’audit. La règle refuse par défautà : une étiquette qu’aucun rôle n’accorde cache le champ à tout le monde.

  • Un champ porte des données que seuls certains rôles peuvent voir, par exemple un salaire.
  • Vous voulez une règle de visibilité unique que chaque surface applique pareil.
  • Vous avez besoin du même masquage dans le journal d’audit, pas seulement dans les lectures en direct.
# définition hr.Employee
fields:
name:
type: string
salary:
type: money
currency: EUR
tags: ["salary"]

Un champ sans tags porte l’étiquette default.

{
"name": "hr_partner",
"visible_tags": ["default", "salary"]
}

Un rôle qui ne doit pas voir le champ garde les visible_tags par défaut de ["default"].

Appelant Lit name Lit salary
hr_partner (["default", "salary"]) oui oui, avec sa valeur
team_lead (["default"]) oui le champ est absent de la réponse

Un champ est visible quand chacune de ses étiquettes se trouve dans les visible_tags du rôle. La liste joker ["*"] voit chaque champ. Tout le reste refuse par défaut.

Facet omet les champs invisibles à chaque niveau d’imbrication : propriétés d’objet, éléments de tableau, et valeurs de dictionnaire. Un parent invisible cache tout son sous-arbre. Les clés de contenu que la définition ne connaît pas sont omises aussi, pour chaque principal réel.

  • Une écriture dans un champ invisible est refusée avec 403. L’erreur nomme le chemin de contenu. Un null explicite compte comme une écriture.
  • Le garde-fou tourne sur le corps brut soumis, avant la validation de format. Un appelant qui ne peut pas voir un champ n’apprend jamais son contrat de type par un 422.
  • Un garde-fou de transition compare l’état avant et après l’écriture. Il ramène les membres dans les valeurs d’objet, les clés de dictionnaire, et les marqueurs secrets au champ qui les possède. Un changement qui atterrit dans un champ invisible est refusé.
  • Le travail de cycle de vie, lui, remplit toujours les champs invisiblesà : défauts, champs calculés, hooks.

Le journal des mutations stocke les valeurs réelles. Facet retire les valeurs invisibles par principal appelant quand il lit le journal. La réponse liste les chemins de contenu retirés dans un bloc de métadonnées redacted. Chaque entrée est un tableau de segments de chemin — la même forme que les chemins de diff.

Forme de la ligne Ce que voit l’appelant
Ligne de contenu complète (create, instantané, tombstone de suppression) valeurs invisibles retirées à chaque niveauà ; un parent visible garde sa partie visible
Diff de mise à jour une entrée set sur un chemin invisible garde son chemin mais perd sa valeur
Définition manquante toutes les valeurs retirées — le refus par défaut

Aucun marqueur n’entre dans le contenu stocké. La liste redacted est la seule trace du retrait.

Les étiquettes cachent un champ par rôle. Deux genres de champs se cachent à

tout le mondeà :

  • Un champ secret ne stocke jamais sa valeur dans un document ni dans le journal.
  • Un champ write_only accepte une entrée et ne revient jamais dans les lectures.

Voir Champs secrets et en écriture seule.

Un enregistrement employé porte name et le champ salary étiqueté de l’étape 1.

  1. hr_partner lit l’employé. La réponse porte name et salary avec sa valeur.
  2. team_lead lit le même employé. La réponse ne porte que name. Il n’y a pas de clé salary, pas un null.
  3. team_lead envoie un patch qui met salary à null. Facet répond 403 et nomme le chemin : un null explicite est une écriture.
  4. team_lead ouvre l’historique de l’employé. Les lignes du salaire s’affichent sans valeurs, et le bloc redacted nomme les chemins. hr_partner lit le même historique et voit les valeurs.

Vérifiez les tags du champ et les visible_tags du rôle. Une étiquette que le rôle ne liste pas cache le champ.

Une écriture répond 403 pour un champ que vous ne vouliez pas toucher

Section intitulée « Une écriture répond 403 pour un champ que vous ne vouliez pas toucher »

Un null explicite dans le corps compte comme une écriture. Omettez la clé à la place.

Une ligne d’historique n’affiche pas de valeur

Section intitulée « Une ligne d’historique n’affiche pas de valeur »

Du caviardage pour votre rôle. Un rôle avec l’étiquette lit la valeur dans la même ligne.

Le travail de cycle de vie est de confiance. Seules les écritures de l’appelant et les transitions pilotées par l’appelant sont gardées.