outils

Ce qu'il faut

• Un accès au dépôt privé « outils » (il n'existe ni site en ligne ni release à télécharger)
• Un ordinateur sous Linux ou sous Windows
• Python, pour les scripts dont le nom finit par .py
• PowerShell, pour le script sauvegarde_mdp.ps1 sous Windows
• Node.js, pour les scripts dont le nom finit par .mjs
• Un VPS que vous administrez, pour les scripts qui le concernent
• Les clés, mots de passe et miroirs de dépôts, qui ne sont pas dans le dépôt et que vous devez conserver à part

Installation

Premier lancement

1. 1Ouvrez le fichier README à la racine du dépôt et lisez le tableau des dossiers.
2. 2Identifiez la tâche qui vous intéresse (sauvegarde, signature, publication, veille ou test de navigateur) et le dossier ou fichier associé.
3. 3Ouvrez ce script dans un éditeur de texte et lisez-le avant de le lancer, puisque ce sont des scripts personnels.
4. 4Vérifiez que les clés ou mots de passe dont il a besoin sont disponibles hors du dépôt.
5. 5Lancez le script depuis un terminal avec l'outil correspondant à son type (Python, PowerShell ou Node.js).

Sauvegarder le VPS vers son PC

Le script sauvegarde_vps.py sert à sauvegarder le VPS vers le PC.

1. 1Ouvrez sauvegarde_vps.py dans un éditeur et lisez ce qu'il fait avant de l'utiliser.
2. 2Vérifiez que votre PC est allumé et que l'accès à votre VPS fonctionne.
3. 3Lancez le script avec Python depuis un terminal.
4. 4Contrôlez ensuite que les données sont bien arrivées sur le PC.

Sauvegarder ses mots de passe

Le script sauvegarde_mdp.ps1 copie les mots de passe vers le lecteur E:\.

1. 1Branchez ou montez le support qui correspond au lecteur E:\.
2. 2Ouvrez PowerShell sous Windows.
3. 3Lancez le script sauvegarde_mdp.ps1.
4. 4Vérifiez que la sauvegarde est présente sur E:\ une fois le script terminé.

Signer une application Windows

Le dossier signer contient le certificat public et les scripts de signature de code Windows.

1. 1Ouvrez le dossier signer et repérez les scripts qu'il contient.
2. 2Lisez le script de signature pour savoir quel fichier il attend.
3. 3Vérifiez que la clé privée de signature est disponible hors du dépôt.
4. 4Lancez le script de signature sous Windows sur votre application.
5. 5Contrôlez que l'application porte bien la signature.

Synchroniser les dépôts et publier une release

Le dossier securisation-vps synchronise les dépôts vers le VPS et publie les releases. Le fichier autoriser_release.py crée des règles temporaires pour publier un dépôt privé.

1. 1Ouvrez le dossier securisation-vps et lisez ses scripts.
2. 2Pour un dépôt privé, lancez d'abord autoriser_release.py afin de poser les règles temporaires.
3. 3Lancez ensuite le script de publication de la release.
4. 4Vérifiez que la release est bien publiée.
5. 5Contrôlez que les règles temporaires ne sont plus nécessaires une fois la publication faite.

Suivre les failles de sécurité

Le script veille_failles.py assure la veille quotidienne des failles.

1. 1Ouvrez veille_failles.py et lisez ce qu'il surveille.
2. 2Lancez le script avec Python depuis un terminal.
3. 3Lisez le résultat pour repérer les failles qui concernent vos outils.
4. 4Relancez le script chaque jour pour garder une veille à jour.

Tester une application dans un navigateur

Plusieurs scripts Node.js contrôlent les règles CSP et exécutent des tests de navigateur : csp_check.mjs, fc_csp_smoke.mjs, next_csp_externalize.mjs, static_serve.mjs et edge_playwright.mjs.

1. 1Vérifiez que Node.js est installé sur votre machine.
2. 2Choisissez le script qui correspond à votre contrôle dans la liste des fichiers .mjs.
3. 3Ouvrez-le dans un éditeur pour connaître ce qu'il attend.
4. 4Lancez-le avec Node.js depuis un terminal.
5. 5Lisez le résultat affiché pour repérer les anomalies.

Piloter une application fenêtrée

Les scripts pilote.py et clic_reel.py pilotent la souris et le clavier réels d'une application fenêtrée. Le dossier visites sert à tourner des visites guidées des applications, avec des scénarios et des scripts.

1. 1Ouvrez l'application à piloter et laissez sa fenêtre visible.
2. 2Lisez pilote.py ou clic_reel.py pour savoir ce qu'ils attendent.
3. 3Lancez le script avec Python et ne touchez plus à la souris ni au clavier.
4. 4Pour une visite guidée, consultez les scénarios du dossier visites avant de lancer leurs scripts.

Astuces

• Lisez toujours un script avant de le lancer : ce sont des outils personnels, pas des programmes grand public.
• Gardez les clés, mots de passe et miroirs de dépôts hors du dépôt, comme le prévoit le fichier .gitignore.
• Pour les agents IA du VPS, consultez le README interne du dossier agents-vps, qui indique les emplacements et les minuteurs.
• Le dossier docker/postgres-suexec propose une image Postgres 16 alpine sans le binaire gosu, avec su-exec à la place.

Questions fréquentes