TECHNICAL ARCHITECTURE / SECURITY
Las cinco capas Artiplane: microservicios, Control Plane, integraciones, identidad, orquestación IA y seguridad enterprise.
Especificación de arquitectura enterprise Artiplane · 11 de octubre de 2026. Define responsabilidades y contratos del producto; servicios activados, integraciones, SLA y controles aplicados se documentan por instalación. No es una acreditación de certificación.
01 · ALCANCE Y DESPLIEGUE
Ocra Group identifica Azure como entorno enterprise y el despliegue privado como opción de producto. Servicios, datos, identidad, conectores y operación se definen por instalación.
La especificación separa entrada API, servicios Control Plane, workers, bus de eventos, base transaccional, índice y almacenamiento de objetos. Un perfil Azure puede usar API Management, AKS o Container Apps, Service Bus, bases gestionadas, búsqueda y Blob Storage. Región, SKU, aislamiento, disponibilidad y dependencias constan en el expediente, sin presumir activación. Control Plane y runtime tienen límites de autorización distintos.
El perfil privado conserva contratos aplicativos con servicios compatibles de containers, base, cola, índice, almacenamiento, IdP y secretos. Artefactos versionados, configuración separada de secretos, migraciones y restauración controladas delimitan el release. Conectores usan VPN/red privada autorizada o integration worker dedicado, sin exponer públicamente el ERP. Compatibilidad y responsabilidades se validan por entorno.
Instalación privada no implica inferencia local. Claude, OpenAI y Bedrock solo se habilitan según clasificación y contrato del cliente. Aislamiento completo exige modelos/dependencias locales aprobados o bloqueo de llamadas externas. Endpoints privados reducen exposición de red, no determinan por sí solos ubicación ni condiciones del tratamiento.
02 · CINCO CAPAS
Una capa puede contener varios servicios; un módulo no es necesariamente un microservicio independiente.
Ingiere contenidos/registros autorizados con claves/versiones, ACL, clasificación y fechas. Parsing, indexación y recuperación separados; el modelo recibe evidencias filtradas por identidad y finalidad antes de generar.
Vincula SKU, colección, pedido, devolución, tienda y mercado a campos aplicativos. Versiona mapping, unidades, monedas, KPI y linaje. Un binding semántico describe datos pero no concede acceso.
Process Engine modela procesos, roles, dependencias y aprobaciones. El Orchestrator descompone objetivos acotados en misiones/tareas del Process Engine, selecciona capacidades/workflows registrados y solicita aprobación humana. El modelo no posee credenciales ni se asigna autoridad.
La orquestación conecta IA, workflows y aplicaciones. Adaptadores separan protocolo, identidad técnica, mapping y operaciones permitidas. REST/OData, webhooks y middleware dependen del sistema real. Escrituras requieren autorización, versión y conciliación.
Chat, Admin y Worker App muestran estados, propuestas y decisiones. Ocultar botones no protege API: el servidor revalida identidad, tenant, objeto y operación en solicitudes sensibles.
03 · COMUNICACIÓN
Solicitud → política → evidencia → propuesta → aprobación → comando → verificación. No toda solicitud atraviesa todas las capas.
Versionar JSON Schema, errores, plazos y límites. Envelope: correlationId, tenantId, subjectId, operation, purpose, schemaVersion, deadline. Identidad derivada de sesión verificada, no tenantId arbitrario del navegador. Los IDs de trazabilidad no son tokens.
eventId, aggregateId, sourceVersion y occurredAt; consumidores idempotentes, duplicados/fuera de orden, outbox transaccional si necesaria y dead-letter con replay autorizado. Sin promesa exactly-once extremo a extremo: conciliar efectos en el sistema de registro.
Reintentos acotados solo para lecturas u operaciones documentadas idempotentes; respetar Retry-After, deadline y circuit breaker. Consultar estado antes de repetir escritura incierta. Sagas con compensaciones explícitas; acciones irreversibles requieren excepciones.
04 · APLICACIONES ADMIN
El catálogo Admin registra capacidades, aplicaciones, entornos, objetos, operaciones y owner. Configurar una capacidad no equivale a activarla operativamente.
Cada capacidad vincula applicationId, connectionId, entorno, API, objeto vendor, clave, campo, transformación y semanticObjectId. Read/propose/write son distintos; propose no concede write. SAP depende de REST/OData o middleware soportado por edición; Salesforce de scopes OAuth y permisos objeto/campo; Centric de interfaces y condiciones confirmadas por vendor. Catálogo no implica licencia, certificación ni conexión activa.
Endpoints, scopes y referencias a secretos quedan en registro servidor, fuera del navegador. Integration worker valida destino, TLS, schema y derechos. Activación requiere pruebas lectura/ACL, owner y fecha; expiración, drift de schema o verificación caducada suspenden capacidades afectadas. Endpoint disponible no demuestra escritura correcta.
Valor directo: aplicación, objeto/campo, clave, versión y extractedAt. Derivado: entradas y fórmula/transformación versionada. IA: runId, agente, workflow, proveedor/modelo y evidencias. Restricciones desde políticas aplicadas, no filtros visuales. Pruebas: schema, paginación, delta, duplicados, denegación ACL y totales conciliados.
05 · IDENTIDAD Y PERMISOS
Identidad de usuario, servicio y permiso de objeto son distintos.
SSO con IdP cliente: OIDC Authorization Code/PKCE, validar issuer, audience, firma, expiración, state y nonce cuando corresponda; SAML según perfil configurado. MFA/Conditional Access son políticas IdP. Provisioning vincula identidad estable, tenant y roles administrados; SCIM opcional gestiona ciclo de vida sin convertir atributos editables del usuario en privilegios.
Funciones centrales, Country, marcas, mercados y membresías múltiples describen organización, no conceden por sí solos acceso. Permiso efectivo intersecta rol fiable, tenant, ámbito autorizado, proceso, clasificación, scopes y ACL fuente. Denegación por defecto en servidor/base/índices/retrieval. Orquestadores no amplían autoridad; Admin actúa dentro de sus delegaciones.
Sesiones con expiración/revocación; cookies HttpOnly, Secure y SameSite según flujo, anti-CSRF para operaciones por cookie. Identidades workload limitadas, tokens cortos cuando soportados y audience dedicada. Revocación propagada a sesiones, cachés de autorización y jobs. Acciones diferidas recalculan permisos, sin reutilizar decisiones obsoletas.
06 · SEGURIDAD DE DATOS
Verificar controles en el entorno real con configuración, logs y pruebas adversas.
TLS, WAF/límites según entorno, allowlist de salida, anti-SSRF, segmentación y bases no públicas cuando requerido. Probar aislamiento API, cachés, índices, archivos y jobs. Red privada no sustituye identidad.
Separar claves de sesión, credenciales y claves de datos. Secretos en gestor o envelope encryption, nunca prompts/navegador/logs. Azure puede usar Key Vault/managed identity; perfil privado exige equivalente. AES-GCM requiere nonce único por clave y tag validado. Cifrado at-rest, rotación, versiones y restore son controles distintos configurados y probados. TLS no cifra almacenamiento.
SHA-256 es hash, no cifrado ni anonimización; no prueba autor, fecha o inmutabilidad y puede revelar igualdad. Usar append-only/WORM o firmas/HMAC con claves protegidas y tiempo fiable. Retención cubre contenido, índices, logs, backups, legal hold y plazos de borrado.
07 · PROVEEDORES IA
Configuración identifica proveedor, modelo, región, identidad de servicio y contrato. Habilitar ruta requiere validación del tenant.
Claude por Anthropic o modelos disponibles en Bedrock: APIs/contratos distintos. OpenAI por APIs soportadas, salidas estructuradas y function/tool calling. El modelo propone; servidor valida schema, parámetros y política antes de ejecutar. No asumir importación de pesos, sesiones o estado propietario.
Validar cuenta, región, disponibilidad e IAM. InvokeModel/Converse, Agents y Knowledge Bases son capacidades distintas. Guardrails y private endpoints se configuran aparte. Perfiles cross-region pueden cambiar geografía: verificar, no deducir residencia por etiqueta.
Contrato aplica clasificación, minimización/PII, regiones/herramientas autorizadas, tokens, plazos y calidad. agentId resuelve versión de capacidad/workflow; adapter traduce contrato sin presumir equivalencia API. Run registra proveedor/modelo, policyVersion, consumo, evidencias y resultados validados. Fallback solo entre rutas aprobadas; cuota agotada no evita residencia/confidencialidad. Training/retención/logging según servicio y acuerdo activados.
08 · N8N
Importar definición no la activa.
JSON transfiere definiciones compatibles, no automáticamente secretos, licencias, estado o ejecuciones. Validar nodos, triggers, sub-workflows y credenciales. Versionar endpoints/workflows, autenticar webhooks/callbacks y registrar executionId/correlationId; firma/token protegido y anti-replay cuando soportado.
Separar editor n8n, workers, colas y secretos por despliegue. Validar entradas/salidas, egress, sub-workflows y código con owner operativo. Comando vincula objeto, scope, versión, aprobación y vencimiento; worker no los amplía. Callbacks autenticados/deduplicados mediante executionId/correlationId. Timeout o resultado incierto abre conciliación, no una segunda acción irreversible.
09 · PROCESOS Y CONTROL HUMANO
Análisis IA, aprobación y escritura son operaciones distintas.
Vincular aprobador autorizado, objeto, entradas, importe, versión y vencimiento; cambios materiales invalidan aprobación. Revalidar permisos/versión fuente antes de escribir para reducir time-of-check/time-of-use. Sin autoaprobación si exige segregación de funciones.
CRM recoge caso; commerce/ERP validan pedido/pago; WMS recepción/calidad. Semántica vincula devolución, SKU y mercado; IA sintetiza y propone. Finance/Quality aprueban excepciones; adapter concilia reembolso/stock. Umbrales/sistemas confirmados por cliente.
Especificación separa draft, validación, versión publicada e instancia. Designer define tareas tipadas, gateways, carriles, bindings y gates; publicar requiere owner, capacidades autorizadas, políticas y pruebas. Orchestrator gobierna objetivos/misiones; agentes/workflows registrados actúan en tareas. Runtime conserva estado durable, timers, intentos y eventos por caseId/processVersion. Performance/conformance/root cause usan event logs validados; previsiones y supuestos económicos separados de resultados medidos.
10 · AMENAZAS IA
Un texto recuperado no puede cambiar permisos.
Separar instrucciones/contenido, allowlist herramientas, parámetros validados, ACL antes del retrieval y egress controlado. Sin secretos en contexto. Detectores/prompts solos no bloquean toda injection; límites servidor esenciales.
Validar JSON Schema/reglas business, sanear HTML/enlaces; código/SQL generado no confiable y sin ejecución arbitraria. Citas no garantizan exactitud. Probar evidencias insuficientes, contradictorias/obsoletas, sobrecostes y ataques cross-tenant.
11 · CUMPLIMIENTO
Arquitectura, hash y certificación cloud no certifican toda aplicación.
Documentar responsable/encargado, base legal, finalidad, minimización, DPA, subencargados, transferencias, derechos y DPIA cuando necesaria. AI Act según uso, rol y riesgo. Gates humanos no son certificación jurídica.
Ocra Group: código/componentes suministrados; cliente: identidad, datos y políticas/configuración acordadas; proveedores: servicios contractuales. Formalizar RACI, SLA, DPA. ISO 27001/SOC 2 del proveedor no se trasladan automáticamente a Artiplane.
12 · CHALLENGE TÉCNICO
La revisión relaciona riesgos, criterios de aceptación y evidencias necesarias. No sustituye una auditoría independiente de la instalación.
Token expirado, issuer/audience incorrectos, rol revocado, objeto ajeno, caché compartida y ACL eliminada: denegar antes de datos/tool. Propagar revocación a jobs y sesiones diferidos.
Injection documental, importe cambiado tras aprobación, callbacks duplicados, timeout tras escritura, cuota agotada, proveedor prohibido: sin escalada, doble escritura ni fallback prohibido; excepción conciliable.
Exigir topología as-built, inventario, threat model, matriz permisos, SBOM, scans/pentest remediados, cifrado/rotación, restore tests, RPO/RTO medidos, audit, DPA y configuración IA. Sin pruebas, control es requisito/declaración, no garantía verificada.