> 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/pt/pam/administration/assets/discovery-aws.md).

# Descobrir ativos na AWS

Importe as instâncias EC2 de uma conta AWS como ativos e mantenha o inventário sincronizado, com a permissão IAM, o acesso de rede e as políticas necessárias.

## O que é isto e quando usar

Uma conta de descoberta **AWS** lista as instâncias EC2 de uma conta AWS, região por região, e transforma cada uma em um ativo do inventário: nome, endereço, plataforma, protocolos e pasta. As execuções seguintes atualizam esses ativos e marcam as instâncias que deixaram de existir.

Use quando os servidores são criados e destruídos na AWS mais depressa do que alguém consegue cadastrá-los à mão, e mantenha a descoberta agendada para que o inventário acompanhe a nuvem. A mecânica geral da descoberta, comum a todos os provedores, está em [Descobrir ativos na rede](https://wiki.datadike.com/pt/pam/administration/assets/discovery.md). Esta página trata do que é específico da AWS.

## Antes de começar

### A credencial da AWS

* **Um usuário IAM dedicado, com chave de acesso**: um **Access Key ID** e uma **Secret Access Key**. Nunca a chave do usuário root, e nunca uma chave que uma pessoa também use.
* **Uma única permissão basta: `ec2:DescribeInstances`.** É a única chamada à AWS que a descoberta faz. Ela serve tanto para testar a chave quanto para listar as instâncias, e todos os atributos lidos (tag de nome, plataforma, IP privado e público) vêm na resposta dela. A lista de regiões não exige permissão: ela vem com o produto.
* O formulário aceita apenas o par de chaves. Credenciais temporárias, que também exigem um token de sessão (AWS SSO, papel assumido), não podem ser usadas, e não há papel a assumir em outra conta. Cadastre uma conta de descoberta por conta AWS.
* O card **AWS** cobre as regiões comerciais da AWS. As regiões da AWS China e da AWS GovCloud não estão na lista.

A política mínima, somente leitura:

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

`DescribeInstances` não aceita restrição por recurso, por isso `Resource` continua `"*"`. Para limitar a chave às regiões que você de fato usa, acrescente uma condição em `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"]
        }
      }
    }
  ]
}
```

Uma região que a chave não tem permissão para ler, ou uma região que não está habilitada na conta AWS (as regiões opt-in), não interrompe a sincronização: ela aparece como inválida no log da execução e é pulada, e as instâncias dela não são importadas. Selecione no DataDike PAM apenas as regiões que a chave consegue ler (passo 3).

**Faça a rotação da chave** no prazo que a sua política de segurança define, por exemplo a cada 90 dias. O IAM permite duas chaves ativas por usuário, o que torna a troca transparente:

1. Crie a segunda chave para o mesmo usuário IAM.
2. No DataDike PAM, atualize a conta de descoberta com o novo **ID da chave de acesso** e a nova **Chave de acesso secreta** e clique em **Salvar**. Salvar uma chave nova não a testa.
3. Clique em **Executar** (passo 5) e confira que as regiões são listadas sem erro.
4. Desative a chave antiga no IAM e exclua-a quando nada tiver falhado.

### A rede

* O servidor do DataDike PAM precisa alcançar o endpoint EC2 de cada região selecionada por **HTTPS, porta 443**: `ec2.<região>.amazonaws.com`, por exemplo `ec2.us-east-1.amazonaws.com`. Nenhum outro endpoint da AWS é chamado.
* A tela Discover não tem configuração de proxy de saída. Onde o servidor só sai da rede por um proxy, isso é uma configuração da implantação, definida com o suporte de implantação da DataDike.
* O relógio do servidor precisa estar certo. A AWS recusa requisições assinadas por um relógio com mais de uns cinco minutos de diferença.

### Como alcançar as instâncias depois

A descoberta cadastra as instâncias; ela não abre caminho até elas. Decida antes da primeira execução qual endereço as sessões vão usar:

* **IP privado** (o padrão). O servidor precisa de uma rota até a VPC, como VPN, Direct Connect ou peering, ou os ativos precisam de um proxy com um gateway dentro da VPC. Uma política de sincronização pode associar os ativos a esse proxy (passo 4). Veja [Gateways](https://wiki.datadike.com/pt/pam/administration/connectivity/gateways.md).
* **IP Público**. Os security groups das instâncias precisam liberar a porta da sessão (22 para SSH, 3389 para RDP) a partir do endereço público do servidor do DataDike PAM. Uma instância sem IP público é cadastrada com o IP privado.

### No DataDike PAM

* A função **SYSADMIN**, o papel **Org Admin** ou um papel com as permissões de **Sincronização em nuvem**, que ficam junto das permissões de ativos no editor de papéis. Veja [Funções e permissões](https://wiki.datadike.com/pt/pam/administration/identities/roles.md).
* Uma licença válida. Todas as funções da tela Discover a verificam, e sem ela não é possível ligar **Executar regularmente**.
* Opcional, mas recomendado: a plataforma, a pasta, o proxy e os modelos de conta que as instâncias devem receber, criados antes.

## Passos

### 1. Crie a política IAM, o usuário e a chave de acesso

Faça isto na conta AWS, como administrador do IAM. Com a AWS CLI, salve a política acima como `datadike-pam-discover-ec2.json` e execute:

```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
```

Troque `111122223333` pelo ID da conta AWS. O último comando devolve o **AccessKeyId**, como `AKIAIOSFODNN7EXAMPLE`, e a **SecretAccessKey**. O segredo aparece uma única vez: guarde-o em lugar seguro até o passo 2. No console do IAM o resultado é o mesmo: uma política com o JSON acima, um usuário sem acesso ao console com essa política associada e uma chave de acesso criada em **Security credentials**.

### 2. Cadastre a conta AWS no Discover

1. Abra **Ambiente › Discover** e vá para **Escolha a plataforma**.
2. Clique em **AWS**. O formulário **Criar conta na nuvem** abre na lateral.
3. **Configurações básicas**: dê um **Nome** à conta, por exemplo `aws-producao`. A **Plataforma** já vem preenchida como *AWS* e é somente leitura.
4. **AWS**: preencha **ID da chave de acesso** com o AccessKeyId e **Chave de acesso secreta** com a SecretAccessKey.
5. **Outras configurações**: **Observações** opcionais.
6. Clique em **Confirmar**.

Ao **Confirmar**, a chave é testada nas regiões, uma por uma, até que uma delas responda. Uma chave válida é aceita em poucos segundos. Uma chave recusada só é informada depois que todas as regiões foram tentadas, o que pode levar alguns minutos. A conta nova aparece em **Conta da plataforma na nuvem** com todas as regiões selecionadas.

### 3. Escolha as regiões

A conta começa com todas as regiões da lista selecionadas, inclusive as que a sua conta AWS não usa. Restrinja a seleção:

1. Em **Conta da plataforma na nuvem**, clique no card da conta AWS e, no painel, clique em **Atualizar**.
2. Em **Origem de sincronização**, clique no link de **Região**, que mostra **Modificar \[n]**.
3. Marque as regiões onde as suas instâncias rodam. A caixa de pesquisa e os filtros por continente ajudam na lista longa. Feche a janela com **Confirmar**.
4. Clique em **Salvar**. A chave é testada de novo nas regiões selecionadas.

{% hint style="warning" %}
Retirar uma região que já foi sincronizada faz as instâncias dela contarem como liberadas na execução seguinte. Com **Sincronizar liberação de ativos** ligado, os ativos delas são excluídos do inventário.
{% endhint %}

### 4. Defina como as instâncias viram ativos

As políticas de sincronização são compartilhadas por todas as contas de descoberta. Crie uma para a AWS na aba **Sincronizar política**: clique em **Criar** e preencha:

1. **Configurações básicas**: um **Nome** e a **Prioridade** (de 1 a 100, padrão 50; vence o menor número).
2. **Condições**: quais instâncias a política alcança. **Relações de condição** é **E** ou **Ou**. Cada linha combina **Nome do atributo**, **Correspondência** e **Valor de Propriedade** e é acrescentada com **Adicionar**. Na AWS:
   * **Nome da instância** é a tag `Name` da instância
   * **Nome da plataforma de instância** é `windows` nas instâncias Windows e vazio nas demais
   * **Endereço da instância** são os endereços IP da instância
   * **Igual** com o valor `*` corresponde a qualquer valor
3. **Ação**: o que as instâncias correspondentes recebem, uma linha por **Tipo de recurso** com os seus **Recursos**, acrescentada com **Adicionar**:
   * **Plataforma**, com a lista de **Protocolo** e as portas que os ativos recebem
   * **Pasta**, onde os ativos são arquivados
   * **Domínio da web**, o proxy pelo qual os ativos são alcançados
   * **Modelos**, modelos de conta convertidos em contas em cada ativo
4. Clique em **Confirmar**.

Depois, em **Conta da plataforma na nuvem**, abra a conta AWS e, na aba **Configurações básicas** do painel:

1. Na seção **Estratégia**, selecione a política e clique em **Adicionar**.
2. Em **Atualização rápida**, defina **Tipo de IP** como **IP privado** ou **IP Público**. O outro tipo é usado quando a instância não tem o escolhido.
3. Deixe **Sincronizar liberação de ativos** desligado nas primeiras execuções.

### 5. Faça a primeira sincronização

Há duas formas de executá-la, e elas se comportam de maneira diferente:

* **Sincronizar**, no card ou no painel, abre a **Sincronização online**. Ela lê as regiões uma de cada vez e lista as instâncias que ainda não estão no inventário, com **Nome**, **Endereço**, **Plataforma**, **Pasta**, **Protocolo** e **Região**. Marque as que quiser e clique em **Carregar** para importá-las. Se a conta não tiver política associada, a política nativa `default` é associada antes. Use esta forma na primeira importação, para revisar antes que algo seja criado.
* **Executar**, em **Atualização rápida › Execução manual**, faz a sincronização completa em segundo plano e abre o log dela. Ela cria e atualiza ativos sem perguntar e marca as instâncias que sumiram. Ela exige uma política associada à conta: sem nenhuma, todas as instâncias terminam como **Não sincronizado**.

### 6. Agende a sincronização

1. Em **Atualização rápida › Execução manual**, clique em **Modificar**.
2. Ligue **Executar regularmente** e escolha o **Tipo**:
   * **Intervalo**, em horas, por exemplo `24`
   * **Agendamento cron**, uma expressão de cinco campos, por exemplo `0 3 * * *` para todos os dias às 03:00
3. Salve o formulário.

A execução agendada se comporta como **Executar**.

## O que você deve ver

![A tela Discover, listando as contas de descoberta registradas](https://2577774576-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmW94amWe62SEQe4f16Vs%2Fuploads%2Fgit-blob-b55964a35e46df218bcc5d854266ca552918bba9%2Fdiscover.png?alt=media)

**1** Quantas contas de descoberta existem. **2** O catálogo de provedores, onde uma conta nova é registrada.

O card da conta AWS mostra quantas regiões ela cobre e quantos ativos já produziu. Depois de uma execução:

* Cada instância é um ativo, com o nome da tag `Name`, ou `untitled` quando a instância não tem essa tag. Quando outro ativo já tem esse nome, os quatro últimos caracteres do ID da instância são acrescentados. Os ativos importados pela **Sincronização online** recebem um sufixo de oito caracteres, que o próximo **Executar** troca pelo nome da instância.
* O endereço é o IP do **Tipo de IP** escolhido, ou do outro tipo quando a instância não tem o escolhido.
* Sem uma ação de **Plataforma**, as instâncias Windows recebem a plataforma **Windows** com RDP na 3389, e as demais recebem **Linux** com SSH na 22.
* Sem uma ação de **Pasta**, os ativos vão para a pasta raiz.
* A identidade do ativo vem do ID da instância. A mesma instância nunca vira dois ativos dentro da mesma organização, por mais vezes que seja sincronizada.
* Cada **Executar** ou execução agendada reescreve o nome, o endereço, a plataforma e os protocolos dos ativos que ela conhece. Uma alteração feita à mão nesses campos não sobrevive à execução seguinte. Pastas e contas são acrescentadas, nunca removidas.
* Uma instância que some da AWS é marcada como **Liberado** na primeira execução depois que a AWS deixa de listá-la. A AWS mantém as instâncias encerradas na listagem por algum tempo, cerca de uma hora. Com **Sincronizar liberação de ativos** desligado, o ativo continua no inventário; ligado, o ativo é excluído no fim da execução. A **Sincronização online** não marca instâncias liberadas.

## Como verificar se funcionou

1. Antes de cadastrar a chave, teste-a de qualquer máquina com a AWS CLI, usando um perfil configurado com a chave nova:

   ```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
   ```

   A tabela lista as instâncias da região. `UnauthorizedOperation` indica que falta a política; `AuthFailure` indica chave errada ou inativa.
2. A partir do servidor do DataDike PAM, confira a rota até o endpoint:

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

   Qualquer código de status HTTP prova a rota. Um tempo esgotado ou um erro de resolução de nome, não.
3. Depois de **Executar**, leia o log que abre: um bloco por região, uma linha por instância e um resumo com as contagens de novas, sincronizadas, não sincronizadas e liberadas. Uma região que a chave não consegue ler aparece como inválida.
4. No painel da conta AWS, a aba **Sincronizar lista de histórico** tem uma entrada para a execução, e **Sincronizar lista de instâncias** lista cada instância com o seu status: **Nova sincronização**, **Sincronizado**, **Não sincronizado** ou **Liberado**.
5. Abra **Ambiente › Ativos** e pesquise pelo nome de uma instância. Confira o endereço, a plataforma, a pasta e os protocolos, e abra uma sessão nele. Encontrar o ativo prova a descoberta; a sessão prova o caminho até a instância.
6. No IAM, o último uso da chave de acesso mostra o serviço EC2 e a região da última chamada.

## Erros comuns

| Sintoma                                                                | Causa                                                                                                                                 | Correção                                                                                                              |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Confirmar** mostra *Teste falhou: Conta inválida*                    | Chave errada ou inativa, política sem `ec2:DescribeInstances`, relógio do servidor errado ou sem rota até os endpoints EC2            | Teste a chave com a CLI e a rota com `curl` (veja "Como verificar se funcionou") e confira a hora do servidor         |
| **Confirmar** leva minutos para responder                              | A chave é tentada em todas as regiões antes de ser recusada                                                                           | Teste a chave com a CLI antes; libere HTTPS 443 para `ec2.<região>.amazonaws.com`                                     |
| Uma região aparece como inválida no log e as instâncias dela faltam    | A região não está habilitada na conta AWS, ou uma política (IAM, `aws:RequestedRegion`, SCP da organização) a bloqueia                | Habilite a região na AWS ou retire-a das regiões da conta                                                             |
| Uma região não aparece na lista                                        | A lista de regiões vem com a versão instalada do DataDike PAM, e regiões da AWS lançadas depois dela não aparecem                     | Leve o caso ao suporte de implantação da DataDike                                                                     |
| Depois de **Executar**, todas as instâncias ficam **Não sincronizado** | Não há política de sincronização associada à conta                                                                                    | Adicione uma política na seção **Estratégia**, ou execute **Sincronizar** uma vez, o que associa a política `default` |
| Uma instância fica **Não sincronizado** com a política `default`       | A instância não tem endereço IP, e a política `default` compara o endereço                                                            | Confira a interface de rede da instância na AWS                                                                       |
| Um ativo tem o endereço `unknown`                                      | A instância não tem IP, e a política que correspondeu não testa o endereço                                                            | Acrescente uma condição de **Endereço da instância** à política                                                       |
| Ativos com o nome `untitled`                                           | As instâncias não têm a tag `Name`                                                                                                    | Aplique a tag na AWS; a execução seguinte renomeia os ativos                                                          |
| O mesmo servidor aparece duas vezes                                    | Ele foi cadastrado à mão antes da descoberta, ou a mesma conta AWS é descoberta em duas organizações, o que gera um ativo em cada uma | Exclua o ativo manual; descubra cada conta AWS em uma única organização                                               |
| Um ativo continua depois que a instância foi encerrada                 | **Sincronizar liberação de ativos** está desligado: a instância fica **Liberado** e o ativo é mantido                                 | Use **Excluir liberados** em **Sincronizar lista de instâncias**, ou ligue **Sincronizar liberação de ativos**        |
| Ativos sumiram depois que as regiões foram editadas                    | Uma região foi retirada com **Sincronizar liberação de ativos** ligado, e as instâncias dela contaram como liberadas                  | Selecione a região de novo e clique em **Executar**                                                                   |
| O endereço muda de uma execução para outra                             | **IP Público** é o preferido e a instância ganha outro IP público ao reiniciar, ou fica sem nenhum enquanto parada                    | Use um Elastic IP, ou **IP privado** com rota ou proxy                                                                |
| Não é possível ligar **Executar regularmente**                         | Não há licença válida                                                                                                                 | Importe a licença em **Configurações do Sistema**                                                                     |

## Referência de campos

### Conta de descoberta AWS

| Campo                   | O que faz                                                             | Valores aceitos           | Padrão |
| ----------------------- | --------------------------------------------------------------------- | ------------------------- | ------ |
| Nome                    | Identifica a conta no Discover                                        | Único na organização      | Nenhum |
| Plataforma              | O provedor                                                            | *AWS*, somente leitura    | *AWS*  |
| ID da chave de acesso   | O ID da chave de acesso do IAM                                        | `AKIA...`                 | Nenhum |
| Chave de acesso secreta | A chave secreta do IAM. Em branco em **Atualizar**, a atual é mantida | Texto                     | Nenhum |
| Região                  | As regiões lidas a cada execução. Só em **Atualizar**                 | Regiões comerciais da AWS | Todas  |
| Observações             | Texto livre                                                           | Texto                     | Vazio  |

### Atualização rápida

| Campo                           | O que faz                                                           | Valores aceitos                | Padrão         |
| ------------------------------- | ------------------------------------------------------------------- | ------------------------------ | -------------- |
| Tipo de IP                      | O endereço que os ativos recebem, com o outro tipo como alternativa | **IP privado**, **IP Público** | **IP privado** |
| Sincronizar liberação de ativos | Exclui os ativos das instâncias liberadas no fim de cada execução   | Ligado, desligado              | Desligado      |
| Execução manual                 | **Executar** roda agora; **Modificar** abre o agendamento           |                                |                |

### Agendamento

| Campo                 | O que faz                               | Valores aceitos                     | Padrão        |
| --------------------- | --------------------------------------- | ----------------------------------- | ------------- |
| Executar regularmente | Executa a sincronização por agendamento | Ligado, desligado                   | Desligado     |
| Tipo                  | Como o agendamento é expresso           | **Intervalo**, **Agendamento cron** | **Intervalo** |
| Intervalo             | Horas entre as execuções                | Número inteiro                      | 24            |
| Agendamento cron      | Expressão cron de cinco campos          | `min hora dia mês dia-da-semana`    | Vazio         |

### Ações de política usadas com a AWS

| Tipo de recurso | O que os ativos correspondentes recebem                              |
| --------------- | -------------------------------------------------------------------- |
| Plataforma      | A plataforma, e os protocolos com as portas escolhidos na mesma ação |
| Pasta           | A pasta do inventário                                                |
| Domínio da web  | O proxy pelo qual os ativos são alcançados                           |
| Modelos         | Contas criadas a partir dos modelos de conta                         |

## Páginas relacionadas

* [Descobrir ativos na rede](https://wiki.datadike.com/pt/pam/administration/assets/discovery.md): a tela Discover e as políticas de sincronização de todos os provedores
* [Plataformas](https://wiki.datadike.com/pt/pam/administration/assets/platforms.md)
* [Gateways](https://wiki.datadike.com/pt/pam/administration/connectivity/gateways.md): como alcançar instâncias em IP privado
* [Modelos de conta](https://wiki.datadike.com/pt/pam/administration/accounts/account-templates.md)
* [Funções e permissões](https://wiki.datadike.com/pt/pam/administration/identities/roles.md)
