Documentation CLI CoreDevPro™

Préparation CLI

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

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 avec le compte CoreDevPro disposant de l’accès CLI actif :

   coredevpro login

   Demander un accès CLI

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 : le périmètre YAML est appliqué localement puis transmis à 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

Intégration distincte

Intégration CI/CD sur demande

Une intégration continue ne se résume pas à copier les commandes du CLI. CoreDevPro prépare avec vous le dépôt, la plateforme, la branche, les secrets, le périmètre YAML, la quality gate et l’artefact attendu.

Demander une intégration CI/CD

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é CLI

Sécurité côté API

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

• POST /api/cli/access : confirme côté serveur l’accès CLI 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 bloque le scan avant upload.