Aller au contenu
Produit11 nov. 2026 · 6 min de lecture

PolicyCraft : décrivez vos règles de sécurité, obtenez vos politiques RLS Supabase

Décrivez vos règles de sécurité en langage naturel. Récupérez des politiques RLS Supabase prêtes à relire et à appliquer.

Patrick LoicConsultant digital & ingénieur frontend
Partager
ProduitPOLICY CRAFT.

Le problème : la RLS, tout le monde sait qu'il faut la faire, personne n'aime l'écrire

Si vous construisez avec Supabase, vous connaissez le deal : votre base est exposée directement au client via PostgREST. Ce qui protège vos données, ce n'est pas votre backend — c'est la Row Level Security de PostgreSQL.

Et c'est là que ça coince. Une règle métier toute simple :

« Un utilisateur ne peut voir que les messages des conversations auxquelles il participe. »

…devient ça :

snippet.sqlSQL
CREATE POLICY "users_see_own_conversation_messages"
ON public.messages
AS PERMISSIVE FOR SELECT
TO authenticated
USING (
  conversation_id IN (
    SELECT conversation_id
    FROM public.conversation_participants
    WHERE user_id = auth.uid()
  )
);

Puis il faut penser au INSERT (avec un WITH CHECK, pas un USING), à l'UPDATE, au DELETE, au bon rôle (authenticated ? anon ?), au nommage… Et une politique oubliée ou trop permissive, c'est une fuite de données silencieuse.

Sur mes projets (messagerie, e-commerce, back-offices), j'ai passé plus de temps que je ne voudrais l'admettre à faire des allers-retours entre la doc Supabase et l'éditeur SQL. D'où l'idée de PolicyCraft.

Ce que fait PolicyCraft

PolicyCraft est un outil de dev local, installable via npm, qui transforme une règle écrite en langage naturel en politiques RLS Supabase.

Le parcours tient en quatre étapes :

  1. Vous le lancez à la racine de votre projet Supabase.
  2. Il lit vos identifiants dans votre .env.local et liste les tables de votre base.
  3. Vous choisissez une table et décrivez la règle en une phrase.
  4. Il génère les CREATE POLICY — une par opération quand c'est nécessaire — avec une explication pour chacune. Vous relisez, puis vous appliquez ou copiez dans votre migration.

Démarrer en deux commandes

snippet.bashShell
# Dans votre projet Supabase
npx policycraft init

init vérifie la présence de trois variables dans votre .env.local (ou .env) et vous dit précisément ce qui manque :

VariableRôle
NEXT_PUBLIC_SUPABASE_URL (ou SUPABASE_URL)URL de votre projet
SUPABASE_SERVICE_ROLE_KEYClé service role (Settings → API)
OPENAI_API_KEYClé OpenAI pour la génération

Il ajoute aussi un script policycraft à votre package.json. Ensuite :

snippet.bashShell
npx policycraft start
# ou
npm run policycraft

L'interface s'ouvre sur http://localhost:3030 (--port pour changer de port, --no-open pour ne pas ouvrir le navigateur).

Sous le capot

Une CLI qui embarque une app Next.js

Le package npm contient deux choses :

  • une CLI (commander) qui gère init et start ;
  • une app Next.js 16 en build standalone, copiée dans le package au moment du npm publish.

policycraft start lit les variables d'environnement du projet dans lequel vous êtes, les injecte côté serveur, démarre le serveur Next.js en local et ouvre le navigateur. Aucune configuration à recopier, aucune clé à coller dans un formulaire.

Découvrir les tables sans accès SQL direct

Pour lister les tables, PolicyCraft interroge simplement la spec OpenAPI exposée par PostgREST (/rest/v1/) : chaque chemin correspond à une table ou une vue. Les politiques existantes sont lues depuis la vue système pg_policies quand elle est accessible.

La génération : un prompt strict et une sortie JSON

Côté IA, j'utilise GPT-4o avec deux garde-fous :

  • une température basse (0.1) — on veut du SQL déterministe, pas de la créativité ;
  • le mode JSON (response_format: json_object), avec un schéma imposé : nom, opération, expression USING, expression WITH CHECK, SQL complet et explication.

Le prompt système impose les conventions Supabase : auth.uid() pour l'utilisateur courant, auth.jwt() pour les claims, des politiques séparées par opération quand c'est pertinent, et un commentaire sur chaque politique. Le parsing côté serveur est tolérant (si le modèle change la clé racine, on récupère le premier tableau trouvé), ce qui évite les erreurs bêtes.

Appliquer… ou copier

L'application en un clic passe par une fonction RPC exec_sql dans votre base. Si elle n'existe pas, PolicyCraft ne fait rien en douce : il vous le dit, et vous copiez le SQL dans l'éditeur Supabase ou dans votre fichier de migration. Honnêtement, c'est souvent le meilleur chemin : vos politiques RLS ont leur place dans vos migrations versionnées.

L'interface

  • Next.js 16 (App Router), shadcn/ui, Tailwind CSS v4
  • Animations avec motion (ex-Framer Motion)
  • Thème clair / sombre
  • Interface en anglais et en français

Le modèle de sécurité

Un outil qui manipule une clé service_role doit être irréprochable sur ce point :

  • Le serveur tourne uniquement en local. Rien n'est exposé sur Internet.
  • Les clés restent côté serveur. Elles sont lues depuis votre .env.local et ne sont jamais incluses dans le bundle JavaScript client.
  • Elles ne partent que vers Supabase et OpenAI. Aucun autre service ne les reçoit.

Ce que PolicyCraft n'est pas

Je préfère être clair : PolicyCraft ne remplace pas votre jugement. Un LLM peut produire une politique syntaxiquement parfaite et logiquement fausse — trop large, ou qui oublie un cas. Le SQL généré est un brouillon de qualité, pas une vérité.

Ma recommandation :

  1. Relisez chaque politique (l'explication générée aide beaucoup).
  2. Mettez-la dans une migration.
  3. Testez-la avec plusieurs utilisateurs, y compris un utilisateur qui ne devrait pas avoir accès.

L'objectif, c'est de passer de « 20 minutes à chercher la syntaxe » à « 2 minutes à relire et valider ».

Ce que ce projet m'a appris

  • Packager une app Next.js comme CLI npm, c'est faisable et plutôt élégant avec le build standalone — mais il faut penser à copier les assets statiques (.next/static, public/) à la main avant publication. J'ai eu droit au classique « les images du README ne s'affichent pas sur npm » : chemins relatifs à remplacer par des URLs absolues. D'où la v1.0.1.
  • Lire la config du projet hôte (process.cwd()) plutôt que demander à l'utilisateur de coller ses clés change complètement l'expérience.
  • Contraindre la sortie d'un LLM (JSON, schéma, température basse) fait la différence entre une démo et un outil utilisable.

La suite

Quelques pistes sur lesquelles je réfléchis :

  • donner au modèle le schéma réel des tables (colonnes, clés étrangères) pour des politiques plus précises ;
  • exporter directement en fichier de migration Supabase ;
  • supporter d'autres fournisseurs de modèles.

Essayez-le

snippet.bashShell
npx policycraft init
npx policycraft start

C'est open source (MIT). Si vous l'essayez, vos retours — bugs, idées, règles où la génération se trompe — m'intéressent énormément.

OpenAINodeJS
Écrit parPatrick LoicConsultant digital et ingénieur frontend, fondateur de KreativEinfluss. Je construis du web fintech, e-commerce et orienté design depuis le Cameroun.