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.

Jun 26, 2026

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).

  1. Abre API Keys y entra a la clave (botón Editar).
  2. Haz clic en Regenerar.
  3. 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).
  4. 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.

  1. En el listado API Keys, ubica la clave.
  2. 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

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp