Integraciones
Modelo de integraciones
Kuatia se conecta con sistemas externos usando un modelo de tres capas:
- Credential — almacena credenciales de autenticación (AES-256-GCM)
- External System — agrupa endpoints bajo un sistema, con URL base y credencial
- Endpoint — define una operación concreta (método, path, headers, schemas)
- UI Endpoint — define una integración UI embebida (iframe, popup, redirect, etc.)
Protocolos soportados
REST (default)
Endpoints configurados con method (GET/POST/PUT/PATCH/DELETE), path, headers, input/output schemas, timeout y retry.
SOAP
Endpoints con protocol=SOAP. Dos direcciones:
- Outbound: Kuatia llama a un servicio SOAP externo. Se configura
wsdlUrlysoapVersion. - Inbound: un sistema externo llama a Kuatia. El endpoint expone:
GET /soap/:id?wsdl— WSDL generado dinámicamentePOST /soap/:id— recibe envelope SOAP con validación WS-Security
Tipos de credencial
| Tipo | Uso |
|---|---|
| NONE | Sin autenticación |
| BEARER | Token fijo en header Authorization |
| API_KEY | Key en header o query param |
| BASIC | Usuario/password (base64) |
| OAUTH2 | Client credentials flow |
| JWT | JWT firmado con key propia |
| MTLS | Certificado cliente (futuro) |
Importación de endpoints
- Desde cURL:
POST /endpoints/import/curl— parsea un comando cURL y crea el endpoint - Desde Swagger/OpenAPI:
POST /endpoints/import/swagger— parsea un spec y crea múltiples endpoints
UI Endpoints
Permiten embeber interfaces externas en el contexto de tareas:
| Modo | Comportamiento |
|---|---|
| IFRAME | Sistema externo en iframe dentro de Kuatia |
| POPUP | Ventana popup con callback |
| REDIRECT | Redirección completa |
| NEW_TAB | Abre en nueva pestaña |
| INTERNAL | Componente React registrado en el frontend |
SSO: NONE, SAME_KEYCLOAK, TOKEN_EXCHANGE, OTT (One-Time Token), SAML.
MIME Handlers
Extractores y visores custom por tipo de archivo:
- Builtin: PDF, imágenes (EXIF), Word, Excel, CSV, texto, SQL, audio, video
- Custom: el admin puede agregar via WEBHOOK, ENDPOINT, REACT_COMPONENT o IFRAME_URL