Iniciar sesiónReservar sesión

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

17 minutos de lectura

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: true

Deben 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.

Una pila vertical de seis bandas. Desde abajo: "Base común (todas las ediciones, nunca de pago)"; "Community, Apache-2.0"; una línea doble gruesa etiquetada como "@adverant/nexus-spi, la única interfaz compartida"; "Base Enterprise, módulos cerrados"; "Complementos (19), cada uno con licencia por separado"; "Paquetes de dominio (10)". A la derecha, un recuadro "Documento de licencia firmado" con una flecha hacia las tres bandas superiores etiquetada como "comprobado dentro de cada módulo cerrado". A la izquierda de la banda Community, una nota "Imágenes de Community: solo código abierto".
Las ediciones como capas, con el documento de licencia como única autoridad.

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.

A la izquierda, un recuadro "Código fuente de Nexus" con un recuadro más pequeño dentro, "matriz de ediciones". Una flecha etiquetada como "lista de límites" se divide en dos. La flecha superior va hacia "Exportación de Community (Apache-2.0)" y continúa hacia "Imágenes de Community". La flecha inferior va hacia "Compilación de Enterprise", que también recibe una flecha de la exportación de Community y otra de un recuadro "módulos cerrados", y produce "Imágenes de Enterprise". Entre los módulos cerrados y la exportación de Community, una barrera etiquetada como "línea divisoria de la licencia: solo @adverant/nexus-spi". Una pequeña nota debajo de ambos recuadros de imágenes dice "mismo esquema de base de datos".
Cómo un árbol de código fuente se convierte en dos ediciones.

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.

Partes compiladas
Partes compiladas
La página de partes compiladas enumera cada módulo bajo licencia con su grupo de funcionalidades, versión y comprobación de firma. Una copia modificada que no superó su comprobación aparece como un cartel de denegación, y la copia firmada siguió ejecutándose.

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.

Algo que no tiene
Algo que no tiene
Un área bloqueada en Community indica quién puede activarla y qué le ofrece ya Community. La fila permanece en el menú, atenuada en gris con un candado, para que el producto tenga el mismo aspecto en ambas ediciones.

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.

De Community a Enterprise
De Community a Enterprise
Al importar una licencia en una instalación de Community se muestra qué se descargará, qué cambia y qué se conserva, antes de que ocurra nada. El botón dice "Descargar y activar", y no se descarga nada hasta que se pulsa.

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.

Desarrollo en Community
Desarrollo en Community
El desarrollo en Community ofrece las mismas plantillas que Enterprise en un único servidor, con el código en GitHub. La página indica qué añade Enterprise y deniega el acceso elevado explicando el motivo con claridad.

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.