Cree claves de API para acceso programático a Entity Enricher. Utilice claves de acceso de organización para integraciones de servicio a servicio, canalizaciones CI/CD y flujos de trabajo automatizados.
Entity Enricher admite dos tipos de claves de API, cada una adecuada para diferentes casos de uso:
Claves independientes con su propio rol, no vinculadas a ninguna cuenta de usuario. La mejor opción para la integración entre servicios.
Claves vinculadas a una cuenta de usuario específica. Heredan el rol del creador y se ven afectadas por los cambios en la cuenta de usuario.
ent_a1b2c3d4e5f6g7h8Las claves usan el prefijo ent_ seguido de bytes aleatorios. La clave completa se muestra solo una vez en el momento de la creación — no se puede recuperar después.
Las claves de acceso (para llamar a la API de Entity Enricher) se almacenan como hashes SHA256 en la base de datos, por lo que, incluso con acceso a la base de datos, no es posible recuperar la clave original. Solo los primeros 12 caracteres (el prefijo) se almacenan en texto plano para su identificación.
Las claves de proveedor (claves de API de LLM como Anthropic, OpenAI) se cifran en reposo mediante cifrado simétrico Fernet (AES-128-CBC + HMAC). Deben poder descifrarse en tiempo de ejecución para autenticarse con los proveedores de LLM. Solo se almacenan los últimos 4 caracteres en texto plano.
ent_ y un hash, de modo que una clave que no se haya copiado aquí se sustituye, nunca se recupera.Cree claves desde la página Claves de API en la aplicación, o mediante programación a través de la API REST:
| Campo | Descripción |
|---|---|
| Nombre | Un nombre descriptivo para su identificación (p. ej., "CI/CD Pipeline", "Integración con n8n") |
| Rol | El nivel de permiso: propietario, editor u operador. Determina a qué puede acceder la clave. |
| Alcances | lectura, escritura o ambas. Controla si la clave puede modificar datos o solo leerlos. |
| Vencimiento | Fecha de expiración opcional. Las claves sin expiración duran hasta que se revocan. |
Envíe su clave de API en la cabecera X-API-Key con cada solicitud:
curl -H "X-API-Key: ent_your_key_here" \
https://your-instance.example.com/api/enrichment/options| Método | Encabezado | Caso de uso |
|---|---|---|
| Clave de API | X-API-Key: ent_... | Servicio a servicio, CI/CD, automatización |
| Token Bearer | Authorization: Bearer <jwt> | Clientes web, sesiones interactivas |
| OAuth 2.1 | Authorization: Bearer <access_token> | Conectores y clientes de IA: una concesión revocable por aplicación, no una clave compartida |
El rol de la clave de API determina a qué endpoints puede acceder:
| Categoría de endpoint | Rol mínimo |
|---|---|
| Enriquecimiento (individual, por lotes) | Operador |
| Registros (listar, detalle, eliminar) | Operador |
| Esquema (lectura) | Operador |
| Esquema (crear, editar, eliminar) | Editor |
| Fusión | Operador |
| Información del proveedor | Operador |
| Análisis de costos | Operador |
| Gestión de claves de API | Propietario |
| Gestión de usuarios | Propietario |
La página de Claves de API ofrece una vista completa de todas las claves de la organización con estadísticas de uso:
La página de claves de API tiene cinco pestañas con propósitos distintos: cuatro para todos los usuarios y, además, Claves globales para los administradores del sistema:
Las claves de API de los proveedores de LLM de su organización (Anthropic, OpenAI, etc.) para una facturación independiente. Admite varias claves por proveedor con rotación LRU automática; una clave cuya prueba falla sale de la rotación hasta que se vuelva a probar o se reemplace. Consulte Modelos y precios para conocer el sistema BYOK.
Las claves de proveedor se cifran en reposo mediante cifrado simétrico Fernet (AES-128-CBC con autenticación HMAC). Solo se descifran en tiempo de ejecución al realizar llamadas a la API de LLM. Únicamente se almacenan los últimos 4 caracteres en texto plano con fines de visualización.
Claves de proveedor LLM de ámbito global gestionadas por administradores. Se usan como alternativa cuando no hay ninguna clave de la organización disponible. Admite varias claves por proveedor con rotación LRU: la siguiente es la clave habilitada que se usó hace más tiempo, y una clave sale de la rotación cuando un administrador la desactiva o su prueba la marca como no válida. Si no hay ninguna clave utilizable para un proveedor, la ejecución se rechaza en lugar de iniciarse.
Claves de acceso de la organización para la propia API de Entity Enricher. Las utilizan sistemas externos para llamar mediante programación a los endpoints de enriquecimiento, esquema, registros y otros. Consulte la Referencia de la API para ver la documentación de los endpoints.
Aplicaciones que ha autorizado mediante OAuth 2.1: el directorio de conectores de claude.ai, Claude Desktop y las conexiones de Make y n8n. Cada fila es una concesión revocable, no un secreto compartido: revocarla aquí invalida los tokens de esa aplicación sin afectar a sus demás integraciones. Los propietarios también pueden registrar un cliente OAuth para una instancia de n8n autoalojada.
Credenciales del túnel de Ollama de autoservicio, que expone una instancia local de Ollama a la plataforma sin abrir ningún puerto. Consulte la guía Túnel de Ollama.