Crear la llave
La credencial con la que tu sistema entra en la API.
Cada sistema que habla con la API lleva su propia llave: así se sabe qué hizo cada uno y se puede cortar uno sin tocar los demás. La crea un administrador de la organización que pueda gestionar roles, y la API tiene que estar en el plan.
- En NDX One, abre Configuración › Conectores › Llaves de API y pulsa «Nueva llave».
- Ponle un nombre que diga qué sistema la usa («ERP», «Web») y elige la empresa: todo lo que lea y escriba será de esa empresa y de lo compartido.
- Elige el responsable: recibe lo que la llave no sabe a quién dar, como una tarea sobre un contacto sin responsable.
- Marca qué puede hacer en Clientes: «Ver» para leer y registrar actividades y tareas; «Editar» también para dar de alta contactos.
- Pulsa «Crear» y copia el secreto. Solo se enseña esa vez.
El secreto va en tu servidor, como cualquier otra credencial. Nunca en una página web, en una app del móvil ni en el código que se publica.
export NDX_LLAVE="ndx_<prefijo>_<secreto>"Si se pierde o se filtra, rótalo desde la misma pantalla. Con «Rotar secreto», el anterior sigue valiendo 24 horas para cambiarlo sin cortes; con «Rotar e invalidar ya», deja de valer en el momento. Cada petición de la llave queda en su actividad.