Claves de API

¿Qué es una clave de API?

Una clave de API es un par de credenciales (Client ID y Client Secret) que tus aplicaciones usan para autenticarse con la API de Imara. Cada clave es independiente: puedes crear una para cada sistema o servicio que necesite acceso.

¿Cuántas claves puedo crear?

El límite depende de tu plan:

• Free: Sin acceso a la API (no puedes crear claves)
• Starter: Acceso a la API disponible, sin límite fijo de claves básicas
• Professional: Hasta 5 claves de API activas simultáneamente
• Enterprise: Hasta 20 claves de API activas simultáneamente

Imara cuenta solo las claves activas. Las claves que hayas revocado no cuentan para el límite.

Cómo crear una clave de API

1. Inicia sesión en el panel de cliente de Imara
2. Ve a Configuración → Claves de API
3. Haz clic en Nueva clave
4. Ingresa un nombre descriptivo (por ejemplo: "Automatización CI/CD" o "Dashboard Interno")
5. Selecciona los permisos (scopes) que necesita esta clave
6. Haz clic en Crear

⚠️ Importante: El Client Secret solo se muestra una vez, en el momento de la creación. Guárdalo en un lugar seguro (como un gestor de contraseñas o un vault de secretos). Si lo pierdes, deberás crear una nueva clave.

Cómo revocar una clave

Si una clave ya no es necesaria o sospechas que fue comprometida, puedes revocarla:

1. Ve a Configuración → Claves de API
2. Encuentra la clave que deseas eliminar
3. Haz clic en Revocar

Una clave revocada deja de funcionar de inmediato. Cualquier aplicación que la use recibirá un error de autenticación hasta que actualices las credenciales.

¿Qué pasa si alcanzo el límite?

Si tu plan ya no permite crear más claves activas, Imara te mostrará un aviso indicando que has alcanzado el límite. Para obtener más claves tienes dos opciones:

• Revocar claves que ya no uses para liberar espacio
• Actualizar tu plan a Professional o Enterprise para un mayor límite

Si necesitas un límite personalizado, contacta a nuestro equipo de ventas para hablar sobre opciones Enterprise.

Buenas prácticas

• Usa una clave distinta para cada sistema o entorno (producción, staging, etc.)
• Nunca compartas el Client Secret ni lo incluyas en código fuente
• Revoca claves que ya no uses regularmente
• Ponle nombres descriptivos a tus claves para identificarlas fácilmente