Documentation CLI et CI/CD CoreDevPro™

Préparation commune

Avant de commencer

Le CLI CoreDevPro s’installe comme un paquet Node.js global depuis CoreDevPro. Il ne contient pas de moteur d’analyse local : il prépare le projet, vérifie l’accès côté serveur et récupère le rapport demandé.

Ne décompressez pas ce fichier. Installez-le avec npm.

npm install -g https://coredevpro.fr/downloads/coredevpro-scan-0.2.23.tgz

Demander un accès CLI / CI

Parcours CLI direct

Utiliser le CLI dans un terminal

1. Étape 1 : installez le CLI CoreDevPro

   Dans un terminal, installez la commande coredevpro :

   Utilisez toujours la dernière commande d’installation affichée ici : si votre CLI est trop ancien, l’API refusera le scan et demandera une mise à jour.

   npm install -g https://coredevpro.fr/downloads/coredevpro-scan-0.2.23.tgz

2. Étape 2 : vérifiez l’installation

   Confirmez que la commande répond correctement :

   coredevpro --help

3. Étape 3 : ouvrez le terminal du projet

   Placez-vous à la racine du projet à analyser :

   cd /path/to/your/project

   Si aucun dépôt Git n’est détectable, remplacez project-id par un identifiant stable : il associe la session terminal au bon projet. Le .cdp natif est produit par défaut ; JSON et le .cdp chiffré localement restent disponibles.

   export COREDEVPRO_PROJECT_ID=project-id

4. Étape 4 : identifiez-vous

   Lancez la connexion, puis choisissez soit un accès CLI actif pour un usage direct, soit une licence CI active pour un pipeline ou un environnement automatisé :

   coredevpro login

   Demander un accès CLI / CI

5. Étape 5 : vérifiez la session

   Confirmez que la session est active :

   coredevpro status

6. Étape 6 : faites un dry-run

   Vérifiez les fichiers inclus sans lancer de scan réel. Aucun YAML n’est requis ; ajoutez seulement des exclusions ciblées si le périmètre doit être ajusté.

   Télécharger le YAML facultatif

   coredevpro scan . --dry-run

7. Étape 7 : choisissez le format et lancez le scan

   Démarrez l’analyse : le .cdp natif est généré par défaut. Demandez explicitement JSON ou le .cdp chiffré selon votre workflow.

   Mode natif · rapport .cdp

   coredevpro scan .

   Export optionnel · JSON

   coredevpro scan . --output coredevpro-report.json

   Mode CDP chiffré · mot de passe requis

   coredevpro scan . --output coredevpro-report.encrypted.cdp --cdp-password choose-your-password

8. Étape 8 : confirmez si un YAML est détecté

   En mode interactif, le CLI demande confirmation si coredevpro_config.yml est présent. Répondez y. En mode --ci, aucune saisie n’est demandée : le périmètre YAML est appliqué localement et la configuration est transmise à l’analyse serveur.

9. Étape 9 : importez le rapport dans CoreAnalyzer

   Une fois le scan terminé, importez le rapport JSON ou CDP dans CoreAnalyzer pour retrouver l’analyse complète, SAI, l’investigation, les filtres et les exports.

   https://coredevpro.fr/core-analyzer?mode=import

   Ouvrir CoreAnalyzer

Importer un rapport JSON ou CDP

Parcours CI/CD

Configurer un pipeline CI/CD

Dans le pipeline, ajoutez la licence CI dans un secret nommé COREDEVPRO_LICENCE, installez le CLI CoreDevPro, puis lancez le scan :

npm install -g https://coredevpro.fr/downloads/coredevpro-scan-0.2.23.tgz

Mode natif · rapport .cdp

coredevpro scan . --ci --fail-on critical --output coredevpro-report.cdp

Export optionnel · JSON

coredevpro scan . --ci --fail-on critical --output coredevpro-report.json

Mode CDP chiffré · mot de passe requis

coredevpro scan . --ci --fail-on critical --output coredevpro-report.encrypted.cdp --cdp-password-env COREDEVPRO_CDP_PASSWORD

La licence CI est pensée pour les pipelines et les environnements automatisés. Le .cdp natif est la sortie par défaut ; JSON et le .cdp chiffré restent disponibles selon l’accès actif.

Guides par plateforme

Ouvrez la procédure correspondant à votre pipeline. Chaque guide couvre le secret, le fichier CI, le périmètre et l’import du rapport.

Sorties communes

Pourquoi .cdp et JSON ?

Le .cdp natif contient le rapport CoreAnalyzer et une preuve d’origine CoreDevPro vérifiable avec la clé publique intégrée au CLI. JSON reste disponible ; le chiffrement des rapports sensibles est effectué localement.

• CLI = .cdp natif par défaut, JSON ou .cdp chiffré sur demande.
• CoreAnalyzer = visualisation, SAI, investigation, filtres et exports.
• Agents autorisés = lecture du payload .cdp ou de l’export JSON comme contexte structuré.

Sécurité commune

Sécurité côté API

Avant tout scan réel, le serveur valide l’accès CLI ou la licence CI. Sans accès actif, aucun upload de projet n’est accepté.

• POST /api/cli/access : confirme côté serveur l’accès CLI ou la licence CI avant tout scan réel.
• POST /api/v1/scans : crée un scan distant après validation d’accès.
• GET /api/v1/scans/{id}/status : suit l’état du scan.
• GET /api/v1/scans/{id}/report?format=cdp : récupère le rapport natif scellé côté serveur. format=json fournit l’export structuré optionnel.

Chaque requête de scan utilise un jeton éphémère signé par le serveur. Un accès CLI inactif ou une licence CI invalide bloque le scan avant upload.