> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirespeed.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Upwind

> Ingestar detecciones de amenazas de nube y carga de trabajo de Upwind como detecciones y eventos de amenaza como registros

Para integrar Upwind, cree credenciales de cliente de API en la consola de Upwind y facilítelas a Wirespeed junto con el ID de su organización y el host de API regional.

## Requisitos previos

* Una cuenta de Upwind que pueda crear credenciales de cliente de API (un client ID y un client secret)
* Acceso de cliente de API para leer detecciones de amenazas y eventos de amenaza, y para actualizar detecciones de amenazas salvo que la integración sea de **Solo lectura**
* El ID de organización de Upwind, por ejemplo `org_Xk9mPq7RtYwN2vLs`
* El host de API de su región de Upwind:

| Región | Host de API |
| - | - |
| US | `api.upwind.io` |
| EU | `api.eu.upwind.io` |
| Middle East | `api.me.upwind.io` |

## Crear credenciales de API

1. Inicie sesión en la consola de Upwind
2. Vaya a **Settings** > **Access Management** y abra la pestaña **Credentials**
3. Haga clic en **Generate Credential**
4. Elija **API** como tipo de credencial y conserve el nombre generado automáticamente o introduzca uno descriptivo como `Wirespeed`
5. Copie el **Client ID** y el **Client Secret**. Es posible que el secreto solo se muestre una vez

## Añadir la integración en Wirespeed

1. En Wirespeed, vaya a **Integraciones** > [**Añadir integración**](https://app.wirespeed.co/settings/integrations?tab=browse) > **Upwind**
2. Compruebe el **API Host**. El valor predeterminado es `api.upwind.io` (US); cámbielo si su organización está en la región EU o ME
3. Introduzca su **Organization ID**, **Client ID** y **Client Secret**
4. Envíe la integración

Wirespeed comprueba las credenciales, la región y el ID de organización al guardar. Un token emitido para una región es rechazado por las demás, por lo que el host de API debe coincidir con la región de su organización de Upwind.

## Qué ingesta Wirespeed

| Origen | API de Upwind | Finalidad |
| - | - | - |
| Detecciones de amenazas | `GET /v1/organizations/{organization-id}/threat-detections` | Detecciones con el recurso y la cuenta en la nube afectados, contexto MITRE ATT\&CK, y los procesos, archivos, pares de red de mala reputación y principales de registro de auditoría o CloudTrail de cada activación |
| Eventos de amenaza | `GET /v1/organizations/{organization-id}/threat-events` | Ejecuciones de procesos, actividad de archivos malintencionados, actividad de red de mala reputación, eventos de auditoría de Kubernetes y de la nube, eventos de CloudTrail y pruebas de violación de amenazas, almacenados como registros |

Wirespeed consulta las detecciones según cuándo las vio Upwind por última vez, empezando por las 24 horas anteriores. Una detección que se repite después de que Wirespeed la ingestara no se vuelve a ingestar.

Wirespeed consulta los eventos de amenaza según cuándo los vio Upwind por primera vez, empezando por las 24 horas anteriores. Los eventos se leen unos dos minutos después de que Upwind los vea por primera vez. Si una consulta falla a mitad de camino, la siguiente vuelve a leer ese intervalo de tiempo, por lo que algunos eventos pueden almacenarse dos veces.

## Actualizaciones de detecciones

Cuando se completa una detección, Wirespeed archiva la detección de amenaza de Upwind. Upwind no tiene API para comentarios, así que los comentarios del analista permanecen en Wirespeed. Para impedir el archivado, active **Solo lectura** en las opciones avanzadas al añadir la integración; no se puede cambiar después.

## Limitaciones actuales

* Las acciones de contención y remediación no están disponibles
* Reabrir una detección no desarchiva la detección de amenaza de Upwind
* Las detecciones no se escalan hasta que se definan reglas de categorización de Upwind


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.