AI CodeOps

Service Python : SBOM et barrière de licences

Mis à jour le

Repérez les licences copyleft parmi les dépendances d'un service Python avec Dependency Refresh, enregistrez un SBOM CycloneDX et faites refuser en CI les livraisons avec du code GPL.

Utiliser ce template

Les problèmes de licence coûtent moins cher à corriger avant une livraison qu'après l'audit d'un client. Ce template fait trouver et remplacer les dépendances copyleft par les agents, puis donne à votre CI une vérification stricte par rapport au SBOM du projet.

Quels agents interviennent

  1. Audit, par le Dependency Auditor : lit pyproject.toml et le README, et liste les paquets qui présentent des conflits de licence, des vulnérabilités connues (d'après les connaissances du modèle, pas une base de données en direct) ou une absence de maintenance, chacun avec un chemin de mise à niveau.
  2. Upgrade, par le Migration Specialist : le plan de remplacement ou de suppression, avec des notes de rollback.
  3. Test, par le Tester : si le changement écrit et son exécution de tests enregistrée montrent que rien n'est cassé, et quels cas manquent encore.
  4. Verify secure, par le Security Auditor : vérifie le changement écrit.

Le changement est écrit après l'étape Upgrade, et vos tests s'exécutent dessus. Test et Verify secure s'exécutent ensuite : ils lisent donc le vrai diff et son résultat de test.

L'agent ne lit que les dépendances directes. Les lockfiles comme poetry.lock ne sont pas inclus : les licences transitives lui sont donc en grande partie invisibles, et c'est ce que couvre la vérification du SBOM.

Votre suite de tests s'exécute dans un bac à sable hors ligne. Après la dernière étape, le changement passe par une revue des constats avec l'audit comme contexte (les constats de dépendances s'affichent sur la page d'exécution), puis par une approbation humaine.

Enregistrer le SBOM

AI CodeOps ne génère pas de SBOM. Produisez un fichier CycloneDX ou SPDX avec vos outils de build, puis enregistrez-le pour le projet depuis une session connectée, via /api/sbom ; pendant la bêta ouverte, il n'y a ni formulaire d'envoi ni enregistrement par clé API. Le résumé des licences sous Secure → Security affiche les chaînes de licence exactes qu'il a trouvées. Enregistrez un nouveau SBOM une fois le changement de dépendances fusionné, car la barrière lit le plus récent du projet.

Soumettre les livraisons à une barrière de licences

curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
  -H "Authorization: Bearer $WORKSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"pullRequestURL\":\"$PR_URL\",\"disallowedLicenses\":[\"GPL-3.0-only\",\"GPL-3.0-or-later\",\"AGPL-3.0-only\",\"AGPL-3.0-or-later\"]}" \
  | jq -e '.allowed == true'

La correspondance est exacte et ne tient pas compte de la casse : GPL-3.0 ne correspond donc pas à GPL-3.0-only. Listez chaque identifiant tel qu'il apparaît dans le résumé des licences de votre SBOM. Une correspondance refuse la livraison avec licenseViolations. Consultez Sécurité et SBOM.

Pour les changements de code qui demandent un audit de sécurité plutôt qu'un audit des dépendances, utilisez le template de changement d'authentification.

Questions fréquentes

AI CodeOps génère-t-il le SBOM ?

Non. Générez-le avec votre outil habituel, comme un générateur CycloneDX dans votre build, et enregistrez-le pour le projet. AI CodeOps le suit et vérifie les licences par rapport à lui.

Pourquoi ma livraison a-t-elle été refusée sans aucune violation de licence ?

Avec disallowedLicenses défini, un projet sans SBOM ne peut pas être vérifié ; il est donc refusé et listé dans licenseEvidenceMissing.

L'audit des licences est-il un conseil juridique ?

Non. Les notes de licence de l'agent vous aident à repérer des candidats. C'est votre service juridique qui décide de ce que vous pouvez livrer.