Quickstart Shield Ready

1 clé = 1 zip certifiable. Objectif : CERTIFIED en moins d’une heure sur un stack Node standard.

Prérequis

Compte org + pack actif (CSA / CME / CMA / CEN) sur le portail
Zip kit téléchargé (stack=node)
App Express (ou compatible) avec express.json()
Origin de prod / préprod connue (allowlist return_url)

Installer le kit

unzip ageshield-kit-{keyId}-node.zip
node install.mjs --key=VOTRE-CLE --origin-site=https://votre-site.fr --merge-env
pm2 reload votre-app

install.mjs pose l’env, copie le stack, et peut patcher l’entrée app selon options.

Brancher wire

const express = require('express');
const app = express();
app.use(express.json());
require('./ageshield/wire')(app); // capabilities = contrat de la clé

Équivalent : require('./ageshield/lib/ageshield').wire(app).

moderate → filtre contenu
age.verify → modale + UX + garde inscription (pas de redirect signup magique)
Isolation / DM / curfew → selon capabilities

Certifier

node ageshield/certify.mjs --live

Succès = statut CERTIFIED + fichier AGESHIELD_CERTIFIED.json.

Échec schéma Prisma (cas CSP / custom) → bascule Shield Connect. Packs CPL : pas de wire — voir Plateformes.

Vérifier vite

Portail → Tester ma clé
Un POST /api/v1/shield/check en allow
Si pack âge : parcours signup → verify_url → retour avec tier

Mise en place → API → Stacks →