Credenciales de acceso
Elige cómo se autentica la plataforma ante tu sistema y guarda su llave, token o usuario de forma cifrada.
En esta página
Las credenciales permiten que la plataforma se conecte a la API de tu sistema, por ejemplo para probar la conexión con el botón Probar. Se guardan cifradas y nunca se vuelven a mostrar: después de guardarlas solo verás una pista con sus últimos caracteres.
No confundas estas credenciales con el Secreto de firma del webhook: las credenciales sirven para que la plataforma entre a tu sistema; el secreto sirve para que tu sistema firme lo que envía a la plataforma.
Antes de empezar
Necesitas el rol Administrador.
Pide al responsable del sistema una credencial de solo lectura, si el sistema lo permite. La plataforma no necesita permisos de escritura.
Tipos de autenticación
En Autenticación, dentro del formulario de la integración, elige una opción. Cada una muestra sus propios campos:
Opción | Campos |
|---|---|
Sin autenticación | Ninguno |
API key | API key y Nombre del header (opcional), por ejemplo |
Token Bearer | Token |
Usuario y contraseña | Usuario y Contraseña |
OAuth 2.0 (client credentials) | Client ID, Client secret y URL del token |
Bajo los campos verás: Se guardan cifradas y no se vuelven a mostrar; solo verás una pista de los últimos caracteres.
Si en API key dejas vacío Nombre del header (opcional), la llave se envía en el header X-API-Key.
Con OAuth 2.0 (client credentials), la plataforma guarda los datos cifrados, pero por ahora Probar consulta tu sistema sin autenticarse. Si tu sistema exige autenticación para su ruta de salud, la prueba responderá con un código como 401.
Guardar las credenciales al crear
En Configuración → Integraciones, presiona Nueva integración.
Elige el tipo en Autenticación y completa sus campos.
Completa el resto del formulario y presiona Guardar.
Cambiar o conservar las credenciales al editar
En la tarjeta de la integración, presiona el botón Editar (lápiz).
Bajo Autenticación verás Credencial guardada: con su pista y Deja los campos en blanco para conservarla. Los campos aparecen vacíos con el texto Dejar en blanco para conservar.
Haz una de estas cosas:
Conservarla: deja los campos en blanco.
Reemplazarla: escribe la credencial nueva en los campos.
Cambiar de tipo: elige otro tipo en Autenticación. Verás Cambiaste el tipo de autenticación: ingresa las credenciales nuevas. Completa los campos del nuevo tipo: el formulario no te lo exige, pero si los dejas vacíos queda guardada la credencial anterior, que no sirve para el tipo nuevo.
Borrarla: elige Sin autenticación. Verás Al guardar se borra la credencial guardada.
Presiona Guardar.
Al cambiar el tipo de autenticación, lo que habías escrito en los campos se descarta. Si te equivocas de tipo, vuelve a elegir el correcto y escribe de nuevo.
Nadie puede ver una credencial después de guardarla, ni siquiera un administrador. Si la pierdes, genera una nueva en tu sistema y reemplázala aquí.
Qué pasa después
La tarjeta de la integración muestra en Autenticación el tipo elegido y la pista de la credencial. Para comprobar que funciona, usa Probar la conexión.
Si la prueba responde Las credenciales guardadas no se pueden descifrar (cambió la llave maestra). Vuelve a ingresarlas., edita la integración y escribe de nuevo la credencial.