Ajustes de la plataforma
Las secciones de administración de la plataforma, una cada vez: procesos, límites, antivirus, email, alarmas, OpenTelemetry, inteligencia artificial, autenticación de las apps, app móvil, plantillas, archivos sin uso, instalación y código abierto.
Los Ajustes son el panel de control de la instalación entera. No son los ajustes de una app — esos viven dentro de cada app y viajan con ella. Aquí se decide lo que la plataforma hace sola, adónde manda los avisos, a partir de qué valores se preocupa, y cuánto dura una sesión.
Se abre por el elemento Ajustes, al final de la barra lateral. Solo entran cuentas con perfil de administrador.
Las secciones están en una navegación a la izquierda, por grupos: Plataforma, Avisos, Observabilidad, Inteligencia artificial, Apps, Instalación y Acerca de. Se abre una sección cada vez, y la dirección cambia con ella, así que el botón de volver del navegador lleva a la sección anterior. El grupo Instalación solo aparece en una instalación de una sola organización. En una pantalla estrecha, la navegación pasa a ser una lista desplegable encima de la sección.

Nota
Cada sección tiene su botón Guardar, en la cabecera, y guarda solo esa sección. Cambiar de sección sin guardar pierde lo que estaba escrito en ella.
Procesos
La sección Procesos activa y desactiva lo que corre solo mientras nadie está mirando. Son tres interruptores independientes:
| Interruptor | Qué ocurre cuando está activado | Qué pierdes al desactivarlo |
|---|---|---|
| Programador | Ejecuta las programaciones, los informes programados y los temporizadores de los workflows. | Nada se borra: las horas marcadas simplemente no corren hasta volver a activarlo. |
| Índice de observabilidad | Lleva lo que las apps registran al índice central y aplica los plazos de retención de cada app. | Las pantallas del Radar muestran datos viejos y los registros se guardan para siempre. |
| Notificaciones en tiempo real | Las notificaciones llegan a la pantalla de quien está trabajando, al momento. | Las notificaciones se siguen creando y entregando — pero solo aparecen en la visita siguiente. |
El interruptor de los avisos por email está en la sección Alarmas.
Cada interruptor tiene efecto cuando haces clic en Guardar, sin reiniciar el servidor: lo que activas arranca en ese momento, y las notificaciones en tiempo real desactivadas se cierran enseguida.

Atención
Desactivar el Programador es la causa número uno de «mis scripts dejaron de correr». Si una programación parece muerta, confirma este interruptor antes de investigar el script. Vale lo mismo para informes programados y para pasos de espera en workflows — todos dependen del mismo motor.
Antivirus
La sección Antivirus conecta la plataforma a un antivirus por ICAP, para que los archivos que entran en las apps se analicen antes de guardarse, y muestra los archivos en cuarentena. Se explica en Antivirus.
Por aquí la plataforma manda sus alarmas — no confundir con el correo que cada app manda a sus usuarios, que se configura en los canales de notificación de la app.
Rellena:
- Servidor y Puerto del servicio de correo.
- Seguridad — SSL/TLS cifra desde el inicio de la conexión (puerto 465); STARTTLS si el servidor lo ofrece abre la conexión sin cifrado y pasa a TLS si el servidor lo ofrece (puerto 587); Ninguna nunca cifra, para servidores internos sin TLS (puerto 25). Sin usuario ni contraseña, el envío no se autentica.
- Usuario y Contraseña de la cuenta de envío. La contraseña se escribe una vez y nunca vuelve a la pantalla: el campo pasa a decir que está definida, y dejarlo vacío significa «no tocar», nunca «borrar».
- Remitente — la dirección que ve quien recibe.
- Destinatarios: direcciones, separadas por comas, que reciben todas las alarmas. En blanco, cada app avisa a las personas asignadas a ella, y las apps sin nadie asignado y la plataforma avisan a los administradores activos.

