API Claves

API se gestionan a nivel de organización con control de acceso basado en roles (RBAC). Cada clave puede asignarse un rol organizativo y roles opcionales por aplicación, lo que te da un control fino sobre qué cada clave puede acceder.

¿Dónde se gestionan las claves API?

Navegue a Configuración > Organización > Claves API en consola.capgo.app/configuración/organización/api-llaves.

La página muestra dos secciones:

• Llaves RBAC — Llaves con roles asignados (recomendado). Estas llaves utilizan el nuevo sistema de permisos basado en roles.
• Llaves de legado — Llaves más antiguas que utilizan el sistema de modo simple (read, upload, write, all) sin asignaciones de roles.

¿Cómo crear una nueva llave API?

1. Haga clic en el ”+” botón en la parte superior de la tabla de llaves RBAC.

2. Rellene el Información clave:

   • Nombre (obligatorio) — Una etiqueta descriptiva para la clave (por ejemplo, “Despliegue CI/CD”, “Consulta de monitoreo de solo lectura”).
   • Crear clave segura (opcional) — Cuando se marca, la clave se cifrará en el lado del servidor. La clave en texto plano se muestra solo una vez después de la creación. No podrás recuperarla más tarde.
   • Establecer fecha de caducidad (opcional) — Selecciona una fecha después de la cual la clave dejará de funcionar. Algunas organizaciones imponen una caducidad obligatoria mediante política.

3. Seleccionar un Rol de la organización — Esto define las permisos básicos de la clave en toda la organización. Roles disponibles (dependiendo del nivel de rol propio):

   • Ninguno — Sin acceso organizacional; la clave solo tiene acceso a aplicaciones asignadas individualmente.
   • Miembro — Acceso de lectura básico a la organización.
   • Administrador — Acceso administrativo completo a la organización (hereda acceso a todas las aplicaciones).

4. Si la clave necesita crear organizaciones a través del API público, habilite Permitir la creación de organizaciones.

   Esta agrega el permiso global. org.create Está disponible cuando la clave tiene un rol de administrador de organización. Cuando esta clave crea una nueva organización, Capgo asigna automáticamente la clave como Super Administrador en esa nueva organización.

5. Si el rol de la organización seleccionado no es Admin, puede agregar acceso por aplicación:

   • Haga clic ”+ Agregar Aplicación” para abrir el selector de aplicaciones.
   • Seleccione una o más aplicaciones, luego asigne un rol a cada una:
     • Lector de Aplicación — Acceso de solo lectura a la aplicación.
     • Subidor de Aplicación — Puede subir nuevos paquetes.
     • Desarrollador de Aplicación — Puede gestionar la configuración y las implementaciones de la aplicación.
     • Administrador de Aplicación — Acceso completo a la aplicación.

6. Hacer clic “Crear”.

7. Si seleccionó “Crear clave segura”, se mostrará un modal con la clave en texto plano. Copiarla inmediatamente — no se puede recuperar después de cerrar el modal.

¿Cómo gestionar (editar) una clave API?

Hacer clic ícono de llave inglesa (Administrar) en cualquier clave de RBAC en la lista. Esto abre la página de detalles de la clave donde puedes:

• Cambiar la clave nombre.
• Actualizar el rol de organización.
• Habilitar o deshabilitar Permitir crear organizaciones cuando la clave tiene un rol de organización de Administrador.
• Agregar, eliminar o cambiar roles por aplicación.

Hacer clic Save Changes cuando estés listo.

¿Cómo regenerar una clave API?

Para regenerar el valor secreto de una clave API, haz clic en el ícono de refresco (Regenerar) en cualquier clave de la lista.

Se aparecerá un diálogo de confirmación. Después de confirmar:

• Para claves seguras (hasheadas): Se genera y se muestra una nueva clave de texto plano en una ventana modal. Cópiala inmediatamente.
• Para llaves planas: El valor de la llave se regenera en el lado del servidor.

Cualquier integración que utilice el valor de la llave antiguo dejará de funcionar de inmediato.

¿Cómo eliminar una llave API?

Haga clic en el ícono de la papelera (Eliminar) en cualquier llave de la lista. Confirme la eliminación en el diálogo.

La llave se revoca de inmediato — cualquier solicitud que la utilice fallará.

Claves heredadas

Si ve claves en el Claves heredadas sección (claves sin asignaciones de rol), estas usan el sistema de permisos basado en modo (read, upload, write, all). Aún funcionan pero no se benefician de las permisos de RBAC finamente detallados.

Las claves heredadas pueden ser regeneradas y eliminadas de la lista, pero no pueden ser editadas para agregar roles de RBAC. Se recomienda crear nuevas claves de RBAC y eliminar claves heredadas cuando sea posible.

Si necesita gestionar claves heredadas directamente, aún puede acceder a ellas en console.capgo.app/dashboard/apikeys. Esta página está descontinuada y se eliminará en una actualización futura.

Siga adelante desde API Claves

Si está utilizando API Claves para planificar la consola y las API operaciones, conecte con API Resumen para obtener detalles de implementación en API Resumen, Introducción para obtener detalles de implementación en Introducción, API Claves para obtener detalles de implementación en API Claves, Dispositivos para obtener detalles de implementación en Dispositivos, y Paquetes para los detalles de implementación en Bundles.