- Inicio
- Plantillas
- Servicio en Python: control de SBOM y licencias
Servicio en Python: control de SBOM y licencias
Última actualización
Audita las dependencias de un servicio en Python con Dependency Refresh en busca de licencias copyleft, registra un SBOM CycloneDX y haz que la CI deniegue versiones con código GPL.
Los problemas de licencias salen más baratos de corregir antes de una publicación que después de la auditoría de un cliente. Esta plantilla hace que los agentes encuentren y sustituyan las dependencias copyleft, y después da a tu CI una comprobación estricta contra el SBOM del proyecto.
Qué agentes se ejecutan
- Audit, a cargo del Dependency Auditor: lee
pyproject.tomly el README y enumera los paquetes con conflictos de licencia, con vulnerabilidades conocidas (según el conocimiento del modelo, no una base de datos en vivo) o sin mantenimiento, cada uno con una vía de actualización. - Upgrade, a cargo del Migration Specialist: el plan de sustitución o eliminación, con notas de rollback.
- Test, a cargo del Tester: si el cambio escrito y su ejecución de pruebas registrada muestran que no se rompió nada, y qué casos siguen faltando.
- Verify secure, a cargo del Security Auditor: comprueba el cambio escrito.
El cambio se escribe después del paso Upgrade y tus pruebas se ejecutan sobre él. Test y Verify secure se ejecutan después, así que leen el diff real y su resultado de pruebas.
El agente solo lee las dependencias directas. Los lockfiles como poetry.lock no se incluyen, así que las licencias transitivas le resultan casi invisibles; eso es lo que cubre la comprobación del SBOM.
Tus pruebas se ejecutan en un sandbox sin conexión. Después del último paso, el cambio pasa por una revisión de hallazgos con la auditoría como contexto (los hallazgos de dependencias aparecen en la página de la ejecución) y por una aprobación humana.
Registra el SBOM
AI CodeOps no genera SBOM. Produce un archivo CycloneDX o SPDX con tus herramientas de build y después regístralo en el proyecto con tu sesión iniciada, a través de /api/sbom; durante la beta abierta no hay formulario de subida ni registro con clave de API. El resumen de licencias en Secure → Security muestra las cadenas de licencia exactas que encontró. Registra un SBOM nuevo después de que se fusione el cambio de dependencias, porque el control lee el más reciente del proyecto.
Controla las publicaciones por licencia
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 coincidencia es exacta y no distingue mayúsculas de minúsculas, así que GPL-3.0 no coincide con GPL-3.0-only. Enumera cada identificador tal como aparece en el resumen de licencias de tu SBOM. Una coincidencia deniega con licenseViolations. Consulta seguridad y SBOM.
Para los cambios de código que necesitan una auditoría de seguridad, no de dependencias, usa la plantilla de cambio de autenticación.
Preguntas frecuentes
¿AI CodeOps genera el SBOM?
No. Genéralo con tu herramienta habitual, como un generador de CycloneDX en tu build, y regístralo en el proyecto. AI CodeOps lo conserva y comprueba las licencias contra él.
¿Por qué se denegó mi publicación sin ninguna infracción de licencia?
Con disallowedLicenses configurado, un proyecto sin SBOM no se puede comprobar, así que se deniega y aparece en licenseEvidenceMissing.
¿La auditoría de licencias es asesoramiento jurídico?
No. Las notas de licencias del agente te ayudan a encontrar candidatos. Tu equipo jurídico decide qué puedes distribuir.
Relacionado
- Revisión de seguridad y seguimiento de SBOM para código escrito por IA
- Seguridad y SBOM
- Auditoría de dependencias
- Cambio de autenticación: análisis de riesgos antes del código, auditoría después
- Plantilla de descripción de pull request para cambios escritos por IA
- Servicio en Python: primero las pruebas, con un mínimo de cobertura en la CI
- Todas las plantillas