Appsà : attributions ∩ rôles
Une app qui connecte un utilisateur n’agit jamais avec tous les droits de cet utilisateur. Elle agit avec l’intersection de l’attribution et du rôle élu. Lisez cette page pour voir ce que chaque côté apporte.
Explication
Section intitulée « Explication »Une app est un document du doctype app.App. Son enregistrement porte une
attribution. L’attribution fixe le maximum de ce que l’app pourra jamais
faire, pour chaque utilisateur.
| Élément d’une entrée d’attribution | Contenu |
|---|---|
target |
un chemin de doctype concret, comme crm.Contact ; les cibles joker sont refusées |
action name |
read, write, delete, ou une action nomméeà ; write se décompose en create et update |
action required |
à true, un rôle qui n’a pas l’action ne peut pas utiliser l’app |
À la connexion, l’utilisateur élit un rôle sur l’écran de consentement. Cet écran s’affiche toujours, même si l’utilisateur s’est déj à connecté. Facet calcule ensuite le périmètre effectif. L’app ne peut tenter que ce qui se trouve dans les deux ensembles.
L’attribution plafonne même les utilisateurs puissants. Un rôle admin atteint tous les doctypes. Par l’app, ce même admin n’atteint que ce que l’attribution nomme. L’attribution est un plafondà ; elle n’élargit jamais un rôle.
Un changement d’attribution s’applique à l’appel suivant. Facet relit l’attribution à chaque requête, depuis le document d’app réel. Un changement s’applique donc à la requête suivante, sans nouveau token. Aucun token ne met l’attribution en cache.
Les périmètres de lignes se transmettent. Si le rôle élu limite les
lectures à $mine, l’app garde cette limite. L’attribution restreint les
doctypes et les actions qu’une requête peut tenter. Elle n’assouplit jamais un
filtre de lignes.
Apps backend. Une app backend n’a pas de connexion utilisateur. Elle détient une clé d’API (interface de programmation) et un compte de service avec un seul rôle épinglé. Sa portée est la même intersection : l’attribution et le rôle épinglé.
Une app ne peut pas élargir sa propre attribution. Le hook de mise à jour
sur app.App refuse un patch venant d’un appelant limité à l’app. Le patch ne
peut pas changer grants, le rôle de service ni le compte de service. Les
opérateurs gardent tous les droits d’édition.
Le compromis découle de la conception. La même app peut marcher pour un utilisateur et échouer pour un autre. L’attribution est statique, tandis que le rôle élu varie selon l’utilisateur. Quand l’app échoue, vérifiez les deux côtésà : l’attribution sur le document d’app, et les lignes de permission du rôle élu.
Voir aussi
Section intitulée « Voir aussi »- Apps — enregistrer une app, modifier son attribution, émettre et faire tourner les clés.
- Contextes d’authentification — comment le rôle élu et l’attribution accompagnent chaque requête.
- Rôles, niveaux et garde-fou d’autorité — le modèle de rôles d’où vient le rôle élu.
- Gouverner l’accès — modifier les rôles qu’une app peut élire.
- Internes sur GitHubà : app-system.md.