vulnmatter-extension/USAGE.md

VS Code extension for CVE vulnerability analysis using the VulnMatter API with X-API-Key. See CHANGELOG.md for release notes.

# VulnMatter Extension - Configuración

## Ubicación de la X-API-Key

La extensión guarda automáticamente tu X-API-Key en:

**Windows:** `C:\Users\[tu-usuario]\.vulnmatter\config.json`
**Linux/Mac:** `/home/[tu-usuario]/.vulnmatter/config.json`

## Ejemplo de archivo de configuración:

```json
{
  "apiKey": "tu-x-api-key-aquí",
  "timestamp": "2025-09-12T14:30:00.000Z",
  "userPath": "C:\\Users\\jeffr"
}
```

## Uso de la X-API-Key

La extensión utiliza la X-API-Key en las peticiones HTTP con el header:
```
X-API-Key: tu-x-api-key-aquí
```

## Ejemplos de CVE para probar:

- CVE-2023-44487 (HTTP/2 Rapid Reset)
- CVE-2023-38545 (curl SOCKS5 heap buffer overflow)
- CVE-2024-21413 (Microsoft Outlook Remote Code Execution)
- CVE-2024-3094 (XZ Utils backdoor)
- CVE-2023-4911 (GNU/Linux ld.so privilege escalation)

## Funcionalidades disponibles:

1. **Configuración de X-API-Key**: Se guarda en el directorio del usuario actual
2. **Análisis de CVEs**: Obtiene puntuaciones de riesgo
3. **Generación de reportes**: Crea reportes comprehensivos
4. **Validación automática**: Verifica formato CVE-YYYY-NNNN
5. **Interfaz visual**: Códigos de color según nivel de riesgo