Skip to content

Security: DNUM-SocialGouv/pilotage_studios_grist

Security

SECURITY.md

Sécurité — Custom Widget Grist

Ce que l’URL publique expose (et n’expose pas)

Exposé Non exposé
Le code JavaScript/CSS du widget (Pages) Les données du document Grist
Le fait qu’un widget Pilotage existe (si on inspecte le JS) Clés API Grist / LLM (aucune dans le bundle)

Ouvrir https://…github.io/pilotage_studios_grist/ seul (hors iframe Grist) :

  • n’affiche pas l’UI métier (pas de menu, pas d’Alert) — page morte « Rien à afficher. » (NothingHerePage via getEmbedTrust) ;
  • n’affiche aucune ligne métier : pas de session Grist, pas de postMessage parent.

Les données n’apparaissent que si :

  1. un utilisateur authentifié ouvre le document Grist,
  2. avec ce widget embarqué et un niveau d’accès accordé,
  3. via le canal grist-plugin-api (droits = ceux de l’utilisateur).

Le garde-fou hors iframe est de l’obscurcissement UX / OPSEC, pas un contrôle d’accès fort : le JS reste téléchargeable.

En DEV (npm run dev), le gate est contourné pour faciliter le travail local hors iframe.

Menace principale

Compromission du JS hébergé (compte GitHub, supply chain npm, Pages) → code malveillant exécuté chez les collègues qui ont le widget ouvert → exfiltration / modification via l’accès widget (full).

Ce n’est pas « tout Internet lit notre Grist » ; c’est « un attaquant qui contrôle l’URL du widget agit avec les droits des utilisateurs Grist qui le chargent ».

