> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/es/pam/administration/assets/discovery-aws.md).

# Descubrir activos en AWS

Importe las instancias EC2 de una cuenta de AWS como activos y mantenga el inventario sincronizado, con el permiso IAM, el acceso de red y las políticas.

## Qué es y cuándo usarlo

Una cuenta de descubrimiento **AWS** lista las instancias EC2 de una cuenta de AWS, región por región, y convierte cada una en un activo del inventario: nombre, dirección, plataforma, protocolos y carpeta. Las ejecuciones siguientes actualizan esos activos y marcan las instancias que dejaron de existir.

Úsela cuando los servidores se crean y se destruyen en AWS más rápido de lo que alguien puede registrarlos a mano, y manténgala programada para que el inventario siga a la nube. La mecánica general del descubrimiento, común a todos los proveedores, está en [Descubrir activos en la red](https://wiki.datadike.com/es/pam/administration/assets/discovery.md). Esta página trata lo que es propio de AWS.

## Antes de empezar

### La credencial de AWS

* **Un usuario IAM dedicado, con clave de acceso**: un **Access Key ID** y una **Secret Access Key**. Nunca la clave del usuario root, y nunca una clave que también use una persona.
* **Basta con un permiso: `ec2:DescribeInstances`.** Es la única llamada a AWS que hace el descubrimiento. Sirve tanto para probar la clave como para listar las instancias, y todos los atributos que se leen (etiqueta de nombre, plataforma, IP privada y pública) llegan en su respuesta. La lista de regiones no requiere permiso: viene con el producto.
* El formulario solo acepta el par de claves. Las credenciales temporales, que además requieren un token de sesión (AWS SSO, un rol asumido), no se pueden usar, y no hay un rol que asumir en otra cuenta. Registre una cuenta de descubrimiento por cada cuenta de AWS.
* La tarjeta **AWS** cubre las regiones comerciales de AWS. Las regiones de AWS China y de AWS GovCloud no están en su lista.

La política mínima, de solo lectura:

```json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "DataDikePamDiscoverEc2",
      "Effect": "Allow",
      "Action": "ec2:DescribeInstances",
      "Resource": "*"
    }
  ]
}
```

`DescribeInstances` no admite restricciones por recurso, así que `Resource` queda en `"*"`. Para limitar la clave a las regiones que realmente usa, agregue una condición sobre `aws:RequestedRegion`:

```json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "DataDikePamDiscoverEc2",
      "Effect": "Allow",
      "Action": "ec2:DescribeInstances",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:RequestedRegion": ["us-east-1", "sa-east-1"]
        }
      }
    }
  ]
}
```

Una región que la clave no tiene permiso para leer, o una región que no está habilitada en la cuenta de AWS (las regiones opt-in), no detiene la sincronización: aparece como no válida en el registro de la ejecución y se omite, y sus instancias no se importan. Seleccione en DataDike PAM solo las regiones que la clave puede leer (paso 3).

**Rote la clave** con la frecuencia que fije su política de seguridad, por ejemplo cada 90 días. IAM permite dos claves activas por usuario, lo que hace la rotación transparente:

1. Cree la segunda clave para el mismo usuario IAM.
2. En DataDike PAM, actualice la cuenta de descubrimiento con el nuevo **ID de la clave de acceso** y la nueva **Clave de acceso secreta** y haga clic en **Guardar**. Guardar una clave nueva no la prueba.
3. Haga clic en **Ejecutar** (paso 5) y compruebe que las regiones se listan sin errores.
4. Desactive la clave anterior en IAM y elimínela cuando nada haya fallado.

### La red

* El servidor de DataDike PAM debe alcanzar el endpoint EC2 de cada región seleccionada por **HTTPS, puerto 443**: `ec2.<región>.amazonaws.com`, por ejemplo `ec2.us-east-1.amazonaws.com`. No se llama a ningún otro endpoint de AWS.
* La pantalla Descubrir no tiene un ajuste de proxy de salida. Donde el servidor solo sale de la red a través de un proxy, eso es un ajuste de la implantación, que se define con el soporte de implantación de DataDike.
* El reloj del servidor debe estar en hora. AWS rechaza las solicitudes firmadas con un reloj desviado más de unos cinco minutos.

### Cómo llegar a las instancias después

El descubrimiento registra las instancias; no abre un camino hacia ellas. Decida antes de la primera ejecución qué dirección usarán las sesiones:

* **IP privada** (la predeterminada). El servidor necesita una ruta hacia la VPC, como una VPN, Direct Connect o peering, o los activos necesitan un proxy con un gateway dentro de la VPC. Una política de sincronización puede asociar los activos a ese proxy (paso 4). Consulte [Gateways](https://wiki.datadike.com/es/pam/administration/connectivity/gateways.md).
* **IP pública**. Los security groups de las instancias deben permitir el puerto de la sesión (22 para SSH, 3389 para RDP) desde la dirección pública del servidor de DataDike PAM. Una instancia sin IP pública se registra con su IP privada.

### En DataDike PAM

* El perfil **SYSADMIN**, el rol **Org Admin** o un rol con los permisos de **Importación en la nube**, que están junto a los permisos de activos en el editor de roles. Consulte [Roles y permisos](https://wiki.datadike.com/es/pam/administration/identities/roles.md).
* Una licencia válida. Todas las funciones de Descubrir la comprueban, y sin ella no se puede activar **Periódico**.
* Opcional pero recomendable: la plataforma, la carpeta, el proxy y las plantillas de cuenta que deben recibir las instancias, creados de antemano.

## Pasos

### 1. Cree la política IAM, el usuario y la clave de acceso

Hágalo en la cuenta de AWS, como administrador de IAM. Con la AWS CLI, guarde la política anterior como `datadike-pam-discover-ec2.json` y ejecute:

```bash
aws iam create-policy \
  --policy-name DataDikePamDiscoverEc2 \
  --policy-document file://datadike-pam-discover-ec2.json

aws iam create-user --user-name datadike-pam-discover

aws iam attach-user-policy \
  --user-name datadike-pam-discover \
  --policy-arn arn:aws:iam::111122223333:policy/DataDikePamDiscoverEc2

aws iam create-access-key --user-name datadike-pam-discover
```

Sustituya `111122223333` por el ID de la cuenta de AWS. El último comando devuelve el **AccessKeyId**, como `AKIAIOSFODNN7EXAMPLE`, y la **SecretAccessKey**. El secreto se muestra una sola vez: guárdelo en un lugar seguro hasta el paso 2. En la consola de IAM el resultado es el mismo: una política con el JSON anterior, un usuario sin acceso a la consola con esa política asociada y una clave de acceso creada en **Security credentials**.

### 2. Registre la cuenta de AWS en Descubrir

1. Abra **Entorno › Descubrir** y vaya a **Seleccionar proveedor**.
2. Haga clic en **AWS**. El formulario **Crear una cuenta en la nube** se abre en un panel lateral.
3. **Básico**: dé un **Nombre** a la cuenta, por ejemplo `aws-produccion`. La **Plataforma** viene rellenada como *AWS* y es de solo lectura.
4. **AWS**: rellene **ID de la clave de acceso** con el AccessKeyId y **Clave de acceso secreta** con la SecretAccessKey.
5. **Otro**: una **Descripción** opcional.
6. Haga clic en **Confirmar**.

Al **Confirmar**, la clave se prueba en las regiones, una por una, hasta que alguna responde. Una clave válida se acepta en pocos segundos. Una clave rechazada solo se informa después de probar todas las regiones, lo que puede tardar algunos minutos. La cuenta nueva aparece en **Cuentas** con todas las regiones seleccionadas.

### 3. Elija las regiones

La cuenta empieza con todas las regiones de la lista seleccionadas, incluidas las que su cuenta de AWS no usa. Acote la selección:

1. En **Cuentas**, haga clic en la tarjeta de la cuenta de AWS y, en el panel, haga clic en **Actualizar**.
2. En **Fuente de sincronización**, haga clic en el enlace de **Región**, que muestra **Editar \[n]**.
3. Marque las regiones donde se ejecutan sus instancias. El cuadro de búsqueda y los filtros por continente ayudan en la lista larga. Cierre la ventana con **Confirmar**.
4. Haga clic en **Guardar**. La clave se vuelve a probar en las regiones seleccionadas.

{% hint style="warning" %}
Quitar una región que ya se sincronizó hace que sus instancias cuenten como liberadas en la ejecución siguiente. Con **Liberar activos** activado, sus activos se eliminan del inventario.
{% endhint %}

### 4. Defina cómo las instancias se convierten en activos

Las políticas de sincronización son comunes a todas las cuentas de descubrimiento. Cree una para AWS en la pestaña **Sincronizar política**: haga clic en **Crear** y rellene:

1. **Básico**: un **Nombre** y la **Prioridad** (de 1 a 100, 50 por defecto; gana el número más bajo).
2. **Condición**: qué instancias abarca la política. **Condiciones de relación** es **Y** u **O**. Cada línea combina **Nombre del atributo**, **Coincidencia** y **Valor del atributo**, y se añade con **Agregar**. En AWS:
   * **Nombre de la instancia** es la etiqueta `Name` de la instancia
   * **Nombre de la plataforma de la instancia** es `windows` en las instancias Windows y queda vacío en las demás
   * **Dirección de la instancia** son las direcciones IP de la instancia
   * **Igual a** con el valor `*` coincide con cualquier valor
3. **Acción**: lo que reciben las instancias que coinciden, una línea por **Tipo de recurso** con sus **Recursos**, añadida con **Agregar**:
   * **Plataforma**, con la lista de **Protocolo** y los puertos que reciben los activos
   * **Carpeta**, donde se archivan los activos
   * **Puerta de enlace**, el proxy a través del cual se llega a los activos
   * **Plantillas**, plantillas de cuenta convertidas en cuentas en cada activo
4. Haga clic en **Confirmar**.

Después, en **Cuentas**, abra la cuenta de AWS y, en la pestaña **Básico** del panel:

1. En la sección **Estrategia**, seleccione la política y haga clic en **Agregar**.
2. En **Actualización rápida**, ajuste **Tipo de IP** a **IP privada** o **IP pública**. El otro tipo se usa cuando la instancia no tiene el elegido.
3. Deje **Liberar activos** desactivado en las primeras ejecuciones.

### 5. Ejecute la primera sincronización

Hay dos formas de ejecutarla, y se comportan de manera distinta:

* **Sincronizar**, en la tarjeta o en el panel, abre **Sincronización en línea**. Lee las regiones de una en una y lista las instancias que todavía no están en el inventario, con **Nombre**, **Dirección**, **Plataforma**, **Carpeta**, **Protocolo** y **Región**. Marque las que quiera y haga clic en **Subir** para importarlas. Si la cuenta no tiene ninguna política asociada, antes se le asocia la política integrada `default`. Use esta forma en la primera importación, para revisar antes de que se cree nada.
* **Ejecutar**, en **Actualización rápida › Ejecución manual**, realiza la sincronización completa en segundo plano y abre su registro. Crea y actualiza activos sin preguntar, y marca las instancias que desaparecieron. Necesita una política asociada a la cuenta: sin ninguna, todas las instancias terminan como **No sincronizado**.

### 6. Prográmela

1. En **Actualización rápida › Ejecución manual**, haga clic en **Editar**.
2. Active **Periódico** y elija el **Tipo**:
   * **Intervalo**, en horas, por ejemplo `24`
   * **Crontab**, una expresión de cinco campos, por ejemplo `0 3 * * *` para todos los días a las 03:00
3. Guarde el formulario.

La ejecución programada se comporta como **Ejecutar**.

## Lo que debe ver

![La pantalla Descubrir, con las cuentas de descubrimiento registradas](https://162891664-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fs5AnPAmUmMC3tSpoBhHY%2Fuploads%2Fgit-blob-b55964a35e46df218bcc5d854266ca552918bba9%2Fdiscover.png?alt=media)

**1** Cuántas cuentas de descubrimiento existen. **2** El catálogo de proveedores, donde se registra una cuenta nueva.

La tarjeta de la cuenta de AWS muestra cuántas regiones cubre y cuántos activos ha producido. Después de una ejecución:

* Cada instancia es un activo, con el nombre de su etiqueta `Name`, o `untitled` cuando la instancia no tiene esa etiqueta. Cuando otro activo ya tiene ese nombre, se le añaden los cuatro últimos caracteres del ID de la instancia. Los activos importados con **Sincronización en línea** reciben un sufijo de ocho caracteres, que el siguiente **Ejecutar** sustituye por el nombre de la instancia.
* La dirección es la IP del **Tipo de IP** elegido, o la del otro tipo cuando la instancia no tiene el elegido.
* Sin una acción de **Plataforma**, las instancias Windows reciben la plataforma **Windows** con RDP en el 3389, y las demás reciben **Linux** con SSH en el 22.
* Sin una acción de **Carpeta**, los activos van a la carpeta raíz.
* La identidad del activo procede del ID de la instancia. La misma instancia nunca se convierte en dos activos dentro de la misma organización, por muchas veces que se sincronice.
* Cada **Ejecutar** o ejecución programada reescribe el nombre, la dirección, la plataforma y los protocolos de los activos que conoce. Un cambio hecho a mano en esos campos no sobrevive a la ejecución siguiente. Las carpetas y las cuentas se añaden, nunca se quitan.
* Una instancia que desaparece de AWS se marca como **Liberados** en la primera ejecución después de que AWS deja de listarla. AWS mantiene las instancias terminadas en su listado durante un tiempo, alrededor de una hora. Con **Liberar activos** desactivado, el activo sigue en el inventario; activado, el activo se elimina al final de la ejecución. **Sincronización en línea** no marca instancias liberadas.

## Cómo verificar que funcionó

1. Antes de registrar la clave, pruébela desde cualquier equipo con la AWS CLI, usando un perfil configurado con la clave nueva:

   ```bash
   aws configure --profile datadike-pam-discover
   aws ec2 describe-instances --profile datadike-pam-discover \
     --region us-east-1 \
     --query 'Reservations[].Instances[].[InstanceId,PrivateIpAddress,PublicIpAddress]' \
     --output table
   ```

   La tabla lista las instancias de la región. `UnauthorizedOperation` indica que falta la política; `AuthFailure` indica una clave errónea o inactiva.
2. Desde el servidor de DataDike PAM, compruebe la ruta hasta el endpoint:

   ```bash
   curl -sS -o /dev/null -w '%{http_code}\n' https://ec2.us-east-1.amazonaws.com/
   ```

   Cualquier código de estado HTTP demuestra la ruta. Un tiempo de espera agotado o un error de resolución de nombres, no.
3. Después de **Ejecutar**, lea el registro que se abre: un bloque por región, una línea por instancia y un resumen con los recuentos de nuevas, sincronizadas, no sincronizadas y liberadas. Una región que la clave no puede leer aparece como no válida.
4. En el panel de la cuenta de AWS, la pestaña **Historial de sincronización** tiene una entrada para la ejecución, y **Sincronizar instancia** lista cada instancia con su estado: **Nueva sincronización**, **Sincronizado**, **No sincronizado** o **Liberados**.
5. Abra **Entorno › Activos** y busque el nombre de una instancia. Compruebe la dirección, la plataforma, la carpeta y los protocolos, y abra una sesión en él. Encontrar el activo demuestra el descubrimiento; la sesión demuestra el camino hasta la instancia.
6. En IAM, el último uso de la clave de acceso muestra el servicio EC2 y la región de la última llamada.

## Errores comunes

| Síntoma                                                                     | Causa                                                                                                                                    | Solución                                                                                                                  |
| --------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Confirmar** muestra *Fallo de prueba: Cuenta no válida*                   | Clave errónea o inactiva, política sin `ec2:DescribeInstances`, reloj del servidor desviado o sin ruta hasta los endpoints EC2           | Pruebe la clave con la CLI y la ruta con `curl` (vea "Cómo verificar que funcionó") y compruebe la hora del servidor      |
| **Confirmar** tarda minutos en responder                                    | La clave se prueba en todas las regiones antes de rechazarse                                                                             | Pruebe antes la clave con la CLI; abra HTTPS 443 hacia `ec2.<región>.amazonaws.com`                                       |
| Una región aparece como no válida en el registro y faltan sus instancias    | La región no está habilitada en la cuenta de AWS, o una política (IAM, `aws:RequestedRegion`, una SCP de la organización) la bloquea     | Habilite la región en AWS o quítela de las regiones de la cuenta                                                          |
| Una región no aparece en la lista                                           | La lista de regiones viene con la versión instalada de DataDike PAM, y las regiones de AWS lanzadas después no aparecen                  | Consúltelo con el soporte de implantación de DataDike                                                                     |
| Después de **Ejecutar**, todas las instancias quedan en **No sincronizado** | No hay ninguna política de sincronización asociada a la cuenta                                                                           | Agregue una política en la sección **Estrategia**, o ejecute **Sincronizar** una vez, lo que asocia la política `default` |
| Una instancia queda en **No sincronizado** con la política `default`        | La instancia no tiene dirección IP, y la política `default` compara la dirección                                                         | Revise la interfaz de red de la instancia en AWS                                                                          |
| Un activo tiene la dirección `unknown`                                      | La instancia no tiene IP, y la política que coincidió no evalúa la dirección                                                             | Agregue una condición de **Dirección de la instancia** a la política                                                      |
| Activos llamados `untitled`                                                 | Las instancias no tienen la etiqueta `Name`                                                                                              | Etiquételas en AWS; la ejecución siguiente renombra los activos                                                           |
| El mismo servidor aparece dos veces                                         | Se registró a mano antes del descubrimiento, o la misma cuenta de AWS se descubre en dos organizaciones, lo que da un activo en cada una | Elimine el activo manual; descubra cada cuenta de AWS en una sola organización                                            |
| Un activo sigue ahí después de terminar su instancia                        | **Liberar activos** está desactivado: la instancia queda en **Liberados** y el activo se conserva                                        | Use **Eliminar activos liberados** en **Sincronizar instancia**, o active **Liberar activos**                             |
| Desaparecieron activos después de editar las regiones                       | Se quitó una región con **Liberar activos** activado, y sus instancias contaron como liberadas                                           | Vuelva a seleccionar la región y haga clic en **Ejecutar**                                                                |
| La dirección cambia de una ejecución a otra                                 | Se prefiere **IP pública** y la instancia recibe otra IP pública al reiniciarse, o no tiene ninguna mientras está detenida               | Use una Elastic IP, o **IP privada** con una ruta o un proxy                                                              |
| No se puede activar **Periódico**                                           | No hay una licencia válida                                                                                                               | Importe la licencia en **Configuración del sistema**                                                                      |

## Referencia de campos

### Cuenta de descubrimiento de AWS

| Campo                    | Qué hace                                                                               | Valores aceptados           | Valor predeterminado |
| ------------------------ | -------------------------------------------------------------------------------------- | --------------------------- | -------------------- |
| Nombre                   | Identifica la cuenta en Descubrir                                                      | Único en la organización    | Ninguno              |
| Plataforma               | El proveedor                                                                           | *AWS*, solo lectura         | *AWS*                |
| ID de la clave de acceso | El ID de la clave de acceso de IAM                                                     | `AKIA...`                   | Ninguno              |
| Clave de acceso secreta  | La clave secreta de IAM. Si se deja en blanco en **Actualizar**, se conserva la actual | Texto                       | Ninguno              |
| Región                   | Las regiones que se leen en cada ejecución. Solo en **Actualizar**                     | Regiones comerciales de AWS | Todas                |
| Descripción              | Texto libre                                                                            | Texto                       | Vacío                |

### Actualización rápida

| Campo            | Qué hace                                                                   | Valores aceptados              | Valor predeterminado |
| ---------------- | -------------------------------------------------------------------------- | ------------------------------ | -------------------- |
| Tipo de IP       | La dirección que reciben los activos, con el otro tipo como alternativa    | **IP privada**, **IP pública** | **IP privada**       |
| Liberar activos  | Elimina los activos de las instancias liberadas al final de cada ejecución | Activado, desactivado          | Desactivado          |
| Ejecución manual | **Ejecutar** la lanza ahora; **Editar** abre la programación               |                                |                      |

### Programación

| Campo     | Qué hace                                      | Valores aceptados            | Valor predeterminado |
| --------- | --------------------------------------------- | ---------------------------- | -------------------- |
| Periódico | Ejecuta la sincronización de forma programada | Activado, desactivado        | Desactivado          |
| Tipo      | Cómo se expresa la programación               | **Intervalo**, **Crontab**   | **Intervalo**        |
| Intervalo | Horas entre ejecuciones                       | Número entero                | 24                   |
| Crontab   | Expresión cron de cinco campos                | `min hora día mes díasemana` | Vacío                |

### Acciones de política usadas con AWS

| Tipo de recurso  | Lo que reciben los activos que coinciden                                    |
| ---------------- | --------------------------------------------------------------------------- |
| Plataforma       | La plataforma, y los protocolos con los puertos elegidos en la misma acción |
| Carpeta          | La carpeta del inventario                                                   |
| Puerta de enlace | El proxy a través del cual se llega a los activos                           |
| Plantillas       | Cuentas creadas a partir de las plantillas de cuenta                        |

## Páginas relacionadas

* [Descubrir activos en la red](https://wiki.datadike.com/es/pam/administration/assets/discovery.md): la pantalla Descubrir y las políticas de sincronización de todos los proveedores
* [Plataformas](https://wiki.datadike.com/es/pam/administration/assets/platforms.md)
* [Gateways](https://wiki.datadike.com/es/pam/administration/connectivity/gateways.md): cómo llegar a instancias con IP privada
* [Plantillas de cuenta](https://wiki.datadike.com/es/pam/administration/accounts/account-templates.md)
* [Roles y permisos](https://wiki.datadike.com/es/pam/administration/identities/roles.md)
