Gestión de API Keys
La página de API Keys te permite crear, ver y administrar las claves que tus aplicaciones usan para llamar a la API de FourA.
Ver tus claves
La página muestra cada clave a la que tienes acceso:
- Claves personales que creaste directamente.
- Claves de organización si eres propietario o administrador de una organización, o si una clave que te pertenece ha sido transferida a una de tus organizaciones.
Cada fila de la tabla muestra:
| Columna | Qué muestra |
|---|---|
| Nombre | Nombre visible y descripción (opcional) |
| Clave | Prefijo oculto (por ejemplo, pk_live_••••••••) con un botón Reveal al lado |
| Propietario | Personal para claves personales, o el nombre de la organización para claves de organización |
| Estado | Activo o Inactivo |
| Creado | Cuándo se creó la clave |
| Último uso | Cuándo hizo una request la clave por última vez |
Usa el cuadro de búsqueda para filtrar por nombre o descripción, y el filtro de estado para mostrar solo claves activas o inactivas. Todos los encabezados de las columnas se pueden ordenar.
Crear una clave
Haz clic en Create Key y completa:
| Campo | Requerido | Descripción |
|---|---|---|
| Nombre | Sí | Una etiqueta descriptiva (por ejemplo, "production-scraper" o "staging-test") |
| Descripción | No | Notas sobre para qué se usa esta clave |
| Propietario | Sí, si estás en una organización | Personal, o una de las organizaciones a las que perteneces. El selector solo aparece cuando tienes al menos una organización. |
La clave completa se muestra una vez justo después de la creación en un diálogo listo para copiar. También puedes recuperarla más tarde mediante Reveal (ver abajo).
Las claves usan el prefijo pk_live_ y se ven como pk_live_a1b2c3d4e5f6.... Recibirás un correo electrónico de confirmación cuando se cree una nueva clave.
Revelar una clave
Haz clic en el ícono del ojo junto al prefijo oculto de una clave para ver su secreto completo nuevamente. El dashboard te pide que confirmes, luego abre un diálogo con la clave en texto plano, un botón de copiar y una breve cuenta regresiva. Después de la cuenta regresiva, el diálogo borra el secreto de la página.
Cada revelación se registra en el log de auditoría porque expone una credencial activa.
Claves heredadas
Las claves creadas antes del lanzamiento de la función de revelar muestran un ícono de candado en lugar del ojo y no se pueden revelar. Solo se almacenó su hash, por lo que el secreto original es irrecuperable. Para cambiar una clave heredada, haz clic en el menú de acciones y elige Regenerate. A partir de ese momento, el nuevo secreto se puede revelar.
Quién puede revelar
| Rol | Puede revelar |
|---|---|
| Propietario de la clave | Sí |
| Propietario o administrador de la organización (para claves de organización) | Sí |
| Cualquier otra persona | No |
Editar una clave
Haz clic en Edit en cualquier fila para actualizar el nombre visible y la descripción. La propiedad (personal frente a organización) no se cambia aquí. Usa Transfer a continuación para mover una clave entre propietarios.
Activar y desactivar
Usa el botón Disable / Enable en la fila para alternar el estado de una clave. Desactivar una clave bloquea todas las requests de la API que la usan. Puedes reactivarla en cualquier momento. El cambio surte efecto en cuestión de segundos.
Regenerar una clave
Si sospechas que una clave se ha visto comprometida, abre el menú de acciones (el botón de tres puntos) y elige Regenerar. Esto crea un nuevo secreto para el mismo ID de clave. El secreto anterior deja de funcionar de inmediato. El nombre, la asignación a la organización y otras configuraciones se mantienen igual.
El nuevo secreto puede seguir revelándose después de que se cierre el cuadro de diálogo, por lo que no es necesario que lo copies perfectamente al primer intento.
Transferir una clave
Cada fila tiene una acción Transferir en el menú. Úsala para mover la propiedad de una clave entre personal y de la organización sin regenerar el secreto. El ID de la clave, sus métricas y su historial de actividad se conservan; solo cambia el propietario.
Casos comunes:
- Mover una clave personal que creaste para un proyecto compartido a la organización para que un compañero de equipo pueda administrarla después de ti.
- Reasignarte una clave de la organización si el proyecto se independiza.
Puedes transferir una clave de tu propiedad (personal) a cualquier organización donde seas propietario o administrador, y puedes transferir una clave de organización que administras a ti mismo o entre organizaciones que administras.
Eliminar una clave
Abre el menú de acciones y elige Eliminar. Al eliminar una clave que has usado antes se realiza un borrado lógico: la clave deja de autenticar, pero su historial de actividad y métricas permanece intacto. Las claves que nunca se han usado se pueden eliminar de forma definitiva.
Recibirás una notificación por correo electrónico cuando se elimine una clave.
Claves de organización
Las claves que pertenecen a una organización son visibles para los propietarios y administradores de la organización. Los miembros sin rol de propietario o administrador no las ven.
El uso de una clave que pertenece a la organización se descuenta del plan del propietario de la organización.
Relacionado
- Autenticación: Cómo funcionan las claves de API con la API
- Organizaciones y equipos: Configurar el acceso compartido
- Resumen del panel de control: Todas las secciones del panel de control