Seguridad: credenciales y avisos

Una aplicación del catálogo guarda las llaves de muchas empresas a la vez. Si se filtra la clave de una instalación, alguien puede leer y escribir en esa empresa con los permisos que te concedió. Por eso todo lo de esta página pasa en tu servidor, nunca en un navegador ni en una aplicación que distribuyas. La seguridad de tu propia cuenta, con la verificación en dos pasos y las sesiones, está en Seguridad de la cuenta.

Las credenciales que manejas

Las tres se usan solo desde tu servidor. El canje rechaza cualquier petición con cabeceras de navegador (403 EXCHANGE_FROM_BROWSER) y la clave de una instalación no admite dominios de navegador: no la pongas en una página web ni en una aplicación móvil.

Cómo guardarlas

• Cifradas y por instalación, con el identificador de la instalación y el de la empresa al lado. Nunca una sola clave para todas las empresas.
• Fuera del código: ni en el repositorio, ni en los registros de tu servidor, ni en mensajes, capturas o sistemas de incidencias.
• Con acceso mínimo: solo las personas y los procesos que las necesitan, y con verificación en dos pasos en los sistemas que las guardan.
• Usa la de cada empresa solo para esa empresa. Nunca combines instalaciones para conseguir lo que una sola no permite.
• Destrúyelas al terminar, en cuanto recibes APP_UNINSTALLED.

Nunca pidas a las personas de una empresa su contraseña de UTILIA OS, sus códigos de verificación ni las claves de API de su organización: tu aplicación tiene todo lo que necesita en su instalación.

Tu dirección de instalación es pública

Cualquiera puede abrirla con parámetros inventados. Al recibir una petición:

• El código decide, no la dirección. Solo el canje dice si un code es bueno; no actives nada antes de que responda 200.
• Comprueba que installation.id del canje es el installation_id de la dirección.
• Vuelve solo a UTILIA OS. Antes de redirigir a return_url, comprueba que empieza por https://os.utilia.ai/: si no, tu dirección sería una redirección abierta.
• Comprueba tu state. Si la instalación empezó desde tu botón «Instalar en UTILIA OS», el state tiene que ser uno que generaste tú.
• No guardes el código en los registros. Vale 30 minutos y una vez, pero no hace falta dejarlo escrito.

Tus avisos

• Comprueba la firma de cada aviso con la clave de firma de su instalación, elegida por la cabecera X-Utilia-Installation-Id, y rechaza con 401 los que no la superen.
• Rechaza los avisos con una marca de tiempo de hace más de cinco minutos.
• Descarta los repetidos por X-Utilia-Delivery-Id.
• Tu dirección de avisos usa HTTPS y está en tu dominio verificado; UTILIA OS no entrega avisos a direcciones de redes privadas.

El código está en Avisos de cada instalación.

Renovar una credencial

Para cambiar de clave sin prisa, por ejemplo al mover tus secretos a otro sistema, basta con volver a conectar. Si la clave de una instalación se ha expuesto, esos siete días son un riesgo: pide a la empresa que desinstale y vuelva a instalar tu aplicación.

Si sospechas una filtración

1. Deja de usar las credenciales afectadas y cierra el acceso por donde se filtraron.
2. Si es la clave de tu aplicación, renuévala: con ella se podrían canjear los códigos que estén vigentes.
3. Si son las de una o varias instalaciones, pide a cada empresa afectada que reinstale tu aplicación.
4. Avisa a UTILIA en compliance@utilia.ai en las 24 horas siguientes a saberlo y, si afecta a sus datos, a cada empresa afectada en las 48 horas siguientes, con lo que sepas. Si hay riesgo para los datos de las empresas, UTILIA puede suspender tu aplicación en todas a la vez mientras se resuelve.

El contacto de seguridad de tu ficha es la dirección a la que te escribiremos nosotros si detectamos un problema. Tiene que llegar a alguien que responda en tres días laborables como mucho, o de inmediato si te avisamos de un riesgo grave.