Aller au contenu

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.

User signs in to the app User signs in to the app

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.