Repository Public
1# Exploitation23## Déploiement (MacLustr)4Application `sp-browser-backend` gérée par `mld` (manifeste `M1M32:~/dispatch/apps/sp-browser-backend.json`), processus PM2 `sp-browser-backend` (`node src/server.ts`, port 8710) et `sp-browser-backup` (cron quotidien). Domaine `browser.spboucher.ai` → passerelle BHS64 (route Caddy posée par `mld deploy`).5Le dossier déployé est le dépôt (`origin` = spbgit `sp-browser-backend.git`) : modifier **sur le nœud**, `pm2 restart sp-browser-backend`, puis `git commit && git push` sur le nœud.67Secrets : `~/apps/sp-browser-backend/.env` (600), exclu de git et du rsync. Données : `~/apps-data/sp-browser-backend/sp-browser.sqlite` (+ `-wal`, `-shm`).89## Configuration10Voir `.env.example`. Points d'attention :11- `RP_ID` / `PUBLIC_ORIGIN` : les clés d'accès sont liées à ce domaine — le changer invalide toutes les clés d'accès.12- `APPLE_APP_IDS` : identifiants `<équipe>.<bundle>` servis dans `/.well-known/apple-app-site-association` (Apple met ce fichier en cache, jusqu'à 24 h).13- `DAILY_CREDIT_BUDGET` : plafond de crédits Tavily par jour UTC.1415## Migrations16`src/db.ts` : liste `MIGRATIONS`, ajout en fin de liste uniquement ; version suivie par `PRAGMA user_version`, chaque migration dans une transaction, appliquée au démarrage. `GET /api/health` renvoie `schema`.1718## Sauvegarde19`scripts/backup.sh` : copie cohérente à chaud (`VACUUM INTO`), contrôle d'intégrité, gzip, rétention 30 jours dans `~/backups/sp-browser-backend/`. La base contient des clés publiques, des hachages de jetons et du texte chiffré de bout en bout : une sauvegarde seule ne révèle pas la navigation.2021## Restauration22```bash23pm2 stop sp-browser-backend24cd ~/apps-data/sp-browser-backend && mv sp-browser.sqlite sp-browser.sqlite.bad; rm -f sp-browser.sqlite-wal sp-browser.sqlite-shm25gunzip -c ~/backups/sp-browser-backend/sp-browser-<date>.sqlite.gz > sp-browser.sqlite && chmod 600 sp-browser.sqlite26sqlite3 sp-browser.sqlite 'PRAGMA integrity_check'27pm2 start sp-browser-backend && curl -s localhost:8710/api/health28```29Après restauration, les appareils dont le numéro de séquence dépasse celui de la sauvegarde renvoient leurs changements manquants au prochain cycle (l'app repousse tout enregistrement local que le serveur ne connaît plus).3031## Reprise après perte32- **Nœud perdu** : `mld deploy sp-browser-backend --node X`, recopier `.env` (copie : `~/Desktop/Cluster/secrets/sp-browser-backend/` sur le laptop) et la dernière sauvegarde.33- **Clé Tavily compromise** : la régénérer chez Tavily, remplacer `TAVILY_API_KEY`, `pm2 restart`. Les apps n'ont jamais la clé.34- **Utilisateur sans clé d'accès** : il utilise sa clé de récupération dans l'app. Sans elle, personne (pas même l'administrateur) ne peut rouvrir ses données ; on peut seulement supprimer le compte.35- **Invitation** : `node scripts/invite.ts create "pour qui"`.3637## Surveillance38`/admin` (ou `GET /api/admin/overview`, `Authorization: Bearer $ADMIN_TOKEN`) : santé, crédits du jour / plafond, usage 30 jours et coût estimé (0,008 $ US par crédit, tarif à l'usage), compte Tavily (`/usage`), comptes/appareils/sessions, enregistrements chiffrés par collection, appareils en attente de clé, erreurs 24 h, journal opérationnel.39