Claves de API
Las claves de API permiten que scripts y CI usen la API REST. Crea una en Account settings → API Keys.
- Una clave empieza por
zv_pat_y solo se muestra una vez. Trátala como una contraseña. - Cada clave tiene permisos y se puede limitar a algunos proyectos. Dale a cada clave solo lo que necesita su tarea.
- Ninguna clave puede cambiar tu cuenta (correo, contraseña, claves), crear otras claves ni tocar la facturación, las compras o los miembros del equipo.
- Elige una caducidad de 30, 90 o 365 días, o ninguna. La lista muestra cuándo se usó cada clave por última vez; elimina las que ya no necesites.
curl -H "Authorization: Bearer $ZENAVO_API_KEY" https://zenavo.app/api/projectsPermisos
| Permiso | Puede | No puede | Actúa como |
|---|---|---|---|
| Read only | Ver proyectos, servicios, despliegues, tareas, registros, servidores y uso | Ver valores de configuración (variables de entorno, datos de conexión), cambiar nada | Viewer, como mucho |
| Deploy | Además, desplegar, revertir, reiniciar y reanudar servicios, editar la configuración de un proyecto (incluidas las variables de entorno), subir código, añadir un dominio generado, hacer una copia de seguridad | Abrir un shell o ejecutar comandos, leer o cambiar archivos y filas de bases de datos, descargar o restaurar copias, crear, eliminar, trasladar o detener proyectos, cambiar servidores o cortafuegos | Member, como mucho |
| Full access | Todo lo que puede hacer una clave de API, con tu propio rol | Facturación, comprar o renovar servidores, invitar o quitar miembros, crear, eliminar o transferir equipos | Tu rol |
Una clave nunca tiene más que tu rol en un equipo: una clave Deploy de un Viewer sigue siendo un Viewer. Las claves creadas antes de que existieran los permisos tienen Full access, como antes. Una petición que el permiso de la clave no permite responde 403.
Los registros pueden contener cualquier cosa que impriman tus servicios. Si un servicio imprime secretos, una clave Read only puede verlos.
Limita una clave a algunos proyectos
Elige Only some projects y marca los proyectos. Entonces la clave no ve nada más: las listas de proyectos y tareas solo muestran esos proyectos, los demás responden 404, y todo lo que está fuera de un proyecto (servidores, ajustes del equipo, miembros) responde 403. Tampoco puede eliminar, clonar, trasladar ni transferir sus proyectos, ni siquiera con Full access. Es la opción más segura para un agente de IA o una tarea de CI.
El límite de proyectos se comprueba en cada petición junto con tu rol, así que si dejas el equipo, la clave también pierde el proyecto.
Inicio de sesión de la CLI
zenavo auth login de la CLI crea una clave para la CLI sin copiarla a mano. El terminal muestra un código; abre /device en la consola, escribe el código y apruébalo. Comprueba que el nombre del dispositivo y la red son tuyos: aprueba solo códigos que acabas de pedir tú. La aprobación queda en tu actividad de seguridad. La clave se llama CLI on <hostname>, caduca a los 90 días y aparece en esta lista.
La página de aprobación muestra el permiso que pidió la CLI. Puedes aprobarlo con menos (Read only en vez de Deploy, por ejemplo) y limitarlo a algunos proyectos; nunca puedes darle más de lo que pidió. Las CLI antiguas que no piden un permiso reciben Full access.