Alcance (scopes), vencimiento, rotar y revocar tokens
Controla qué puede hacer cada clave API: limita permisos con scopes, ponle fecha de vencimiento, rótala o revócala cuando ya no la necesites.
Mira este paso en el video · Alcances: qué puede hacer la clave
Una vez que sabes crear una clave API, el siguiente paso es manejar su ciclo de vida con seguridad: darle solo los permisos necesarios, hacerla caducar, rotarla periódicamente y revocarla cuando deje de usarse.
Scopes (alcance de permisos)
Los scopes definen qué operaciones puede hacer la clave. En el editor están agrupados:
- Contactos:
read:contacts,write:contacts - Mensajes:
read:messages,write:messages(enviar mensajes) - Canales:
read:channels - CRM:
read:crm,write:crm - Proyectos:
read:projects,write:projects - Webhooks:
manage:webhooks - Acceso total:
admin(todos los scopes)
Si no marcas ningún scope, la clave queda con acceso total (equivale a
*). Por seguridad, marca únicamente los permisos que la integración necesita: principio de mínimo privilegio.
Vencimiento
En Expira el puedes fijar fecha y hora. Al llegar ese momento la clave deja de autenticar automáticamente. Si lo dejas vacío, la clave no caduca hasta que la borres. Recomendamos vencimientos para credenciales de terceros o pruebas.
Rotar una clave (Regenerar)
Rotar significa reemplazar el secreto manteniendo la misma configuración (nombre, scopes, workspace, vencimiento).
- Abre API Keys y entra a la clave (botón Editar).
- Haz clic en Regenerar.
- Se anula la clave anterior y se emite una nueva. Copia el nuevo valor en la ventana "Copia y guarda ahora" (se muestra una sola vez).
- Actualiza la integración con el nuevo token.
Importante: al regenerar, la clave anterior deja de funcionar de inmediato. Coordina el cambio para no cortar el servicio.
Revocar (eliminar)
Omnifox no tiene un estado "inactiva": revocar = eliminar.
- En el listado API Keys, ubica la clave.
- Haz clic en Eliminar y confirma.
La clave deja de autenticar al instante y no se puede recuperar.
Buenas prácticas
- Rota las claves productivas cada cierto tiempo (por ejemplo, cada 90 días).
- Revoca de inmediato cualquier clave que sospeches comprometida.
- Una clave por integración, con scopes mínimos y un nombre claro.
Si no funciona
- Mi integración dejó de funcionar tras regenerar: sigue usando el token viejo. Carga el nuevo valor.
- No veo el botón Regenerar/Eliminar: necesitas el permiso Claves API: gestionar.
Artículos relacionados
Artículos relacionados
-
Cómo conectar integraciones y apps externas
Conecta Omnifox con tus herramientas favoritas desde el catálogo de integraciones en pocos pasos.
-
Guía completa de integraciones y API
Integraciones y API a fondo, en 30 capítulos: claves API, llamadas reales, webhooks firmados, n8n, MCP y SDK, todo funcionando de verdad.
-
Integrar Omnifox con Azur, Siigo, Alegra, QuickBooks u otro sistema contable o ERP
Omnifox no tiene hoy un conector nativo con sistemas contables o ERP. Te explicamos cómo conectarlos igual con workflows, el nodo HTTP, n8n, Make, Zapier o la API, con ejemplos.
-
Generar y usar API keys y webhooks
Crea claves de API para acceder a Omnifox por código y configura webhooks para recibir eventos en tiempo real.
-
Introducción a las integraciones (webhook / OAuth / API key)
Conecta Omnifox con tus otras herramientas: qué está disponible hoy, qué llega pronto y cuándo usar un webhook, una conexión OAuth o una clave de API.