| 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. » (
NothingHerePageviagetEmbedTrust) ; - n’affiche aucune ligne métier : pas de session Grist, pas de
postMessageparent.
Les données n’apparaissent que si :
- un utilisateur authentifié ouvre le document Grist,
- avec ce widget embarqué et un niveau d’accès accordé,
- 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.
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 ».
- 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). - Contrôle d’embed (
src/security/embedTrust.ts) : refusegrist.readysi l’iframe a un parent non Grist ; en prod hors iframe / embed non fiable →NothingHerePage(pas de nav). - Allowlist des
fetchTable: uniquement viafetchAllowlistedTable(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 →Equipeuniquement) — 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). - Écriture métier : uniquement via
grist.getTable+ gardewriteTableAllowlist.ts— pas de REST avec clé API, pas de delete widget (lignes), saufWeekly_actionetWeekly_agenda(exceptions documentées). Exceptions écriture :Kanban(create Feedback ; updateColonne_kanban+ corpsResume/MessageAdmin UX) ;Kanban_commentaires(create conversation tickets) ;Missions(create + update patch Nom / Produit / Statut via drawer ; updateSuivi_resp_studiovia édition sur place Note studio ; updateLiens_FIGMA_Notionvia panneau Contexte ; updateDocsvia panneau PJ Contexte — upload RESTPOST /attachmentsavecgetAccessToken({ 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 niCalcul_TTC) ;Acl_profil(create only, fiche session auto si absente —E_mail= compte connecté ; pas d’update/delete) ;Droits_pages(update only, page Admin — casesPage_*;Page_accueilforcé à vrai ; pas de create/delete de rôles) ;Equipe(create + update, drawer Admin — identité / rôle ; pas d’écritureTJMfiche) ;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_equipeRefList→Equipe — pas d’écritureMissions) ;Weekly_agenda(create + update + delete, sujets Weekly —Traite/Traite_le/Textetitre /Detail/Mission; exceptiongetTable().destroyune ligne après confirmation UI ; avant destroy, détacheWeekly_action.Sujetsur 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; exceptiongetTable().destroyune 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 niDevisni totaux calculés). Tout le reste (delete de lignes horsWeekly_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 RulesRealise(mur freelance / département) : fait (#47 / #70) — voirdocs/fonctionnel/roles/access-rules.md. Access RulesEquipe(CRUD Owner/Admin) : fait (#55). Access RulesEquipe_TJM: fait (#86). Access RulesBDCmontants / Sofiane / Plateforme : Owner|Admin+RU(fait). Access RulesWeekly_phase/Weekly_agenda/Weekly_action: fait (Owner + coachs ; vérif MCP). - 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 enreadOnly: false(pas de clé API bundle). Écriture cadreBDC: pas via ce token REST — uniquementgetTable('BDC').updateallowlisté.Equipeaussi viafetchTableallowlisté 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. - CSP injectée au build (meta) + script API depuis
grist.numerique.gouv.fr(sanseval;docs.getgrist.comest en mode eval et casse sous CSP).img-srcautorise aussihttps://api.dicebear.compour les avatars Glyphs de l’annuaire Équipe (seed stocké dansEquipe.Avatar; pas de clé, images SVG publiques). - Pas de source maps en production.
- Repo : revue PR / protection de
mainrecommandées (org). - Dependabot /
npm auditdans la CI Pages. - 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.
- 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).
- 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).
- Désactiver le widget dans Grist (retirer l’URL / la page).
- Révoquer accès GitHub suspects ; republier un build sain.
- Auditer l’activité Grist (modifications récentes) pour les utilisateurs concernés.