Alarmas
La sección Alarmas dice si la plataforma avisa por email y a partir de qué valores.
El interruptor Avisos por email, arriba, activa los avisos. Desactivado, nadie es avisado, y los problemas solo se descubren al abrir el Radar. Los avisos salen por el servidor de la sección Email.
Un problema nuevo en una app publicada, o un problema resuelto que vuelve a ocurrir, avisa siempre, sin umbral. Qué genera cada alerta y qué dice el correo está en Alertas por correo.
Los Umbrales le dicen a la plataforma qué es normal y qué merece un correo. Todos se evalúan dentro de la ventana definida al final de la sección.
| Valor | Qué significa |
|---|---|
| Fallos del servidor en las APIs (%) | Porcentaje de peticiones que fallan en el servidor (5xx) por encima del cual se abre una alarma de fallo generalizado, con al menos 5 fallos en la ventana. Los rechazos, las peticiones canceladas y los errores de validación no cuentan. |
| Peticiones mínimas | Por debajo de este número de peticiones, el porcentaje no cuenta. Un error en tres peticiones son 33% y no quiere decir nada. |
| Scripts fallidos | Cuántas ejecuciones fallidas abren una alarma. |
| Retraso de la cola (s) | Cuánto tiempo puede quedarse atrás el trabajo de fondo antes de considerarse retrasado. |
| Disco libre (%) | Por debajo de este porcentaje, avisa. |
| Ventana (min) | El periodo en que se cuenta todo lo de arriba. |
Consejo
En una instalación con poco tráfico, sube las Peticiones mínimas. Es el campo que evita alarmas falsas en apps que solo se usan por la mañana.
Límites
Dos ajustes que valen para toda la plataforma:
- Duración de la sesión (h) — cuánto tiempo dura una sesión sin actividad. Mientras se trabaja, la sesión se renueva sola; solo la inactividad prolongada obliga a entrar de nuevo.
- Archivo máximo (MB) — el tamaño máximo de un archivo subido en cualquier app de la instalación. Vale también para los archivos subidos a los assets de una app. Llega hasta 100 MB. La importación de apps no depende de este valor: acepta paquetes de hasta 1 GB (consulta Importar y exportar apps).
OpenTelemetry
La sección OpenTelemetry, en el grupo Observabilidad, envía lo que pasa en las apps al servidor OpenTelemetry de la empresa, por OTLP sobre HTTP en JSON. El Radar sigue funcionando como antes: el envío es una copia.
- En Dirección, escribe la dirección base de OTLP por HTTP, por ejemplo
https://otel.empresa.pt:4318. Keplin añade/v1/tracesy/v1/logs. - Opcional: en Cabeceras, haz clic en Añadir cabecera y escribe el
Nombre y el Valor de las cabeceras de autenticación del servicio,
por ejemplo
Authorizationox-api-key. Los valores se guardan cifrados y no vuelven a aparecer; en blanco, se mantiene el valor guardado. - En Qué enviar, elige:
- Llamadas a las APIs y ejecuciones de scripts, como traces, con los ids de trace y de span que Keplin ya usa;
- Errores del Radar, como logs, con el tipo, el mensaje y la traza del error, vinculados al trace;
- Auditoría, como logs: quién cambió qué en la plataforma, sin el antes y el después;
- Actividad en el navegador, como traces: las pantallas abiertas, los clics y las lecturas. Es mucha: actívala solo si el servicio la soporta.
- Haz clic en Probar conexión. La prueba se supera cuando el servidor acepta un envío de prueba.
- Activa Enviar a OpenTelemetry y haz clic en Guardar.

