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.
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 :
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 :
- Vous le lancez à la racine de votre projet Supabase.
- Il lit vos identifiants dans votre
.env.localet liste les tables de votre base. - Vous choisissez une table et décrivez la règle en une phrase.
- 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
# Dans votre projet Supabase
npx policycraft initinit vérifie la présence de trois variables dans votre .env.local (ou .env) et vous dit précisément ce qui manque :
| Variable | Rôle |
|---|---|
NEXT_PUBLIC_SUPABASE_URL (ou SUPABASE_URL) | URL de votre projet |
SUPABASE_SERVICE_ROLE_KEY | Clé service role (Settings → API) |
OPENAI_API_KEY | Clé OpenAI pour la génération |
Il ajoute aussi un script policycraft à votre package.json. Ensuite :
npx policycraft start
# ou
npm run policycraftL'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èreinitetstart; - une app Next.js 16 en build
standalone, copiée dans le package au moment dunpm 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, expressionUSING, expressionWITH 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.localet 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 :
- Relisez chaque politique (l'explication générée aide beaucoup).
- Mettez-la dans une migration.
- 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
npx policycraft init
npx policycraft start- 📦 npm : https://www.npmjs.com/package/policycraft
- 💻 GitHub : https://github.com/PatrickLoic-dev/supabase-rls-builder
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.