Tokens de acceso personal para la API de RECON
Crea un token de acceso personal para usar la API de RECON desde tus scripts, elige permisos y caducidad, y rótalo o revócalo cuando haga falta.
- Actualizado el 12 de octubre de 2026
- Verificado en RECON v3.3.0
- 3 min de lectura
- Ver 1:50
Un token de acceso personal permite que tus scripts, tus pipelines de CI y las integraciones que desarrolles llamen a la API de RECON en tu nombre. Esta guía te muestra cómo crearlo, cómo usarlo y cómo rotarlo o revocarlo.
Objetivo
Obtener un token con solo los permisos que necesita tu script, por ejemplo una integración SIEM que lee los escaneos de Meccanica Adda.
Requisitos previos
- Puedes iniciar sesión en RECON con tu cuenta de Orizon. La pestaña está disponible para todos los usuarios, sin roles especiales.
- Tienes un lugar seguro donde guardar el token, como un gestor de contraseñas o el almacén de secretos de tu pipeline.
Procedimiento
Abre API e Integraciones
En RECON, abre Configuración y elige API e Integraciones. En la sección Tokens de acceso personal, pulsa Generar token.
Ponle nombre al token
En Nombre, escribe un nombre fácil de reconocer, por ejemplo "Integración SIEM". El nombre puede tener entre 1 y 100 caracteres.
Elige los permisos
En Permisos ya está marcado Escaneos (lectura). Marca solo lo que de verdad necesitas (consulta la tabla de abajo). Si dejas todos los permisos sin marcar, el token tiene acceso de solo lectura a todas las áreas.
Elige la caducidad
En Caducidad, elige 30 días, 90 días (propuesta por defecto), 1 año o Nunca. Es preferible un token que caduque.
Crea y copia el token
Pulsa Generar. En la ventana Token creado, copia el valor en ese momento: RECON solo guarda un hash del token y no volverá a mostrarlo. Después pulsa Lo guardé de forma segura.
Permisos disponibles
| Permiso | Qué permite |
|---|---|
Perfil (lectura) (me:read) | Leer tu perfil, tu saldo de Cyber Tokens y el uso de la API |
Escaneos (lectura) (scans:read) | Listar y leer escaneos: vulnerabilidades, activos, tecnologías, topología, exportaciones y los demás detalles |
Escaneos (escritura) (scans:write) | Crear y eliminar escaneos |
Sondas (lectura) (probes:read) | Listar y leer tus sondas |
Sondas (escritura) (probes:write) | Crear sondas e iniciar escaneos internos |
| Tokens (lectura) y Tokens (escritura) | Se pueden marcar, pero en esta versión ningún endpoint de la API los exige |
Resultado
El token aparece en la tabla con su Nombre, Prefijo, Permisos y Último uso; del valor solo queda visible el prefijo. Para probarlo, ponlo en la cabecera Authorization después de la palabra Bearer:
curl -H "Authorization: Bearer <TU_TOKEN>" \
https://recon.orizon.one/api/v1/scansRECON responde en JSON con la lista de tus escaneos. En la sección Documentación de la misma página tienes el mismo ejemplo de llamada y el enlace a la Especificación OpenAPI, que enumera todos los endpoints.
Rotar o revocar un token
- Rotar: pulsa Rotar (emitir nuevo valor) junto al token y confirma con Rotar. El valor actual deja de funcionar al instante; el nombre, los permisos y la caducidad no cambian. Copia el nuevo valor y actualiza todos los scripts que usan el token.
- Revocar: pulsa Revocar, escribe el nombre del token para confirmar y pulsa Revocar otra vez. Las llamadas que usan ese token empiezan a fallar de inmediato. Un token revocado sigue en la tabla con la etiqueta Revocado y ya no se puede rotar.
Solución de problemas
- Has perdido el valor del token: no se puede recuperar. Rota el token o crea uno nuevo.
- La API rechaza las llamadas: el token está revocado o caducado, o no tiene el permiso que exige el endpoint. Revisa la tabla y, si hace falta, crea un token con los permisos adecuados.
- "El nombre debe tener entre 1 y 100 caracteres.": acorta el nombre o escribe uno.