El envío empieza en el momento en que se activa, sin el historial. Los datos de las peticiones y de las respuestas nunca se envían. El Estado muestra la hora del último envío y cuántos spans y logs salieron desde que arrancó el servidor, y el último error, si es más reciente que el último envío.
Dirección pública
La Dirección pública es la dirección por la que las personas abren la
plataforma, por ejemplo https://plataforma.ejemplo.es. Es la que va en los
enlaces de los correos, como el de recuperación de la contraseña de las
cuentas de las apps. La sección está en el grupo Instalación, que solo
aparece en una instalación con un solo tenant; en multitenant vale la
dirección de cada tenant.
Se rellena en el primer inicio de sesión de un administrador, con la dirección por la que entró. Si no es la dirección que usan las personas (por ejemplo, si el administrador entró por la IP de la red interna), corrígela y haz clic en Guardar.
Sin Dirección pública, la recuperación de la contraseña solo funciona en las apps publicadas en un dominio propio. La dirección que llega en una petición nunca sirve para el enlace, porque la elige quien hace la petición.
Servidor PostgreSQL de la plataforma
Para los datasources internos en PostgreSQL (ver Conectar bases de datos), la instalación necesita un servidor PostgreSQL donde la plataforma crea las bases. La configuración es de la instalación, no de una app: en una instalación de una sola organización está en los Ajustes, en la sección PostgreSQL gestionado del grupo Instalación; en una instalación con varios clientes está en el backoffice de la instalación. Rellena la dirección, el puerto, la cuenta de administración y el límite de bases por cliente, guarda y usa Probar servidor para confirmar que la plataforma puede crear bases en ese servidor. Mientras no esté configurado, la opción PostgreSQL de la pestaña Interno aparece desactivada al crear un datasource.
Motor del navegador
Las capturas de pantalla que los agentes piden por MCP y las pruebas de pantalla (ver El proyecto de pruebas) usan un navegador sin pantalla que se ejecuta en el servidor. Hay uno solo para toda la instalación, en un proceso aparte y con prioridad baja: cuando la máquina va justa, quien cede es el navegador, no las peticiones de las apps.
La sección Motor del navegador, en el grupo Instalación (en una instalación con varios clientes, en el backoffice de la instalación), muestra el Estado (en ejecución, o cerrado hasta el próximo trabajo), si Chromium está instalado, los Trabajos en ejecución y en cola, la Memoria libre y el Último error. Y tiene los límites que protegen el servidor:
| Límite | Qué hace |
|---|---|
| Trabajos a la vez | Cuántas páginas abiertas al mismo tiempo. Más páginas, más memoria y CPU. |
| Peticiones en cola | Con la cola llena, una petición nueva se rechaza enseguida, con el motivo. |
| Minutos parado hasta cerrar | Cerrado, el navegador no ocupa memoria; el trabajo siguiente lo vuelve a abrir. |
| Memoria libre mínima (MB) | Por debajo de esto no se abre ninguna página nueva. 0 desactiva la protección. |
Cerrar el navegador ahora devuelve la memoria al momento. Si falta Chromium, Instalar Chromium lo descarga; la instalación y las actualizaciones de la plataforma ya lo instalan y comprueban que arranca.
Actualizar la plataforma
Dónde y cómo se actualiza depende del modo de la instalación:
- Instalación de una sola organización: no hay actualización por la interfaz. La sección Actualizaciones de los Ajustes muestra la Versión instalada: y el comando a ejecutar en la consola del servidor con el zip de la versión nueva, con un botón para copiarlo. El instalador conserva la configuración y los datos y ejecuta las migraciones; para volver a una versión anterior, se instala el zip de esa versión.
- Instalación con varios clientes: la actualización se hace en el backoffice de la instalación, en Actualizaciones, y es esa pantalla la que describe el resto de esta sección. Las Definiciones de cada cliente no tienen actualizaciones.
La sección de actualización muestra la versión instalada y la lista de versiones disponibles. El proceso tiene dos botones a propósito:
- Preparar — va a buscar la versión elegida y la prepara sin tocar nada de lo que está sirviendo. La plataforma sigue funcionando.
- Cuando la preparación termina, aparece el plan: cuántas bases de datos se van a migrar, qué archivos de apps se reescriben y en cuántas versiones, más el aviso de que las bases de datos se copian antes de tocar nada.
- Aplicar esta actualización — solo después de leer el plan. La plataforma queda indisponible durante el reinicio y vuelve en la versión nueva.

Nota
Si alguna app tiene en disco cambios que aún no están en el historial, el plan lo dice y la actualización los guarda primero, en un registro aparte, antes de reescribir los archivos. Los archivos que la plataforma escribe por sí sola, como las copias de las dependencias de los scripts que hace una programación, no cuentan.
Si algo sale mal a medias, la versión anterior se restablece automáticamente y la pantalla lo dice — incluido el registro de lo que falló.
La reposición devuelve al estado anterior a la actualización las bases de datos y también los archivos de las apps que las migraciones habían reescrito.
Verificación del servidor
En la pantalla de las actualizaciones, el bloque Verificación del servidor muestra si la máquina tiene lo que necesitan los scripts de las apps, las capturas de pantalla y las pruebas de pantalla: Chromium, el aislamiento de los scripts, las reglas de red de los scripts y los procesos de la plataforma ejecutándose con el usuario de la instalación. La verificación se ejecuta al final de la instalación, al final de cada actualización y al arrancar el servidor; Verificar ahora la ejecuta a petición.
El resumen dice «Todo está bien.», cuántos avisos hay, o cuántos problemas quedan por resolver. Cada problema dice qué falla y muestra el comando que lo resuelve, para ejecutar como root en la consola del servidor.
Inteligencia artificial
El grupo Inteligencia artificial tiene la sección Proveedores: los servicios de IA del tenant que pueden usar los scripts de las apps, con las credenciales y los modelos autorizados. Ver Proveedores de IA.
Autenticación de las apps
La sección Autenticación de las apps, en el grupo Apps, registra los proveedores por los que pueden entrar los usuarios de las apps: Microsoft Entra ID, Google, un servicio OpenID Connect u OAuth 2.0 y, en una instalación con un solo tenant, Active Directory. Se explica en Entrar con proveedores de autenticación.
App móvil
La sección App móvil sirve la app Android con la que se entra en las apps de esta plataforma. Tiene dos archivos para descargar y un código QR por app — está explicado en detalle en el capítulo App móvil.

