ZEITLICHT
Volver al índice

API e integraciones

Crear y revocar claves de API

Quiero …

… dar a la línea de comandos zl, a Claude Code o a una GitHub Action acceso a las tareas de este espacio de trabajo, y quitárselo de nuevo.

Antes de empezar

  • Las claves de API están en beta. Solo los espacios de trabajo que participan en la beta muestran Claves de API.
  • Solo Propietario y Admin ven la entrada. Cada admin ve todas las claves del espacio de trabajo, también las de otros admins, y puede revocar cualquiera.
  • Para crear una clave necesitas tu propio plan Ultra. Sin Ultra puedes seguir viendo y revocando claves.
  • Una clave actúa como tú: lo que una herramienta haga con ella cuenta como un cambio tuyo. Guárdala tan en secreto como una contraseña.
  • Un espacio de trabajo tiene como máximo 10 claves activas, y cada persona como máximo 5.

Así se hace

  1. Abre Ajustes en el espacio de trabajo. En la sección Espacio de trabajo, toca Claves de API (marcada con Beta).
  2. Toca Crear clave de API. Sin Ultra verás en su lugar un aviso y Mejorar. Si se alcanzó el límite, revoca primero una clave.
  3. En Nombre, indica para qué es la clave, por ejemplo «GitHub Actions» o «Mi portátil». Hasta 60 caracteres.
  4. En Tableros, elige Todos los tableros, también los nuevos, o elige Tableros seleccionados y marca al menos un tablero (hasta 30). La clave nunca ve los demás tableros. Las etiquetas y los temas pertenecen a todo el espacio de trabajo, así que solo una clave para todos los tableros puede crearlos, y solo una clave así ve los correos de los miembros.
  5. En Permisos, elige Solo lectura, Lectura y escritura o Acceso total. Lectura y escritura permite todo menos eliminar tareas. Acceso total añade Eliminar tareas.
  6. Para un control más fino, toca Avanzado y marca permisos sueltos: Leer tareas (Siempre incluido), Crear y editar tareas, Asignar personas, Editar listas, Escribir comentarios, Subir adjuntos, Completar pruebas (Instrucciones, quienes prueban y fallos) y Eliminar tareas. Una combinación que no coincide con ningún nivel aparece como Personalizado.
  7. En Válida durante, elige 30 días, 90 días, 180 días o 365 días. Debajo ves cuándo caduca la clave. Toda clave tiene fecha de fin.
  8. Escribe tu Contraseña actual y toca Crear clave. Con una contraseña incorrecta, el diálogo sigue abierto.
  9. Copia tu clave de API muestra la clave una sola vez. Toca Copiar, guárdala en un gestor de contraseñas o como secreto en tu CI y toca Hecho. Si no la copiaste, Zeitlicht pregunta antes. Cerrar de todos modos cierra el diálogo, y la clave ya no se puede volver a mostrar.
  10. La clave nueva aparece en Activas con su nombre, quién la creó, sus permisos, sus tableros y cuándo se creó, se usó por última vez y caduca. En sus últimos 7 días el estado dice Caduca en … días, luego Caduca mañana y Caduca hoy.
  11. Para terminar una clave, toca Revocar en su fila y confirma con Revocar. Todo lo que use la clave pierde el acceso al instante.
  12. En una emergencia, toca Revocar todas las claves abajo y confirma con Revocar todas las claves. Ninguna clave activa del espacio de trabajo sigue funcionando, tampoco las de otros admins.
  13. Las claves revocadas y caducadas pasan a Revocadas y caducadas, con quién las revocó y por qué. Desliza la lista hacia abajo para actualizarla.

El resultado

La clave actúa como tú, en los tableros y con los permisos que elegiste, hasta que caduca o alguien la revoca. Cada vez que se crea una clave, se envía un correo a ti y al propietario del espacio de trabajo. Siete días antes de que caduque una clave, la persona que la creó recibe un único correo de aviso con el botón Abrir claves de API.

Preguntas frecuentes

Perdí una clave. ¿Puedo verla de nuevo?

No. Zeitlicht solo guarda una huella de la clave. Revócala y crea una nueva.

¿Por qué una clave dice Inactiva?

La persona que la creó ya no tiene Ultra o ya no es admin, o el acceso a la API está desactivado en el espacio de trabajo. La fila indica el motivo. Cuando esa persona vuelve a tener Ultra, la clave vuelve a funcionar.

¿Qué pasa cuando un admin pasa a ser miembro, se va o queda en pausa?

Las claves de esa persona en este espacio de trabajo se revocan para siempre, aunque más tarde vuelva a ser admin.

¿Cómo amplío la validez de una clave?

No se puede. Crea una clave nueva, cambia tu herramienta a ella y revoca después la antigua. El correo de aviso una semana antes del final es un buen momento para hacerlo.

Cambié mi contraseña. ¿Siguen funcionando mis claves?

Sí. Una contraseña nueva no termina ninguna clave. Si crees que una clave se ha filtrado, revócala o usa Revocar todas las claves.

Recibí un correo sobre una clave que no conozco.

Abre Claves de API enseguida y revócala. Después cambia tu contraseña.

Temas relacionados