Versión 1.0.0-alpha.1 más reciente
Capítulo 2.2
Las ediciones por dentro
Cómo se construyen Community y Enterprise a partir de un mismo producto, cómo una licencia activa grupos de funciones en tiempo de ejecución, qué muestra una instalación Community para una página de Enterprise, y qué significa eso para las imágenes que descarga y las extensiones que desarrolla.
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

Dos líneas en un archivo de valores deciden qué edición ejecuta una instalación:
# harrow-values.yaml (Helm values): the edition of this installation
edition: enterprise
enterprise:
enabled: trueDeben coincidir. Si configura edition: community con enterprise.enabled: true, el chart se detiene con "edition=community but enterprise.enabled=true: they must agree". Si configura edition con cualquier otro valor distinto de community o enterprise, se detiene con NEXUS_EDITION_INVALID. Esos dos valores eligen qué imágenes toma la instalación. Lo que esas imágenes activen después es asunto de la licencia, en tiempo de ejecución, un grupo de funcionalidades a la vez.
Este capítulo desglosa todo eso: qué contienen las ediciones, cómo un producto se convierte en dos compilaciones, cómo una licencia se transforma en un sí o un no dentro de un servicio en ejecución y qué significa eso cuando usted construye algo propio. El capítulo 1.6, Ediciones y licencias en términos sencillos, ofrece la perspectiva del comprador; esta es la del ingeniero.
La matriz de ediciones
Todo lo incluido en este capítulo proviene de un único archivo: la matriz de ediciones. Enumera 97 capacidades y asigna un nivel a cada una. A partir de ella, Adverant genera el catálogo de licencias y las reglas de menú de la consola, junto con el límite entre el código abierto y el cerrado. Cuando la matriz cambia, todo eso cambia en conjunto.
Existen tres ediciones.
| Edición | Licencia | Dónde se ejecuta |
|---|---|---|
| Community | Apache-2.0, código abierto, gratuita | Su propio hardware o la nube de Adverant |
| Team | Licencia Adverant Enterprise | Nube de Adverant: Community más el conjunto Team |
| Enterprise | Licencia Adverant Enterprise, por grupo de funcionalidades | Su propio hardware o la nube de Adverant |
Una instalación ejecuta una de dos: el valor edition del chart solo acepta community y enterprise. Team es una edición en la nube y Enterprise incluye también el conjunto Team, por lo que en su propio hardware las capacidades de Team (el panel de trabajo acoplado junto a cada registro, los cuadernos compartidos, la política de memoria para la organización y el resto) vienen con Enterprise.
Enterprise está estructurada en capas. La base Enterprise es el núcleo cerrado: varias organizaciones y unidades de negocio, aplicación de inicio de sesión único con SAML (Security Assertion Markup Language) y sincronización de directorios, roles personalizados con aprobaciones de cuatro ojos, retención prolongada de auditoría, protección de datos, las páginas del operador y la gestión de clústeres. Sobre la base se sitúan los complementos, cada uno con licencia por separado, y los paquetes de dominio. El primer complemento de la tabla, AI Gateway a escala, distribuye la carga del enrutador de IA (inteligencia artificial) entre réplicas y proveedores.
| Complemento | También requiere |
|---|---|
| Pasarela de IA a escala | Base |
| Fábrica de modelos | Base |
| Ideas | Base |
| Llamadas y voz | Base |
| Correo | Base |
| Otras firmas y murallas | Base |
| Estudio de cuadernos | Base |
| Mapa y GeoAI | Base |
| Conectores de datos | Base |
| Agente a agente | Base |
| Salas de decisiones y registros sellados | Base |
| Operaciones de ingresos | Base |
| escaparate / marca blanca | Base |
| Nexus Edge | Base |
| Aplicaciones móviles | Base |
| Workforce | Base; los agentes en dispositivos en el borde también necesitan Nexus Edge, las aprobaciones en un teléfono también necesitan Aplicaciones móviles |
| Shield | Base |
| Entornos aislados (Sandboxes) | Base |
| Calidad (NexusQA) | Base |
Existen diez paquetes de dominio:
- Seguros
- Banca y pagos
- Mercados de capitales y gestión de activos
- Gobierno y sector público
- Atención sanitaria
- Ciencias de la vida
- Infraestructura crítica y energía
- Defensa y seguridad
- Servicios jurídicos y profesionales
- Logística y sector marítimo
Cada paquete necesita la base Enterprise, y cinco de ellos también necesitan un complemento. El paquete de Seguros necesita Salas de decisión y registros sellados. Lo mismo ocurre con el paquete de Mercados de capitales y gestión de activos. El paquete de Servicios jurídicos y profesionales necesita esos dos más Correo. Logística y sector marítimo necesita Mapas y GeoIA. En el paquete de Defensa y seguridad, las alertas de plataforma también necesitan Nexus Edge. Las pantallas para teléfono de cualquier paquete también necesitan Aplicaciones móviles. El capítulo 1.7, Paquetes de dominio y sectores verticales, indica qué contiene cada uno.
Grupos de funcionalidades
La unidad que nombra una licencia es el grupo de funcionalidades. Hay 32: la base común de Community, el conjunto Team, la base Enterprise, uno por cada complemento y uno por cada paquete. Cada capacidad pertenece exactamente a uno, por lo que una licencia que enumera "Base Enterprise, Mapas y GeoIA, Logística y sector marítimo" indica con precisión qué capacidades puede ejecutar esta instalación.
| Nivel | Capacidades |
|---|---|
| Community | 36 |
| Team | 6 |
| Base Enterprise | 18 |
| Complementos adicionales | 23 |
| Paquetes de dominio | 14 |
Ámbito de concesión
Cada capacidad bajo licencia tiene un ámbito de concesión, que indica a qué se vincula una concesión.
- El ámbito de inquilino cubre las partes en las que trabajan las personas: Ideas, Correo, Operaciones de ingresos, los paquetes. La licencia las pone a disposición de la instalación y luego se activan o desactivan por organización y por unidad de negocio. Una nueva organización nunca hereda un estado de "todo activado".
- El ámbito de despliegue cubre los cinco elementos que pertenecen a la instalación en su conjunto: la importación de licencias con los artefactos que descarga, los formatos de entrega de Enterprise, las páginas del operador, la gestión de clústeres y Nexus Edge.
Las capacidades de Community no tienen ningún ámbito de concesión. No necesitan licencia.
Un administrador puede restringir lo que permite la licencia para una organización o una unidad. Nadie puede ampliarlo desde dentro de la instalación.
Un producto, dos compilaciones
Existe un único código base de Nexus. La compilación Community es su exportación de código abierto, y la compilación Enterprise es esa exportación más los módulos cerrados.
Una lista de límites asigna cada archivo bajo seguimiento a una edición. En su mayor parte, lo hace nombrando la capacidad que implementa un archivo, y la edición del archivo se deriva del nivel de esa capacidad: una capacidad de Community genera un archivo de Community, y cualquier elemento de Team, base, complemento o paquete genera un archivo de Enterprise. Los archivos que no se distribuyen en ninguna de las dos ediciones se enumeran con un motivo. Una regla se aplica por encima de las demás: las migraciones de base de datos de cada módulo se distribuyen en ambas ediciones. Por lo tanto, una base de datos de Community y una base de datos de Enterprise tienen el mismo esquema, y pasar una instalación de una a otra es un cambio en lo que está activado, sin datos que migrar.
La exportación de Community lleva encabezados Apache-2.0 y un archivo NOTICE, y cada paquete en ella tiene licencia Apache-2.0, excepto el código de terceros que conserva su propia licencia (MIT, BSD y otras) y se copia tal cual, y algunos paquetes de kit de desarrollo de software (SDK) e interfaz de línea de comandos (CLI) que conservan su propia licencia MIT. La compilación Enterprise se distribuye bajo la licencia Adverant Enterprise. Sus términos permiten el uso únicamente bajo una licencia por escrito, durante el plazo, los despliegues y los grupos de funcionalidades que dicha licencia nombre. La prohibición de ingeniería inversa mantiene explícitamente los derechos que le otorga la legislación de la UE para estudiar el software y descompilarlo con fines de interoperabilidad.
La línea divisoria de la licencia
El código de Enterprise llega a Community a través de un único paquete: @adverant/nexus-spi, la interfaz de proveedor de servicios (SPI). Tiene licencia Apache-2.0 y contiene interfaces y guardas de tipos, sin lógica de tiempo de ejecución propia.
| Exportación | Qué es |
|---|---|
RouteModule |
Un módulo de ruta con licencia: su identificador, su grupo de funcionalidades, los cuerpos que lee y register(app, ctx) |
SpiApp |
La parte de la aplicación HTTP del host que toca un módulo: use |
SpiContext |
Lo que el host entrega a un módulo: la puerta de producto y la guarda de ámbito, el lector de licencias, el grupo de consultas con ámbito, las direcciones ascendentes, los clientes de plataforma |
SpiRuntime |
Los valores del SDK (kit de desarrollo de software) de complementos que el host entrega a un módulo |
SpiPlane |
Los grupos de pantallas y las lecturas de pantallas que añade un plano con licencia |
ScreenModule |
El grupo de pantallas con licencia de una consola: sus rutas, pantallas y menú |
GrantCheck |
La comprobación que ejecuta un módulo con licencia sobre su propio grupo de funcionalidades |
Una comprobación en la compilación hace cumplir esta línea divisoria. Dentro del código de Enterprise, una importación desde los ámbitos de paquetes de Community (@adverant/ y @adverant-nexus/) hace fallar la compilación a menos que sea @adverant/nexus-spi o un paquete de Enterprise. Lo mismo ocurre con una importación relativa que sale del repositorio, una dependencia file:, link: o workspace: que apunta fuera de él, una URL de Git que nombra un repositorio de Community y un replace de Go que apunta fuera de él. Al otro lado de la línea, el acoplamiento es un protocolo de red o un módulo cargado al inicio, nunca código fuente compartido. La SPI incluso lleva su propia copia fijada de las declaraciones de tipos del SDK de complementos, porque el SDK es un paquete de Community que la línea divisoria no admite; en su lugar, el host entrega a un módulo los valores de tiempo de ejecución del SDK.
Perfiles de compilación
La consola y el BFF (backend para frontend) se compilan con un perfil de compilación, que fija las clases de código dentro de la imagen. El perfil de Community contiene código de Community; el perfil de Enterprise contiene código de Community y de Enterprise. Cada uno se niega a iniciarse cuando su perfil contiene código que la edición de la instalación no incluye. El BFF lo indica con PROFILE_OUTSIDE_EDITION y nombra la imagen que se debe desplegar en su lugar. No se puede poner una consola de Enterprise en una instalación de Community reetiquetando una imagen.
Cómo una licencia activa grupos de funciones
Una licencia es un documento firmado. Adverant firma cada licencia con dos claves independientes, y nada más en la instalación decide qué está bajo licencia. Usted la importa a través de las páginas de Licencias de la consola, con nexusctl licence import <file>, o enviando el documento mediante POST a https://<hosts.auth>/api/v1/installation/licence. Una licencia nunca es un valor del chart ni un archivo montado. El capítulo 2.13, Licencias, abarca la importación y la renovación, así como cada estado por el que pasa una licencia.
La comprobación que importa se ejecuta dentro de cada módulo cerrado, sobre el propio grupo de funcionalidades de ese módulo, antes de que responda. Ese es el contrato GrantCheck de la SPI:
type GrantCheck = (featureGroup: string) => Promise<{ entitled: boolean; code?: "LICENCE_LOCKED" }>;La comprobación reside en el módulo cerrado porque una comprobación escrita en código abierto podría simplemente eliminarse. Una licencia falsificada cuenta como ausencia de licencia. Un módulo cuyo grupo de funcionalidades no esté nombrado en la licencia responde con LICENCE_LOCKED.
Los propios módulos también se comprueban. nexus-keys contiene el manifiesto de partes firmadas de la versión y la clave que lo firmó. Comprueba cada módulo compilado frente a ese manifiesto al iniciarse y de nuevo cada noche a las 03:53 UTC. Un módulo cuya firma no coincide nunca se carga, y la copia firmada a la que habría reemplazado sigue ejecutándose; las páginas del operador lo muestran con MODULE_SIGNATURE_INVALID.
Por encima de la comprobación del módulo se sitúa la capa de visualización, que decide cómo se muestra una capacidad a cada persona. Combina las concesiones de la licencia con el plan de la organización y el rol de la persona, y cada control termina en uno de cuatro estados.
| Estado | Lo que ve la persona |
|---|---|
| Con derecho | El control, mostrado normalmente |
| Avance | El control atenuado en gris con un candado; al abrirlo se explica qué es y quién puede activarlo |
| Oculto | Nada; se utiliza únicamente para elementos cuya existencia no debe conocer el rol de esta persona, como el buzón privado de otra persona |
| Denegado con un código | Un cartel de denegación que indica el código, cuando alguien intenta una acción que no está permitida |
La licencia también tiene sus propios estados a medida que se acerca y supera su fecha de finalización. En todos ellos se cumplen dos reglas: una licencia nunca detiene el trabajo en ejecución y las correcciones de seguridad nunca se retienen.
Qué muestra Community para una página de Enterprise
Una instalación de Community mantiene la forma del producto. El menú tiene las mismas filas que Enterprise, y las de Enterprise (Ideas, Decisiones, Correo, Llamadas, Otras empresas, Agentes, Políticas, Cumplimiento) se muestran atenuadas en gris con un icono de candado. No se oculta nada para hacer que la edición parezca completa, y nada resulta intrusivo.
Al abrir una fila bloqueada se muestra un avance. Para Ideas, dice "Ideas forma parte de Enterprise", seguido de un párrafo sobre lo que hace Ideas y luego "Quién puede activarlo: su administrador, mediante una licencia de Adverant". Ofrece dos botones: "Preguntar a su administrador" y "Ver qué hace". No aparece ningún precio. Al abrir la página no se carga ni se envía nada, y la promoción se muestra una sola vez.
Escribir la dirección de una página exclusiva de Enterprise también lleva a un lugar útil. La consola de Community conoce las direcciones de las páginas que no contiene y envía cualquiera de ellas a su página de edición, dentro del marco normal con el menú. La página muestra el cartel de funcionalidad bloqueada:
LICENCE_LOCKED
This page is part of Nexus Enterprise. This installation runs Nexus Community,
so the page is not here and nothing was read.
- To use it, the installation needs Nexus Enterprise: an administrator can ask Adverant about it
- Every page this installation holds is in the menu
El código está ahí como referencia; las frases son para la persona que lo lee.
La base común
Algunos elementos nunca son de pago, en ninguna edición ni bajo ningún estado de licencia: los aspectos básicos de administración y seguridad, la separación de inquilinos, la exportación de datos, el cierre de sesión y todas las pantallas de denegación. Una instalación de Community cuenta con todos ellos. Una instalación de Enterprise cuya licencia ha finalizado también los conserva: los artefactos de Enterprise dejan de ofrecerse, pero la base común de Community y la exportación de datos permanecen. Siempre puede extraer sus datos.
Imágenes por edición
Cada imagen de una versión se enumera, por su resumen criptográfico (digest), en el bloqueo de imágenes del chart, y el propio bloqueo pertenece a una edición. El chart comprueba cada imagen que procesa frente al bloqueo y frente a la edición solicitada. Una instalación de Community toma únicamente imágenes de Community. Si le pide cualquier otra cosa, se detiene: "a community install takes only community images". Un bloqueo de Enterprise contiene las imágenes de Community más las compilaciones de Enterprise.
Eso es importante para saber desde dónde se descargan las imágenes. Las imágenes de Community son públicas y se encuentran en registry.adverant.ai/nexus/<service>@sha256:…. Las imágenes de Enterprise provienen del mismo registro con un token de descarga, que se obtiene en la página "Tokens de descarga y comandos de instalación" de su cuenta de Adverant. Una instalación de Community nunca necesita ese token y nunca contiene ni un solo byte de código cerrado.
La ruta de actualización conserva la instalación. Cuando un administrador de Community importa una licencia de Enterprise, la consola la lee y la verifica, y luego muestra las partes que descargará (los módulos compilados y los paquetes y complementos que nombra la licencia) con sus tamaños. Cada parte se comprueba frente a la clave de versión de Adverant y los grupos se activan uno a la vez. Las personas y los archivos permanecen tal como están, al igual que los flujos de trabajo y los canales, porque el esquema ya era el mismo. El capítulo 2.7, Instalación de Enterprise y aplicación de una licencia, explica el proceso paso a paso en Kubernetes; los sitios aislados de la red (air-gapped) importan las mismas partes desde medios físicos, tal como describe el capítulo 2.10, Instalación en entornos aislados.
Formatos de entrega y clases de protección
Nexus se distribuye en seis formatos de entrega, que la matriz denomina SKU (unidades de mantenimiento de existencias). Los cinco distintos de Edge comparten un único paquete firmado y difieren en el empaquetado y en cómo llega la licencia.
| SKU | Qué es | Cómo llega la licencia |
|---|---|---|
saas |
Nube de Adverant | Emitida con la suscripción |
onprem-connected |
Helm en su propio Kubernetes | Descargada por la instalación a través de su conexión saliente |
airgap |
El mismo paquete, importado sin conexión | Importada como un archivo, con una declaración de uso firmada una vez al año |
self-serve-image |
Una imagen de máquina en su propia cuenta en la nube | La imagen en sí solo lleva licencias de Community y de evaluación; los módulos de Enterprise llegan una vez que se emite una licencia, incluida una adquirida a través de la tienda de la nube |
appliance |
Hardware construido por un fabricante de equipos originales (OEM), que figura como su fabricante oficial | Una licencia de Enterprise; el dispositivo integrado es uno de sus formatos de entrega |
edge |
Nexus Edge, la carga útil en satélites y drones, o en embarcaciones y vehículos | Una licencia por plataforma o flota, de larga duración, válida mientras está sin conexión |
La protección es la otra mitad de la entrega, y conviene hablar de ello con claridad. Una vez que el código se ejecuta en hardware bajo su control, ninguna técnica lo hace ilegible. Por ello, Adverant clasifica su código en clases de protección y decide, para cada formato de entrega, hasta dónde puede llegar cada clase. Existen cuatro niveles:
| Clase | Qué significa |
|---|---|
| P1, nunca distribuido | La lógica se ejecuta en Adverant; la instalación contiene un cliente firmado. |
| P2, sellado | Una máquina virtual (VM) confidencial en la que usted no puede iniciar sesión, sobre hardware que no puede tocar. |
| P3, código nativo endurecido | Compilado, sin símbolos de depuración y generado por licenciatario. Eleva el coste de leer el código de horas a semanas. |
| P4, legible | JavaScript o TypeScript ordinario, como lo es el código abierto. |
| Clase de protección | Nube de Adverant | En instalaciones propias con conexión | Entorno aislado (air-gap) | Nexus Edge |
|---|---|---|---|---|
| Código abierto (todo Community) | P4 | P4 | P4 | P4 |
| Código del más alto valor: puntuación de ideas, el núcleo del almacén de registros sellados, el motor de políticas de enrutamiento, los cuatro motores de decisión del paquete de Seguros | P1 | P3, o P2 como una VM confidencial sellada por Adverant en su inquilino de la nube | P3 | No distribuido |
| Módulos de servidor cerrados que toman decisiones: código de servidor de paquetes, la pasarela móvil | P1 | P3 | P3 | No distribuido |
| Código de servidor del paquete de Defensa y seguridad | P1 | P3 | P3 | P3 |
| Código de carga útil de Nexus Edge | No distribuido | No distribuido | No distribuido | P3 |
| Definiciones de cliente legibles: aplicaciones para teléfono, pantallas para teléfono de los paquetes | P4 | P4 | P4 | P4 |
De esto se derivan dos consecuencias. No se distribuye nada protegido en una aplicación para teléfono: cada regla e instrucción (prompt) permanece en el servidor. Además, el valor contenido en las instrucciones, rúbricas o cadenas de agentes es legible para quien ejecute el modelo al que se envía. Cuando su organización es propietaria del modelo, ese valor está protegido por el contrato de licencia y nada más. Cada imagen de TypeScript distribuida está empaquetada y minificada sin mapas de código fuente, lo cual responde más al orden que a la protección.
Qué significa esto cuando desarrolla una extensión
Su extensión se sitúa en la misma línea que los propios módulos de Adverant. Casi todo este capítulo se le aplica.
El aislamiento, la identidad y la ruta de IA vienen con la plataforma en ambas ediciones. Un complemento construido con @adverant-nexus/plugin-sdk hereda la barrera de consultas con ámbito, el verificador de tokens y el despacho UNO, independientemente de la edición en la que se instale. El capítulo 2.19, Las reglas que hereda toda extensión, las enumera.
El control de acceso por edición funciona del mismo modo para usted. Un complemento declara sus identificadores de funcionalidad en el bloque entitlements de su manifiesto (featureIdPattern, más una breve lista alwaysOn mantenida para las comprobaciones de estado y la página de configuración) y solicita un veredicto a la plataforma antes de servir una superficie controlada. El veredicto nunca es un simple valor booleano. ENTITLEMENT_DENIED (403) significa que la plataforma respondió que no. ENTITLEMENT_UNREACHABLE (502) significa que no hubo respuesta, y su complemento debe denegar el acceso en lugar de asumirlo, porque una interrupción interpretada como "sin derecho" degrada silenciosamente a todos los clientes a la vez. Almacene en caché un sí brevemente y nunca almacene en caché una denegación.
En Community, un desarrollador obtiene las mismas plantillas iniciales que en Enterprise, tanto para complementos y lentes como para habilidades y flujos de trabajo. Cada desarrollador trabaja en un espacio de desarrollo con ramas de datos en el mismo servidor, y el código reside en GitHub. Las plantillas de paquetes de dominio y de plataforma son exclusivas de Enterprise. También lo es la elevación de acceso por tiempo limitado desde un IDE (entorno de desarrollo integrado): en Community no existe un entorno de producción separado al cual elevar su acceso, y la consola lo indica con PASS_TIER_REQUIRED.
Una extensión que utiliza únicamente puntos de unión de Community se ejecuta en cualquiera de las dos ediciones sin cambios. Una que depende de un complemento, como Correo por ejemplo, se muestra bloqueada allí donde la licencia no nombre ese grupo. El capítulo 2.25, Desarrollo para cada edición, muestra cómo estructurar una extensión para ambas y cómo probarla frente a cada una.



