AI CodeOps

Política de licencias (license policy)

Última actualización

Una política de licencias indica con qué licencias de código abierto se puede entregar tu software. Cómo se aplica y cómo AI CodeOps la comprueba contra el SBOM de un proyecto en la CI.

Una política de licencias es un conjunto de reglas sobre qué licencias de código abierto puede incluir el software que entregas. Normalmente nombra las licencias prohibidas, como las licencias copyleft fuertes en un producto que distribuyes, y a veces las que necesitan antes una revisión jurídica.

Qué es

Cada dependencia de código abierto viene con una licencia, y cada licencia fija condiciones: atribución, compartir el código fuente, concesiones de patentes. Una política de licencias convierte la postura de tu organización sobre esas condiciones en una lista que las herramientas pueden comprobar. Las políticas se suelen escribir con identificadores de licencia de SPDX, como MIT, Apache-2.0 o AGPL-3.0-only, para que no haya dudas sobre a qué licencia se refieren.

Para aplicar una política necesitas saber qué contiene el software, que es lo que registra un SBOM.

Por qué importa

Una sola dependencia transitiva con una licencia incompatible puede crear una obligación que no habías previsto. Comprobar las licencias automáticamente en el momento de publicar sale más barato que descubrir el problema en la auditoría de un cliente. Los agentes de IA lo hacen más urgente: un agente al que se le pide añadir una funcionalidad puede añadir un paquete que nadie ha revisado.

En AI CodeOps

Una política de licencias es una opción de la comprobación de publicación a la que llama tu CI, POST /api/release/check. Pasa las licencias que no permites en disallowedLicenses:

curl -s -X POST "https://console.aicodeops.dev/api/release/check" \
  -H "Authorization: Bearer $WORKSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pullRequestURL":"https://github.com/acme/checkout/pull/42","disallowedLicenses":["GPL-3.0","GPL-3.0-only","AGPL-3.0","AGPL-3.0-only"]}'

Para cada proyecto que tocó el cambio, AI CodeOps lee el resumen de licencias del último SBOM y deniega la publicación si una licencia no permitida tiene al menos un componente. Los motivos se leen así:

Disallowed license "GPL-3.0-only" in checkout (2 components)
No SBOM recorded for checkout, so its licenses can't be checked

Los detalles vuelven en licenseViolations, por ejemplo [{ "projectID": "checkout", "license": "GPL-3.0-only", "count": 2 }].

Conviene saber:

  • Sin SBOM, no se supera. Con una regla de licencias definida, un proyecto sin SBOM registrado se deniega.
  • Identificadores exactos. La comparación ignora las mayúsculas, pero por lo demás es exacta. La lista de SPDX declaró obsoleto GPL-3.0 en favor de GPL-3.0-only y GPL-3.0-or-later, y cada generador escribe una u otra forma, así que incluye cada forma que quieras prohibir.
  • Proyecto, no commit. La comprobación lee el SBOM actual del proyecto. Registra uno nuevo cuando cambien las dependencias.
  • Solo por API. El control de calidad por sesión no comprueba licencias, y la página Review & Gate → Release gate no tiene ningún campo de licencias. Fija la regla en la llamada a la API.

Las opciones completas están en la página de la API.

Preguntas frecuentes

¿Qué pasa si un proyecto no tiene SBOM y fijo una política de licencias?

La comprobación de publicación lo deniega. Un proyecto sin SBOM no se puede comprobar, y la falta de evidencia no equivale a superar el control.

¿La comprobación mira las licencias de cada commit?

No. Lee el último SBOM registrado del proyecto, así que somete a control las dependencias actuales del proyecto, no las de cada commit.

¿La comparación de licencias distingue mayúsculas y minúsculas?

No. Es una coincidencia exacta que ignora las mayúsculas, así que GPL-3.0 y gpl-3.0 coinciden, pero GPL-3.0 y GPL-3.0-only no.