Skip to main content
Los certificados mTLS (Mutual TLS) permiten establecer autenticación mutua entre tu aplicación y los servidores externos. Esta funcionalidad te permite usar certificados cliente para autenticarte con APIs que requieren autenticación mutua mediante TLS.

​
Acceder a los certificados

Para gestionar tus certificados mTLS, dirígete a Configuraciones > Certificados. Esta sección te permite administrar todos los certificados asociados a tu compañía.
La sección de certificados no está disponible para compañías self-service.
Vista completa de la sección de certificados mTLS mostrando la lista de certificados con sus nombres, fechas de expiración y opciones para marcarlos como primarios

​
Crear certificado

Haz clic en Crear, en la parte superior de la lista, para abrir un panel lateral con estos campos:
Modal para crear un nuevo certificado mTLS con opciones para subir archivos PEM o CRT + KEY
  • Nombre (obligatorio): máximo 100 caracteres, único dentro de tu compañía (no distingue mayúsculas) y sin emojis.
  • Passphrase (opcional): si tu clave privada está protegida, ingresa su contraseña. Debe tener entre 8 y 128 caracteres, sin emojis y sin espacios al inicio ni al final.
  • Archivos del certificado: elige una de las dos opciones siguientes.
Puedes subir los archivos en dos formatos, que son excluyentes: al cargar una opción, la otra se limpia y se bloquea.
Cada archivo puede pesar hasta 5 MB. Asegúrate de que los certificados sean válidos y no estén expirados antes de subirlos. La fecha de vencimiento se extrae automáticamente del certificado.
El botón Subir del panel se habilita solo cuando el nombre es válido y adjuntaste el archivo .pem o el par CRT + KEY. Los certificados nuevos no se marcan como principales: puedes hacerlo después desde la lista.

​
Opción A: archivos separados (CRT + KEY)

Ambos archivos son obligatorios:
  • Archivo CRT (.crt o .cer): contiene el certificado
  • Archivo KEY (.key): contiene la clave privada

​
Opción B: archivo único (.pem)

Un archivo .pem que contiene tanto el certificado como la clave privada.

​
Ver certificados

En la sección de Certificados puedes ver todos los certificados de tu compañía en una tabla con las columnas:
  • Nombre del certificado
  • Fecha de vencimiento (por ejemplo, oct 13, 2027; se muestra - si no hay fecha)
  • Principal: un interruptor que indica si es el certificado principal
  • Acciones: iconos para editar y eliminar
La tabla se pagina en la parte inferior. Si aún no has agregado certificados, verás el mensaje “No se han agregado certificados aún”.

​
Marcar un certificado como principal

Activa el interruptor Principal del certificado. Este certificado será seleccionado automáticamente cuando actives mTLS en un nodo API si no has seleccionado manualmente otro certificado.
Solo puede haber un certificado marcado como primario a la vez. Si marcas un nuevo certificado como primario, el anterior dejará de serlo automáticamente.
Mientras se guarda el cambio, el interruptor permanece deshabilitado; si la operación falla, vuelve a su estado anterior.

​
Editar un certificado

Puedes editar el nombre de tus certificados existentes para identificarlos más fácilmente. Esto es útil cuando tienes múltiples certificados para diferentes propósitos o entornos. Haz clic en el icono de editar (lápiz) de la columna Acciones junto al certificado que deseas modificar. El nombre debe cumplir las mismas reglas que al crearlo.
Solo puedes cambiar el nombre. Los archivos no se pueden reemplazar: para usar otro certificado o clave, crea un certificado nuevo.

​
Eliminar un certificado

Puedes eliminar certificados que ya no necesites. Para eliminar un certificado, haz clic en el icono de eliminar (papelera) de la columna Acciones; se abrirá un modal de confirmación con el nombre del certificado.
No puedes eliminar el certificado principal: la opción aparece deshabilitada. Primero quita la marca de principal activando otro certificado.
Antes de eliminar un certificado, el sistema te mostrará una advertencia indicando que debes asegurarte de que este certificado no está siendo usado en ningún nodo API. Si eliminas un certificado que está en uso, esto podría causar errores en las llamadas API de tus flujos activos.

​
Usar certificados en nodos API

Una vez que tengas certificados cargados, puedes usarlos en el nodo API activando la opción de certificados mTLS en la sección Settings del nodo.