Versión 1.0.0-alpha.1 más reciente
Capítulo 2.13
Licencias
Qué contiene un archivo de licencia de Nexus, cómo lo comprueba la instalación sin conexión, los seis estados en los que puede encontrarse y cómo solicitar, importar, renovar y retirar una.
Esta página fue traducida por IA a partir del original en inglés. Si algo no está claro, la página en inglés es la referencia. Leer esta página en inglés

Harrow Port Authority ejecuta Nexus Enterprise en su propio clúster de Kubernetes en harrow.example, sin ruta desde el clúster hacia Internet. Cada año, Aoife Brennan, directora de TI, renueva el contrato, y Tomás Reilly, el ingeniero de plataforma, transporta un pequeño archivo JSON a través del aislamiento e importa su contenido. Nada se reinicia y la página de la licencia muestra una nueva fecha de finalización.
Este capítulo trata sobre ese archivo. En resumen, una licencia es un único documento JSON firmado y vinculado a una instalación. La instalación lo comprueba por sí misma, con claves públicas integradas en la imagen, y no realiza ninguna llamada de red para hacerlo. Una licencia nunca es un valor de Helm ni un archivo montado. Se importa a través de la consola, nexusctl o la interfaz de programación de aplicaciones (API), y desde ningún otro lugar.
El documento de licencia
Una licencia es un objeto JSON con el formato nexus-licence/v1. Aquí está la de Harrow, con los dos valores de firma abreviados.
{
"format": "nexus-licence/v1",
"licence_id": "8c1e4f2a-6b0d-4e7a-9f31-2d5c7a9e0b14",
"issued_at": "2026-12-14T10:20:00Z",
"type": "alpha",
"channel": "alpha",
"licensee": { "name": "Harrow Port Authority", "customer_id": "harrow-port-authority" },
"scope": {
"deployment": { "installation_id": "4b7d2e90-1c5a-4f8e-a3d6-7e0b9c2f5a18" },
"tenants": []
},
"edition": "enterprise",
"grants": [
{ "feature_group": "enterprise-base", "scope": "deployment" },
{ "feature_group": "map-and-geoai", "scope": "deployment" }
],
"add_ons": ["mail"],
"domain_packs": ["logistics-and-maritime"],
"metric": { "kind": "per-environment", "quantity": 1 },
"term": { "starts_on": "2027-01-01", "ends_on": "2027-12-31", "warn_days": 30, "grace_days": 30 },
"matrix": { "version": 1, "sha256": "<64 lower-case hexadecimal characters>" },
"signatures": {
"ed25519": { "key_id": "licence-ed-2026a", "sig": "<86 characters>" },
"p256": { "key_id": "licence-p256-2026a", "sig": "<86 characters>" }
}
}Todos los campos son obligatorios y todos los objetos del documento son cerrados. Cualquier miembro no incluido en el formato es rechazado, de modo que nada puede añadirse fuera de la firma.
| Campo | Qué contiene |
|---|---|
format |
Exactamente nexus-licence/v1. Cualquier otro valor, incluida una versión posterior, es rechazado. |
licence_id |
Un UUID (identificador único universal) en minúsculas. Una instalación importa cada identificador de licencia una sola vez. |
issued_at |
El instante en que Adverant la emitió, como YYYY-MM-DDThh:mm:ssZ. |
type |
alpha, evaluation o commercial. |
channel |
El canal de lanzamiento para el que se emitió, como alpha. Se firma y se incluye en el documento; la comprobación no se ramifica en función de este valor. |
licensee.name |
De 1 a 200 caracteres, firmado exactamente como está escrito. Brennan y Brennán son dos nombres diferentes con dos firmas diferentes. |
licensee.customer_id |
Su identificador de cliente en Adverant: minúsculas, dígitos, ., _ y -. |
scope.deployment.installation_id |
La identidad de la instalación, acuñada por su servicio de claves en la primera instalación. |
scope.tenants |
Identificadores de organización, hasta 1,000. Vacío a menos que alguna concesión tenga ámbito de inquilino. |
edition |
enterprise o team. Una licencia Enterprise siempre concede enterprise-base. |
grants |
De 1 a 500 pares {feature_group, scope}, con cada grupo nombrado una sola vez. |
add_ons |
Identificadores de complementos de la matriz de ediciones, hasta 100. Puede estar vacío. |
domain_packs |
Identificadores de paquetes de dominio de la matriz de ediciones, hasta 100. Puede estar vacío. |
metric |
kind es per-environment, per-core o named-seat; quantity es un número entero a partir de 1. |
term |
starts_on y ends_on son fechas; warn_days y grace_days son números enteros de 0 a 365. |
matrix |
La versión de la matriz de ediciones respecto a la cual se redactan los grupos y el hash SHA-256 de ese archivo de matriz, conservados para auditoría. |
signatures |
Dos firmas, ed25519 y p256. El único campo que no está firmado. |
Las fechas son fechas naturales en UTC y el día debe existir: 2028-02-29 es válido y 2027-02-29 es rechazado.
Dos firmas, ambas obligatorias
Adverant firma cada licencia con dos claves independientes. Una firma es Ed25519. La otra es ECDSA (Algoritmo de Firma Digital de Curva Elíptica) en la curva P-256 del NIST (el Instituto Nacional de Estándares y Tecnología de EE. UU.), solicitada por los compradores que requieren algoritmos federales estadounidenses. Ambas se generan sobre los mismos bytes y ambas deben verificarse. Un documento al que le falte una mitad, o que tenga cualquiera de las mitades incorrecta, equivale a no tener ninguna licencia.
Los bytes firmados corresponden a la forma canónica RFC 8785 del documento tras extraer signatures, por lo que los espacios en blanco y el orden de los miembros en su archivo no influyen. Un solo carácter modificado en el nombre del licenciatario, las fechas o una concesión constituye un documento diferente y provoca un fallo.
Las claves públicas que utiliza la comprobación residen en un archivo de raíces de confianza integrado en cada imagen durante la compilación del lanzamiento. Ninguna variable de entorno, indicador o montaje puede designar otro archivo. Cuando Adverant reemplaza una clave de firma, la clave antigua firma la nueva y el siguiente lanzamiento firmado incluye la nueva clave. Una licencia firmada con una clave nueva se verifica en un lanzamiento que la incluya, por lo que después de un cambio de clave es posible que deba actualizar el sistema antes de importar (consulte el capítulo 2.17, Resolución de problemas).
Tipos, ediciones y cómo se contabiliza una licencia
El campo type indica de qué tipo de acuerdo proviene la licencia:
alpha: una licencia para el canal de lanzamiento alfa, que es el tipo que posee Harrow.evaluation: una prueba autoalojada de Enterprise. Funciona durante un máximo de 30 días, para un máximo de 5 personas nominales (métricanamed-seat), congrace_daysestablecido en 0. El formato rechaza cualquier evaluación que tenga algún periodo de gracia.commercial: una licencia bajo contrato.
El campo metric registra cómo se contabiliza la licencia: per-environment (el clúster de producción de Harrow es un entorno), per-core o named-seat. Adverant cotiza el precio; la licencia solo incluye la unidad de medida y la cantidad.
El campo edition de la licencia es enterprise para cada instalación Enterprise. El formato también acepta team, donde la licencia concede el grupo team y nunca enterprise-base.
Grupos de funciones, complementos y paquetes de dominio
Lo que una licencia permite utilizar a los usuarios se enumera por grupo de funcionalidades, utilizando los identificadores de la matriz de ediciones. La licencia de Harrow concede enterprise-base (roles personalizados, aprobaciones de cuatro ojos, retención prolongada de auditoría, inicio de sesión corporativo con aplicación obligatoria y sincronización de directorios, unidades de negocio, las páginas de operador y el resto de la base Enterprise) y map-and-geoai. Incluye el complemento mail y el paquete de dominio logistics-and-maritime.
La matriz tiene reglas sobre qué elementos van juntos, y el sistema de emisión de Adverant las comprueba antes de firmar una licencia. Cada complemento y cada paquete necesita enterprise-base. Algunos paquetes necesitan complementos: el paquete de Logística y marítimo necesita Map y GeoAI; el paquete de Seguros y el paquete de Mercados de capitales y gestión de activos necesitan Decision rooms y registros sellados; y el paquete de Servicios jurídicos y profesionales necesita Decision rooms y Mail. Las pantallas para teléfono de cada paquete también necesitan el complemento de aplicaciones móviles (Mobile apps).
Cada concesión tiene un ámbito:
deployment: el grupo se aplica a toda la instalación, para todas las organizaciones que residen en ella.tenant: el grupo se aplica únicamente a las organizaciones enumeradas enscope.tenants. Una licencia con una concesión con ámbito de inquilino debe enumerar al menos una organización, y se rechaza una lista de organizaciones sin ninguna concesión con ámbito de inquilino.
Supongamos que el equipo de practicaje de Harrow operara como una segunda organización en la misma instalación y que solo esa organización debiera disponer de Ideas. La concesión indicaría { "feature_group": "ideas", "scope": "tenant" }, con el identificador de la organización de practicaje en scope.tenants. Si la licencia se importara antes de que existiera dicha organización, la respuesta de importación la contabilizaría en tenants_without_organisation y la concesión se le aplicaría una vez creada la organización.
Un administrador puede restringir el alcance de un grupo. Solo una licencia de Adverant puede añadir un grupo.
El plazo: advertencia y periodo de gracia
El objeto term establece cuatro fechas en el calendario. Desde starts_on hasta ends_on, la licencia está en vigor. warn_days establece con cuánta antelación comienza la advertencia y grace_days cuánto tiempo sigue funcionando todo después de la finalización. Las licencias que emite Adverant incluyen 30 días para cada uno de estos periodos, a menos que el contrato indique lo contrario. Una evaluación siempre tiene grace_days establecido en 0.
Para la licencia de Harrow anterior, el calendario funciona de la siguiente manera:
| Fechas | Estado |
|---|---|
| 1 de enero de 2027 al 1 de diciembre de 2027 | VALID |
| 2 de diciembre de 2027 al 31 de diciembre de 2027 | WARN |
| 1 de enero de 2028 al 30 de enero de 2028 | GRACE |
| Desde el 31 de enero de 2028 | RESTRICT |
El último día del plazo, ends_on, sigue siendo un día WARN. El día siguiente pasa a ser GRACE, o RESTRICT cuando no hay periodo de gracia.
Los seis estados
Cada vez que se lee la licencia, la instalación vuelve a calcular su estado a partir del documento y de la fecha actual. No se almacena nada en caché más allá del cambio de día, por lo que el vencimiento se produce puntualmente sin necesidad de una tarea programada.
| Estado | Cuándo | Lo que los usuarios pueden hacer |
|---|---|---|
| ABSENT | No se ha importado ninguna licencia o el documento fue rechazado | La base Community. Las áreas Enterprise se muestran como adelantos indicando quién puede activarlas. |
| VALID | De starts_on a ends_on menos warn_days |
Todos los grupos concedidos están habilitados. |
| WARN | Los últimos warn_days días del plazo |
Habilitado, y los administradores ven un aviso dentro del producto con la fecha de finalización. |
| GRACE | Después de ends_on, durante grace_days días |
Habilitado, con el aviso LICENCE_IN_GRACE en Today y en la página de la licencia. |
| RESTRICT | Después del periodo de gracia | No se puede iniciar ningún trabajo nuevo bajo un grupo con licencia. El trabajo en curso finaliza, las lecturas y exportaciones siguen funcionando y las correcciones de seguridad siguen llegando. |
| TERMINATE | Adverant revocó la licencia | Los artefactos Enterprise dejan de ofrecerse. Se mantienen la base Community y la exportación de datos. |
En todos los estados, el trabajo en curso sigue ejecutándose, las correcciones de seguridad siguen llegando, las exportaciones siguen siendo legibles y no se elimina nada. En RESTRICT, una persona que intenta iniciar un nuevo trabajo Enterprise ve una placa de rechazo con el código LICENCE_LOCKED y el nombre de quien puede renovar la licencia.
Cómo se calcula la fecha actual
Un reloj puede estar equivocado y también puede atrasarse a propósito. Por eso, la instalación nunca lee únicamente el reloj. La fecha actual es el más reciente de dos instantes: el reloj del sistema y un límite mínimo almacenado, que es el último instante que la instalación ha registrado. Este límite mínimo avanza con cada importación y cada lectura de estado, y nunca retrocede por sí solo. Atrasar el reloj un mes no devuelve una licencia vencida al estado VALID; una licencia en RESTRICT permanece en RESTRICT.
Cuando el reloj marca una hora anterior al límite mínimo, el estado incluye el aviso LICENCE_CLOCK_BEHIND_FLOOR y se lee con la fecha de dicho límite. Si el reloj realmente se adelantó (por ejemplo, si un nodo arrancó con la fecha incorrecta y el límite mínimo avanzó), solicite a Adverant un token de restablecimiento de hora. Es un pequeño documento firmado y vinculado a su identificador de instalación y a un nonce de un solo uso, con un instante floor_to. Puede importarlo a través de la API con esta solicitud:
curl --fail-with-body -X POST https://auth.harrow.example/api/v1/installation/licence/time-reset \
-H "Authorization: Bearer <access-token>" \
-H "Content-Type: application/json" \
--data-binary @harrow-time-reset.json<access-token> es el token de acceso de un administrador de la instalación. Un token se aplica cuando ambas firmas se verifican, su identificador de instalación coincide con el suyo y su nonce no ha sido utilizado. Un token rechazado no modifica nada, por lo que nunca puede utilizarse para invalidar una licencia válida. Un token cuyo nonce ya fue utilizado es rechazado con LICENCE_CLOCK_BEHIND_FLOOR.
Solicitar una licencia
Las licencias se solicitan y descargan desde su cuenta de Adverant en https://account.adverant.ai. En la página Organisation and team roles de la cuenta se establece quién dentro de su organización puede reclamar despliegues y descargar licencias.
Adverant necesita saber para qué instalación es la licencia, y existen tres formas de indicárselo.
Un código de un solo uso, para una instalación con pantalla. La instalación muestra un código de un solo uso y su huella digital. En la página Claim a deployment, usted pega el código y luego compara la huella digital grupo por grupo con lo que muestra la instalación. Cuando todos los grupos coinciden, la reclama para su organización y la licencia llega a la cuenta.
Una clave de reclamación, para un dispositivo dedicado (appliance) o un dispositivo de borde (edge). Estos equipos no tienen pantalla para mostrar un código. El número de serie y una clave de reclamación están impresos en la caja y en el pedido del fabricante del equipo. Introdúzcalos en la página Enter a claim key de uno en uno, o arrastre el archivo de pedido del fabricante para reclamar varios a la vez. Cada clave se comprueba con el registro de Adverant de lo que se le envió, y se rechaza cualquier clave perteneciente al pedido de otra persona.
Una solicitud de licencia firmada, para una instalación sin conexión con el exterior. Esta es la vía que utiliza Harrow. En la instalación, un administrador genera un archivo de solicitud en This installation, Licence. Es una declaración de tipo licence-request que nombra el identificador de la instalación, firmada con la propia clave Ed25519 de la instalación. Tomás la extrae en un medio aprobado, la deposita en la página Offline exchange y descarga el archivo de licencia devuelto. La licencia funciona únicamente en la instalación que generó la solicitud.
Importar una licencia
Existen tres vías de entrada y todas llegan al mismo punto de conexión en nexus-auth. Solo un administrador de la instalación puede importar: un propietario o administrador de toda la organización propietaria de la instalación que haya iniciado sesión en ella, o un administrador completo de la plataforma. Cualquier otra persona es rechazada antes de que se lea el archivo.
En la consola
En una instalación nueva, Import the licence es una de las seis comprobaciones de Six things before anyone signs in. Cuando deposita el archivo en la página, la consola lo comprueba en la instalación, sin conexión, y enumera sus grupos de funcionalidades indicando cómo está protegido cada uno y el plazo de validez.
Las importaciones posteriores se realizan a través de This installation, Licence: utilice Import a new licence, o Import a renewed licence cuando la actual haya vencido. Una instalación Community que pasa a Enterprise utiliza From Community to Enterprise. Esa página lee primero la licencia y muestra qué se descargará y qué cambiará, antes de que ocurra nada. No se descarga nada hasta que alguien selecciona Fetch and switch on. A continuación, los componentes Enterprise se obtienen de registry.adverant.ai con el token de extracción de la instalación, cada uno se comprueba con la clave de lanzamiento de Adverant y los grupos se activan de uno en uno. Después sigue siendo la misma instalación, con las mismas personas, archivos, flujos de trabajo y canales.
Con nexusctl
nexusctl licence import harrow-2027.licence.jsonEl comando importa el archivo sin modificaciones e imprime el estado actual de la licencia. Añada --explain para imprimir las operaciones que ejecutaría sin llegar a ejecutarlas.
A través de la API
curl --fail-with-body -X POST https://auth.harrow.example/api/v1/installation/licence \
-H "Authorization: Bearer <access-token>" \
-H "Content-Type: application/json" \
--data-binary @harrow-2027.licence.jsonEnvíe el archivo exactamente como Adverant se lo entregó. No cambie su formato ni lo envuelva en otro objeto: el cuerpo de la solicitud es el documento. La ruta no admite ninguna cadena de consulta y se rechaza cualquier cuerpo de más de 1 MiB. Un miembro de nivel superior que nombre una organización o una persona es rechazado con TENANT_NOT_A_PARAMETER o ACTOR_NOT_A_PARAMETER, porque la licencia de la instalación pertenece a la instalación que posee la organización del token.
Una importación correcta responde 201. El cuerpo contiene la vista de la licencia (su identificador, su estado actual, el licenciatario, la edición, el plazo, las concesiones y los grupos de funcionalidades), cuántas organizaciones la poseen ahora y cuántos inquilinos enumerados aún no tienen una organización. La licencia, su resumen SHA-256 y las filas del libro mayor para cada organización se escriben en una única transacción, y la importación se registra en el registro de auditoría.
La acompañan dos rutas de lectura:
GET /api/v1/installation/licence/statedevuelve el estado, recalculado en cada lectura. Un administrador obtiene la vista completa. Cualquier otro miembro de una organización en la instalación obtiene únicamente el aviso: el estado, el código de aviso (LICENCE_ENDS_SOON,LICENCE_IN_GRACEoLICENCE_CLOCK_BEHIND_FLOOR) y las fechas que menciona el aviso. Un miembro nunca ve el licenciatario, el plazo ni los grupos, ya que esos datos pertenecen al propietario de la instalación.GET /api/v1/installation/licence/documentdevuelve el documento importado, sin procesar, para los administradores. Cada módulo Enterprise lo obtiene y vuelve a comprobar las firmas con su propio verificador compilado internamente, de modo que un servicio de identidad modificado no puede activar un grupo que la licencia no concede.
Todos los rechazos
Una importación rechazada no modifica nada, ni siquiera el límite mínimo del reloj, y el rechazo queda registrado en el registro de auditoría.
| Código | HTTP | Significado | Qué hacer |
|---|---|---|---|
LICENCE_FORMAT_INVALID |
422 | El archivo no es una licencia que esta compilación pueda leer: no es JSON, no cumple con el esquema, las fechas están desordenadas o un grupo aparece nombrado dos veces. | Envíe el archivo exactamente como Adverant se lo entregó. |
LICENCE_SIGNATURE_INVALID |
422 | Falta una de las dos firmas o el archivo fue modificado después de su firma. | Solicite de nuevo el archivo a Adverant y no lo edite. |
LICENCE_ROOT_UNKNOWN |
422 | Está firmado con una clave que las raíces de confianza de este lanzamiento no contienen. | Solicite una licencia firmada para las raíces de este lanzamiento o actualice el sistema. |
LICENCE_MATRIX_MISMATCH |
422 | Está redactada respecto a una matriz de ediciones que esta compilación no lee, o concede un grupo que el catálogo de la compilación desconoce. | Actualice a un lanzamiento que la lea o solicite una licencia redactada para este lanzamiento. |
LICENCE_OTHER_INSTALLATION |
409 | Fue emitida para otro identificador de instalación. | Solicite una licencia para la identidad de esta instalación. |
LICENCE_REVOKED |
403 | Adverant ha retirado esta licencia. | Solicite a Adverant una nueva licencia. |
LICENCE_LOCKED |
403 | La licencia no ha comenzado: la fecha actual es anterior a starts_on. |
Vuelva a importarla a partir de su primer día de validez. |
TRANSITION_NOT_PERMITTED |
409 | Ya se importó una licencia con este identificador. | Solicite a Adverant una nueva licencia si es necesario modificar las condiciones. |
RECORD_NOT_FOUND |
404 | La instalación aún no ha sido declarada, por lo que no tiene identidad con la cual realizar la comprobación. | Finalice el primer paso de administrador y luego realice la importación. |
VALIDATION_FAILED |
400 | No se pudo leer el cuerpo, supera 1 MiB o la solicitud contenía una cadena de consulta. | Envíe únicamente el archivo como cuerpo, sin consulta. |
La instalación realiza las comprobaciones en un orden fijo y el primer fallo determina el código. La falta de una mitad se notifica antes que una clave desconocida, y un documento cuyas firmas fallan no se sigue leyendo, de modo que un archivo manipulado que además nombre a otra instalación seguirá respondiendo LICENCE_SIGNATURE_INVALID.
Renovación
Una renovación es una licencia nueva con un nuevo licence_id. Impórtela del mismo modo que la primera. Entra en vigor de inmediato, independientemente del estado que hubiera alcanzado la anterior: desde WARN, GRACE o RESTRICT, la instalación vuelve directamente al estado con licencia sin necesidad de reinstalar nada. Adverant también puede emitir una licencia modificada a mitad de plazo, por ejemplo para añadir Decision rooms, y usted la importa de la misma manera.
La importación de la misma licencia dos veces es rechazada con TRANSITION_NOT_PERMITTED.
Revocación
Adverant retira una licencia firmando una lista de revocación. La lista tiene un número sequence e incluye cada identificador de licencia retirado indicando cuándo y por qué. Las listas son acumulativas: cada una contiene todos los identificadores revocados con anterioridad. Se importa del mismo modo que una licencia:
curl --fail-with-body -X POST https://auth.harrow.example/api/v1/installation/licence/revocations \
-H "Authorization: Bearer <access-token>" \
-H "Content-Type: application/json" \
--data-binary @revocations-12.jsonUna lista cuya secuencia no sea superior a la última importada es rechazada con TRANSITION_NOT_PERMITTED, de modo que no se puede volver a colocar una lista antigua en lugar de una más reciente. Una lista que no se pueda leer o que no se verifique es rechazada con los mismos códigos que una licencia. Una vez que una lista incluye su licencia, el estado de esta pasa a ser TERMINATE.
Una instalación sin conexión con el exterior solo tiene conocimiento de una revocación cuando alguien importa la lista. Para Harrow, la revocación es tanto una cuestión contractual como de software, y Tomás importa cada lista que Adverant envía en el siguiente traslado de archivos.
Puestos por encima de la licencia
La cantidad indicada en la licencia es un compromiso de uso, y Nexus trata el hecho de superarla como una advertencia, nunca como un bloqueo. Cuando utilizan Nexus más personas de las que cubre la licencia, los administradores ven la placa SEATS_OVER_LICENCE en la página People. Todo el mundo sigue trabajando. La placa indica el plazo para corregirlo (30 días), muestra de dónde provienen las personas adicionales y ofrece las dos soluciones: eliminar a las personas que no necesitan Nexus o solicitar más puestos a Adverant. Añadir puestos es un cambio sensible que requiere una segunda persona, y los puestos adicionales se contabilizan en la declaración de uso anual.
La declaración de uso contiene únicamente contadores, y usted puede leer cada línea antes de que salga del sistema. Harrow la guarda como un archivo y la extrae a través del intercambio sin conexión.
Evaluaciones
Una evaluación es una licencia de tipo evaluation, iniciada desde la página Trials de la cuenta para un despliegue reclamado. Dura como máximo 30 días, cubre hasta 5 personas nominales y no tiene periodo de gracia. El día posterior a ends_on pasa directamente a RESTRICT: las áreas Enterprise vuelven a mostrarse como adelantos y no se elimina nada de lo creado durante la evaluación. Las ejecuciones de Ideas, los borradores de políticas y las reglas de correo se conservan exactamente como estaban, y vuelven a abrirse una vez que se importa una licencia.
Una organización ejecuta una única evaluación autoalojada a la vez.




