API, tokens personales y webhooks

Resumen

Con un token de acceso personal, tus scripts usan la API de RECON; con las integraciones, recibes los eventos de los escaneos en tus propias herramientas. En esta lección, Luca crea un token de solo lectura para una integración SIEM, prueba una llamada a la API y ve cómo añadir un webhook.

Capítulos

Puntos clave

• Los tokens se crean en Configuración, API e Integraciones, sección Tokens de acceso personal, con Generar token.
• Un token nuevo parte del permiso Escaneos (lectura) y de una caducidad de 90 días. El valor se muestra una sola vez: cópialo y pulsa Lo guardé de forma segura. En la tabla solo queda el prefijo.
• El token no es un Cyber Token: es una credencial, como una contraseña.
• En Documentación tienes un ejemplo de llamada y la Especificación OpenAPI, con endpoints para escaneos, vulnerabilidades, activos y sondas. El token va en la cabecera Authorization, después de la palabra Bearer; RECON responde en JSON.
• Para recibir eventos, abre Integraciones y pulsa Añadir integración. Los tipos disponibles son Webhook genérico, Slack, Resumen por email, Jira, ServiceNow, Splunk HEC y Microsoft Sentinel.
• Para un Webhook genérico indicas la URL del receptor, que debe ser una dirección HTTPS pública, y los Eventos a reenviar: Escaneo completado, Escaneo fallido, Escaneo eliminado.
• Al crear la integración, RECON muestra una sola vez la Clave de firma: tu receptor la usa para verificar la firma HMAC-SHA256 de la cabecera X-Orizon-Signature en cada entrega del webhook genérico.
• Probar envía un evento de prueba; Entregas muestra las últimas 50 entregas y Reenviar reintenta una que haya fallado. Puedes tener hasta 50 integraciones.

Transcripción

La transcripción completa del vídeo (en italiano) está en la pestaña Transcripción del reproductor.

Artículos relacionados