Ir al contenido principal

Claves de integración

Crea, edita y elimina las claves que autentican las integraciones de tu área de trabajo con la API de Coodesh.

Las claves de integración autentican las llamadas que otros sistemas hacen a la API de Coodesh, como la integración con tu ATS o la exportación de datos del Datalake. Cada clave pertenece a un área de trabajo.

Para gestionar las claves, abre el menú del área de trabajo (logo de la empresa, en la esquina superior izquierda) y haz clic en Integraciones. La página también está en Configuración › Integraciones.

Quién puede gestionar las claves

Crear, editar y eliminar claves requiere el permiso Gestionar claves de integración. Los Administradores y Gerentes ya lo tienen, y también puede concederse individualmente a otras personas del área de trabajo.

Crear una clave

En la sección Claves de integración, haz clic en Nueva clave y completa los campos:

  • Nombre (obligatorio): un nombre que identifique dónde se usa la clave, por ejemplo "Integración ATS".

  • Descripción: detalles opcionales sobre la integración.

  • Proveedor (obligatorio): la plataforma que usará la clave, como Gupy, Greenhouse, Lever o InHire. Si la tuya no aparece en la lista, mantén la opción predeterminada, Coodesh.

  • Permisos (obligatorio): las acciones que la clave puede ejecutar: Listar, Leer, Crear, Actualizar y Eliminar. Todas vienen marcadas; desmarca las que la integración no usa.

Haz clic en Guardar y continuar. La clave aparece en la pantalla siguiente, con un botón para copiarla.

La clave se muestra una sola vez. Cópiala ahora y guárdala en un lugar seguro, o pégala directamente en la plataforma de integración. Después, la tabla solo muestra una versión enmascarada de la clave.

Recursos accesibles

El campo Recursos accesibles define a qué grupos de endpoints puede acceder la clave, como los endpoints estándar y los del Datalake. Lo configura el equipo de Coodesh.

Sin recursos definidos, la clave accede a los endpoints estándar de la API, pero no a los del Datalake. Si tu integración necesita el Datalake, pide la habilitación a tu contacto comercial o al soporte, indicando el nombre de la clave. Consulta Datalake: exportación de datos para BI y data warehouse.

Editar una clave

En la tabla, haz clic en Editar en la fila de la clave. Puedes cambiar:

  • Nombre

  • Descripción

  • Proveedor

  • Permisos

Por seguridad, el valor de la clave y su ID no se pueden cambiar. Para reemplazar la clave, crea una nueva y elimina la anterior.

Eliminar una clave

En la tabla, haz clic en Eliminar en la fila de la clave y confirma. La eliminación no se puede deshacer y las integraciones que usan esa clave dejan de funcionar.

¿Perdiste tu clave?

No es posible volver a ver la clave. Para recuperar el acceso:

  1. Crea una nueva clave siguiendo los pasos anteriores.

  2. Actualiza la integración con la clave nueva.

  3. Elimina la clave anterior.

¿Ha quedado contestada tu pregunta?