Installation Keywall

Installer Keywall sur ton app.

Choisis le bloc dont tu as besoin: Shield pour proteger les visiteurs, Proxy pour cacher les cles API, Studio pour l'app Windows, PM2 pour lancer le site en production.

Shield

Protege un site contre les bots.

Cree un site Shield

Ajoute ton domaine

Colle le script

Installation rapide avec script

Colle ce script dans le layout global du site client. Shield ajoute le checkpoint et transmet le token aux formulaires et fetch.

<script
  src="https://keywall.eu/api/shield/widget.js"
  data-keywall-site-key="shield_live_xxxxxxxxx">
</script>

Installation npm

Utilise le package quand tu veux controler Shield depuis ton code frontend.

npm install keywall-shield

import { KeywallShield } from "keywall-shield";

const shield = new KeywallShield({
  siteKey: "shield_live_xxxxxxxxx",
  baseUrl: "https://keywall.eu",
  autoFetch: true
});

shield.protectForms();

Verification serveur

Le frontend ne suffit pas. Ton backend doit verifier le token avant signup, login, checkout ou formulaire.

const response = await fetch("https://keywall.eu/api/shield/siteverify", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    siteKey: process.env.KEYWALL_SHIELD_SITE_KEY,
    token:
      request.headers.get("x-keywall-shield-token") ||
      request.cookies.get("kw_shield_token")?.value
  })
});

const result = await response.json();
if (!result.success || result.score < 50) {
  return new Response("Blocked", { status: 403 });
}

Proxy API

Appelle tes API externes sans exposer les secrets.

Dans le dashboard: cree un projet, ajoute un secret, cree une route proxy, copie la cle publique et appelle Keywall depuis le frontend.

Exemple frontend

await fetch("https://keywall.eu/api/proxy/project_xxx/ai/chat", {
  method: "POST",
  headers: {
    "x-keywall-key": "pk_live_xxxxxxxxx",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "gpt-5-mini",
    input: "Hello"
  })
});

Studio Windows

Installe l'app desktop.

Keywall Studio réunit l’IDE, le terminal, Git, FTP, les déploiements et les opérations Keywall dans une application Windows.

Télécharger Keywall Studio 0.1.17

Le fichier est servi depuis `/downloads/studio/`. La mise a jour automatique lit aussi le manifeste `latest.yml`.

Production VPS

Lance le site avec PM2 en production.

Ne lance pas `npm run dev` en production. Build l'app, puis PM2 demarre le serveur standalone.

Commandes VPS

npm install
npm run build
npm run pm2:start
pm2 save