Plantillas
La sección Plantillas, en el grupo Apps, lista las plantillas de esta plataforma: las que se guardaron en las apps con Guardar como plantilla (ver Plantillas de apps). Las plantillas de sistema son de la instalación y no aparecen aquí.
Cada fila muestra el nombre, la versión, la descripción, la app de la que vino, la fecha en que se guardó y el tamaño. En cada una:
- Descargar transfiere el archivo
.keplintemplate, para llevarlo a otra instalación. - El icono de la papelera elimina la plantilla. La confirmación aparece en la propia fila: haz clic en Eliminar para confirmar, o en Cancelar. La plantilla sale de la galería de Nueva app, y las apps ya creadas a partir de ella no cambian.

Archivos sin uso
Los archivos cargados en las apps no se eliminan solos: ni cuando se elimina el registro que los tenía, ni cuando se sustituye un adjunto, ni cuando un formulario se queda a medias. La sección Archivos sin uso los encuentra y deja elegir lo que sale. Nada se elimina solo.
- Haz clic en Buscar archivos sin uso, en la cabecera. La búsqueda se ejecuta en segundo plano en el servidor: puedes salir de la página y volver, y continúa.
- Mientras busca, la página muestra el progreso (por ejemplo, «3 de 12 apps») y lo que está leyendo. Cada app aparece en cuanto termina, con los archivos que ninguna referencia conocida usa: nombre, tamaño, fecha de carga y versiones. El icono junto al nombre descarga el archivo, para que confirmes qué es.
- Elige los archivos y haz clic en Eliminar seleccionados. La página pide confirmación; antes de eliminar, la plataforma vuelve a verificar los archivos elegidos, y un archivo que mientras tanto pasó a usarse se queda.

El resultado queda guardado: al volver a la sección, aparece la última búsqueda, con la fecha y cuánto duró. Buscar de nuevo repite la búsqueda en todas las apps, y Buscar en esta app, en la cabecera de una app, solo en esa. Cancelar la búsqueda detiene una búsqueda en curso. Si el servidor se reinicia a mitad, la página dice que la última búsqueda quedó a medias. Tiempo de cada fuente muestra cuánto tardó cada base leída, para entender dónde está el tiempo de una búsqueda lenta.
Un archivo cuenta como usado cuando su token aparece en el diseño de la app, en las bases SQLite de la app (incluidos procesos y notificaciones) o en una columna de texto de una tabla del modelo, en cualquier versión. Los datasources de solo lectura no se leen, porque Keplin nunca escribe en ellos. Una tabla fuera del modelo o un sistema externo no se ven: confirma antes de eliminar. Los archivos de las últimas 24 horas no entran, y una app con una base que no se puede leer queda fuera de la lista.
Atención
Un archivo eliminado no vuelve. Los bytes salen del almacenamiento de la app y el archivo sale del registro de todas las versiones.
Código abierto
La sección Código abierto lista las bibliotecas de código abierto instaladas en la plataforma, con la versión y la licencia de cada una. El nombre de cada biblioteca abre la página del proyecto. Escribe en el campo de búsqueda para filtrar la lista por nombre o por licencia.
Preguntas frecuentes
Cambié un umbral y no recibí nada. Las alarmas solo se evalúan minuto a minuto y solo dentro de la ventana definida. Confirma también que el interruptor Avisos por email, en la sección Alarmas, está activado, y que el servidor de la sección Email está rellenado.
¿Puedo tener servidores de correo distintos por app? Sí — y es lo normal. El correo de esta página es solo el de los avisos de la plataforma; cada app configura sus canales en sus ajustes.
¿Quién puede ver esta página? Solo cuentas con perfil de administrador. Un developer no la ve en la barra lateral ni entra por dirección directa.