API Keys

Para integrar Praesenti con otro sistema (por ejemplo, un sistema de liquidación de sueldos) se usa la API pública. Cada integración necesita una credencial, que se genera desde Configuración > API Keys. Para ver esta sección hacen falta los permisos de integraciones (ver Roles).

La lista muestra, para cada credencial, su nombre, la API Key, los permisos y la fecha de expiración.

Crear una API Key

Al pulsar el botón Nueva API Key se abre el formulario Generar API Key, con estos campos obligatorios:

• Nombre: para identificar la integración.
• Duración: Sin expiración, 1 mes, 3 meses o 1 año.
• Permisos: qué puede leer (LECT.) y qué puede escribir (ESCR.) la credencial en cada sección. Conviene darle solo los permisos que la integración necesita.

Al pulsar Crear, se muestran la Key y el Secret, cada uno con un botón para copiarlo.

Importante:
El secret solo se muestra en ese momento. Si se cierra la ventana sin copiarlo, hay que generar uno nuevo.

Con Finalizar se cierra la ventana. La forma de usar la key y el secret para autenticarse está explicada en la documentación de la API.

Gestionar las API Keys

Desde el menú de cada credencial se puede:

• Editar: cambiar el nombre o los permisos.
• Reestablecer: generar un secret nuevo. El secret anterior deja de funcionar, así que hay que actualizarlo en las aplicaciones que lo usen.
• Eliminar: borrar la credencial. Las integraciones que la usen dejan de tener acceso.