Garde-fous en place (V1)

  1. Aucun secret dans le dépôt / bundle (VITE_GRIST_API_KEY, clés LLM, URL Incoming Webhook Mattermost / Tchap, tokens d’automation Grist — interdits). Alertes feedback (Kanban / Statut Nouveau) = config doc Grist hors repo (docs/fonctionnel/feedback/alertes.md).
  2. Contrôle d’embed (src/security/embedTrust.ts) : refuse grist.ready si l’iframe a un parent non Grist ; en prod hors iframe / embed non fiable → NothingHerePage (pas de nav).
  3. Allowlist des fetchTable : uniquement via fetchAllowlistedTable (src/security/fetchTableAllowlist.ts) — refus runtime hors liste, pas d’ID libre côté UI. Tables lazy (Realise, missions, équipe, Equipe_TJM, produits) : allowlist et fetch sur /bdc/:id (Dépenses), /missions (liste + fiche), /cra (liste lecture), /cra/declarer (déclaration), /cra/revue-equipe (revue manager), /outils/recap-porteurs (récap porteurs), /weekly (kanban + agenda), /equipe (annuaire + grille tarifs), ou panneau feedback (select auteur → Equipe uniquement) — pas au boot PA. Weekly_phase / Weekly_agenda / Weekly_action / Weekly_coachs : lecture lazy (Weekly + allowlist coachs) ; e-mails coachs hors git. Acl_profil : lecture après boot PA pour filtrer la nav / gardes (couche 5). Droits_pages : lecture lazy Admin sur /outils/droits-pages (ACL Grist Owner/Admin déjà en place). Kanban / Kanban_commentaires : lecture après boot PA pour la feuille de route (Feedback + tickets produit + fil de commentaires ; create Feedback + create commentaires + update colonne / corps Admin via write allowlist).
  4. Écriture métier : uniquement via grist.getTable + garde writeTableAllowlist.ts — pas de REST avec clé API, pas de delete widget (lignes), sauf Weekly_action et Weekly_agenda (exceptions documentées). Exceptions écriture : Kanban (create Feedback ; update Colonne_kanban + corps Resume / Message Admin UX) ; Kanban_commentaires (create conversation tickets) ; Missions (create + update patch Nom / Produit / Statut via drawer ; update Suivi_resp_studio via édition sur place Note studio ; update Liens_FIGMA_Notion via panneau Contexte ; update Docs via panneau PJ Contexte — upload REST POST /attachments avec getAccessToken({ readOnly: false }) puis rattachement ids ; retrait = update cellule sans purge fichier document) ; Prestations (create + update via drawer prestation — Titre_de_la_prestation, intervenant, jours, statut, date de début ; type Freelance figé à la création ; pas de delete) ; Realise (create + update déclaration CRA freelance — Nb_jours, Taches_realisees, période, rattachements ; update revue équipe — Nb_jours, Taches_realisees, BDC_cible ; pas de delete ni Calcul_TTC) ; Acl_profil (create only, fiche session auto si absente — E_mail = compte connecté ; pas d’update/delete) ; Droits_pages (update only, page Admin — cases Page_* ; Page_accueil forcé à vrai ; pas de create/delete de rôles) ; Equipe (create + update, drawer Admin — identité / rôle ; pas d’écriture TJM fiche) ; Equipe_TJM (create + update, grille tarifs Admin — Personne, Specialite, TJM, Date_debut, Date_fin, Commentaire ; pas de delete) ; Weekly_phase (create + update, phase kanban Weekly + suivi ops drawer : Phase · Meteo · Note_ops · Membre_equipe RefList→Equipe — pas d’écriture Missions) ; Weekly_agenda (create + update + delete, sujets Weekly — Traite / Traite_le / Texte titre / Detail / Mission ; exception getTable().destroy une ligne après confirmation UI ; avant destroy, détache Weekly_action.Sujet sur les actions liées ; pas de masse) ; Weekly_action (create + update + delete, actions Ops — Titre · Statut · Porteur · Mission · Sujet (opt. Ref→Weekly_agenda) · Date_fin · Weekly_du · Notes · Fait · Fait_le · Cree_le · Email ; exception getTable().destroy une ligne après confirmation UI ; pas de masse) ; BDC (update only, drawer cadre fiche Admin/Owner — Nom_BdC, Statut, Montant_TTC, Financeur, BdC_Chorus, PA, Equipe2, Plateforme, SOFIANE ; pas create/delete ni Devis ni totaux calculés). Tout le reste (delete de lignes hors Weekly_action / Weekly_agenda, édition commentaires, édition autres champs tickets hors colonne / Resume / Message) reste interdit côté widget. ACL Grist Create/Update = HITL (feedback + commentaires + missions + Realise déclaration/revue + Acl_profil + droits pages + Kanban colonne / corps Admin + Equipe create/update + Equipe_TJM + Weekly satellites + BDC cadre). Access Rules Realise (mur freelance / département) : fait (#47 / #70) — voir docs/fonctionnel/roles/access-rules.md. Access Rules Equipe (CRUD Owner/Admin) : fait (#55). Access Rules Equipe_TJM : fait (#86). Access Rules BDC montants / Sofiane / Plateforme : Owner|Admin +RU (fait). Access Rules Weekly_phase / Weekly_agenda / Weekly_action : fait (Owner + coachs ; vérif MCP).
  5. Téléchargement attachments / lecture BDC / Realise / Equipe (auteur feedback) : docApi.getAccessToken({ readOnly: true }) → REST ?auth= (jeton court, scoped document + utilisateur connecté) quand pertinent ; upload PJ mission : même mécanisme en readOnly: false (pas de clé API bundle). Écriture cadre BDC : pas via ce token REST — uniquement getTable('BDC').update allowlisté. Equipe aussi via fetchTable allowlisté pour le select auteur. Le jeton n’existe que pendant une session iframe Grist authentifiée — il n’est pas publié sur Pages ni utilisable hors session.
  6. CSP injectée au build (meta) + script API depuis grist.numerique.gouv.fr (sans eval ; docs.getgrist.com est en mode eval et casse sous CSP). img-src autorise aussi https://api.dicebear.com pour les avatars Glyphs de l’annuaire Équipe (seed stocké dans Equipe.Avatar ; pas de clé, images SVG publiques).
  7. Pas de source maps en production.
  8. Repo : revue PR / protection de main recommandées (org).
  9. Dependabot / npm audit dans la CI Pages.
  10. Auto-bust cache (version.json + ensureFreshBuild) : après un déploiement Pages, l’iframe se recharge seule si le HTML/JS en cache est périmé — URL Grist stable, sans ?v= manuel.

Limites GitHub Pages

  • Pas de header HTTP Content-Security-Policy: frame-ancestors … (meta CSP ne le couvre pas) → le contrôle parent est fait en JS.
  • Le JS reste téléchargeable : ne pas y mettre de logique « secrète ».
  • L’URL Pages est publique même si le dépôt source devient privé (sauf Pages privés Enterprise).
  • Sur org GitHub Free, Pages n’est disponible que depuis un repo public : passer le dépôt en privé casse Pages tant que l’org n’est pas au moins Team (ou hébergement ailleurs).

Durcissement org recommandé

  • Branch protection main : PR obligatoire, pas de push direct.
  • 2FA sur les comptes avec droit d’écriture (déjà exigible au niveau org si activé).
  • Restreindre qui peut modifier le workflow Pages.
  • Surveiller les releases / commits sur main.
  • Moyen terme : upgrade org Team → repo privé (source moins exposée) + gate UI inchangé sur l’URL Pages.
  • Données personnelles : le dépôt est public. Ne pas committer d’inventaires nominatifs Grist (emails, noms, rosters /access). Docs rôles = agrégats uniquement ; listes détaillées via MCP en local (hors git).

Si incident (JS compromis)

  1. Désactiver le widget dans Grist (retirer l’URL / la page).
  2. Révoquer accès GitHub suspects ; republier un build sain.
  3. Auditer l’activité Grist (modifications récentes) pour les utilisateurs concernés.

There aren't any published security advisories