Aller au contenu

La portée des apps (attributions)

Une app externe obtient l’accès par un document d’enregistrement. Une attribution sur ce document borne ce que l’app peut tenter du tout. Le rôle avec lequel elle se connecte — élu sur l’écran de consentement, ou épinglé pour une app backend — borne ce qu’elle peut voir et changer. Les deux bornes s’appliquent ensemble à chaque requête.

  • Vous enregistrez une app et devez garder sa portée étroite.
  • Une app a besoin de plus ou moins d’accès qu’elle n’en a.
  • Vous devez couper une app rapidement.
  • Le droit. Il vous faut le droit update sur les documents app.App. Les rôles admin et editor créés par l’initialisation le portent.
  • Le modèle. Lisez Apps, attributions et rôles pour le modèle derrière cette page.

Ouvrez Configurer → Applications et lancez l’assistant. Choisissez un préréglageà : une app web que vous hébergez se connecte par le navigateurà ; une app backend se connecte avec une clé d’API. L’étape de configuration recueille le nom, les origines de connexion, et les adresses de retour.

L’étape Autorisations — ou l’onglet « Octrois » d’une app existante — liste chaque doctype par domaine. Donnez un niveau d’accès par doctypeà :

Niveau Actions accordées
Aucun aucune entrée
Lecture read
Écriture read + write — write couvre create et update
Complet read + write + delete

Les actions nommées que le doctype déclare apparaissent comme interrupteurs supplémentaires dès que le niveau dépasse Aucun. Un doctype enfant hérite du niveau de son parent dans l’éditeurà ; l’enregistrement écrit une entrée explicite pour lui.

Une app backend agit par une identité machine. Choisissez son unique rôle à

l’étape Autorisations. L’éditeur avertit quand le rôle manque d’une action d’attribution requise, par exemple missing: update on fin.Invoice. L’avertissement ne bloque pas l’enregistrementà ; la vraie vérification tourne à chaque requête. Le rôle doit lister api dans ses canaux de connectivité, sinon l’émission de clé refuse.

Publier met le statut de l’app à active. Une app web reçoit son client id et se connecte par l’écran de consentement. Une app backend émet une clé d’APIà; la clé brute s’affiche une fois.

Modifiez les attributions dans l’onglet « Octrois », ou passez l’app à

désactivée. Facet relit le document de l’app à chaque requête, si bien qu’un changement s’applique à la requête suivante. Rien n’a besoin d’être réémis.

L’attribution est le plafondà : elle nomme les chemins de doctypes et les actions que l’app peut tenter. Le rôle décide de ce qui existe à accorderà : Facet ne garde que les actions que le rôle donne aussi. Les périmètres de lignes du rôle s’appliquent toujours inchangés à l’intérieur des chemins accordés. Une attribution n’élargit jamais un filtre de lignes.

Chaque point d’entrée de lecture, d’écriture et d’action exécute d’abord la pré-vérification d’attribution. Une combinaison de domaine, de chemin et d’action qu’aucune attribution ne nomme est refusée. Une app avec un ensemble d’attributions vide est refusée partout — le refus par défaut.

La portée effective est recalculée à chaque requête

Section intitulée « La portée effective est recalculée à chaque requête »

Le token ne porte jamais l’attribution. Facet recharge le document de l’app et recalcule l’intersection à chaque requête. Resserrez une attribution, et la requête suivante tourne sous la borne resserrée.

La portée effective ne liste que des chemins de doctypes concrets. Une ligne de rôle avec joker se replie sur chaque doctype accordé. Un doctype qu’aucune attribution ne nomme répond les mêmes refus qu’un rôle sans lecture. Par exemple, un token d’app ne peut pas lire core.DocType tant qu’une attribution ne le nomme pas.

  • Un token d’app (typ: "app") emprunte le flux de code d’autorisation OAuth avec PKCE et DPoP. L’écran de consentement est toujours affiché, et le compte qui autorise élit exactement un rôle pour l’app.
  • Une clé d’API possédée par une app (le canal app_api_key) authentifie le compte de service de l’app. La vérification contrôle aussi l’appà : une clé pour une app en brouillon ou désactivée répond le 401 uniforme. Le droit effectif est attribution ∩ rôle épinglé, calculé à chaque requête.

Chaque mutation par un canal d’app enregistre l’id de l’app, et la liste d’audit filtre par lui. Les événements de connexion portent l’id de l’app pour les sessions d’app. Les refus à la pré-vérification atterrissent dans le journal des connexions — voir Auditer l’activité.

Cet ensemble d’attributions sur un document d’app laisse l’app lire et écrire les contacts, et lire les affairesà :

{
"grants": [
{
"target": "crm.Contact",
"actions": [
{ "name": "read", "required": true },
{ "name": "write", "required": true }
]
},
{
"target": "crm.Deal",
"actions": [
{ "name": "read", "required": true },
{ "name": "write", "required": false }
]
}
]
}

required: true signifie que le rôle doit accorder l’action, sinon le rôle est inutilisable pour l’app. required: false signifie que Facet inclut l’action seulement quand le rôle l’accorde. Son absence ne rejette jamais le rôle.

Le rôle de service ne couvre plus chaque action requise. Le journal du serveur nomme les actions manquantes, par exemple update on fin.Invoice. Élargissez le rôle ou baissez l’exigence.

Un appel répond 403 pour un doctype que l’app atteignait avant

Section intitulée « Un appel répond 403 pour un doctype que l’app atteignait avant »

L’attribution a été resserrée ou retirée. La requête suivante applique le changement.

L’app ne peut pas lire les libellés ou les définitions

Section intitulée « L’app ne peut pas lire les libellés ou les définitions »

Accordez read sur core.DocType, ou codez les valeurs en dur dans l’app.

Une action d’attribution requise manque sur le rôle élu. Vérifiez l’avertissement dans l’onglet « Octrois » de l’app.