DocumentaciónAyuda

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 X-API-Key

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

  1. En Configuración → Integraciones, presiona Nueva integración.

  2. Elige el tipo en Autenticación y completa sus campos.

  3. Completa el resto del formulario y presiona Guardar.

Cambiar o conservar las credenciales al editar

  1. En la tarjeta de la integración, presiona el botón Editar (lápiz).

  2. 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.

  3. 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.

  4. 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.

Relacionado

Buscar en SofIA Gestión

Escribe al menos 2 letras para buscar en SofIA Gestión.

↑↓ moverse · Enter abrir · Esc cerrar