Configurando o agente DAST ISM Veracode em servidores Linux
Tags: dast, appsec, devsecops, veracode
Published: 2023-06-23 21:56:43

No post [Como realizar uma análise dinâmica (DAST) com a Veracode em aplicações não publicadas?](https://dev.to/m3corp/como-utilizar-o-dast-veracode-em-aplicacoes-internas-5ej8-temp-slug-9842342?preview=9a44d37a571dec985d8709ff071f1c62058ce726c20b8708ab2c1efb42828afc99711b737b867b93e3de863db81242d699e0c7071ad071ebda7ed663) entendemos a importância e o porquê de se realizar uma análise DAST dentro de um ambiente pré-produção.

Nesse post, iremos fazer o passo a passo de como configurar o agent ISM em servidores Linux.

---

### *Pré Requisitos Técnicos*

```
1. Sistema Operacional: Linux RHEL, CentOS, Ubuntu, Debian
2. Hardware: 8 GB RAM; 4 GB Livres de Disco
3. Software: Java JRE 8+ LTS
4. Rede:
- Conexão confiável do servidor endpoint com as aplicações internas a serem testadas
- 443 do servidor aberta para saída
- Garantir que o endereço 34.195.146.191 esteja acessível pela aplicação, ele é a origem das requisições da análise dinâmica
- É recomendado desabilitar IPS, WAF e outras camadas que possam interferir nos resultados do DAST originados do IP da Veracode (citado acima). 
5. O usuário que fará a criação do endpoint e download do executável, deverá ter uma dessas Roles permissions: **Administrator** ou **Security Lead**
```

---
### *Configuração do Internal Scanning*

1. No menu de configuração *ícone de engrenagem na parte superior da plataforma Veracode*, clique em **Internal Scanning Management**

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/lp5xy6je2gghcwf74c5j.jpg)
2. Clique em **Configure Internal Scanning**
3. Insira o nome e a descrição do gateway. Então clique **Next**
4. Insira o nome e a descrição do endpoint que você deseja conectar a este gateway
5. Selecione **Other**
![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/d7po97w0yvksanm0jdz2.jpg)
6. Clique em **Next**

---
#### *Download e Instalação do endpoint ISM*
1. Clique em **Download** para baixar o arquivo ZIP contendo o instalador
![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/dbsrsviyu5p9o5jyqrew.png)
2. Mova o arquivo ZIP baixado para dentro do servidor onde ele será executado
3. Crie um pasta específica e faça a extração do ZIP dentro dela
4. O endpoint será um arquivo **.jar**

---
### *Execução do endpoint ISM*
1. Ao seguir os passos anteriores de criação do endpoint, ele irá te mostrar todos os comandos necessários para execução como a imagem a seguir:
![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/kz61o0r80z8srlxxvs2i.png)
2. A estrutura se baseia em alguns cenários que você deverá avaliar e escolher o que se adequa melhor na sua infraestrutura.
  

- Se você não estiver usando um proxy da Web para acessar a Internet:

```
java -jar Veracode_ISM_Endpoint_{yourendpointname}.jar
```

- Se você estiver usando um proxy da web não autenticado:

```
java -Dhttps.proxyHost={your_proxy_host} -Dhttps.proxyPort={your_proxy_port} -jar Veracode_ISM_Endpoint_{your_endpoint_name}.jar 
```

- Se você estiver usando um proxy da web autenticado, inicie o endpoint:

```
java -Dhttps.proxyHost={your_proxy_host} -Dhttps.proxyPort={your_proxy_port} -jar Veracode_ISM_Endpoint_{your_endpoint_name}.jar --authenticate
```

- Depois de iniciar o endpoint para um proxy da web autenticado, execute o endpoint:

```
java -Dhttps.proxyHost={your_proxy_host} -Dhttps.proxyPort={your_proxy_port} -jar Veracode_ISM_Endpoint_{your_endpoint_name}.jar
```

- Se você deseja usar apenas o proxy da web para comunicação entre o endpoint e o gateway:

```
java -Dhttps.proxyHost={your_proxy_host} -Dhttps.proxyPort={your_proxy_port} -jar Veracode_ISM_Endpoint_{your_endpoint_name}.jar --proxygatewayonly
```

Clique em **Close**

O novo gateway e endpoint agora aparecem na página **Internal Scanning Management** como as imagens de exemplo abaixo:


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/h7xf07ge0yonmb40ot8k.png)


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/3ma7fifepyttdy6temwc.png)


---
Se o endpoint não conseguir se conectar ao gateway, sua organização pode precisar adicionar o endereço IP do gateway ou o nome de domínio à sua lista de permissões. O endereço IP e o domínio são visíveis na página *Internal Scanning Management* e na página do gateway.

O gateway pode ter um status de Inicializando por alguns minutos depois de criá-lo. O endpoint tem um status de Pendente até que você o implemente com sucesso. Quando você implementa com sucesso o endpoint, ele tem um status de **Ready**.

---
#### *Próximo passo*

Após seguir o procedimento de criação do gateway, download e execução do endpoint, você estará pronto para iniciar a configuração DAST pelo portal utilizando o ISM que você pode seguir conforme os tutoriais abaixo:

#### Conteúdos em Português

{% embed https://dev.to/m3corp/como-fazer-um-dast-pelo-portal-11n4 %}

{% embed https://www.youtube.com/watch?v=DKqexxmGejk %}

---

#### Conteúdos em Inglês

{% embed https://www.youtube.com/watch?v=El6xBMaC4yg&list=PLeiyXUuWBjKHvSzYExu1pTLbxcVmn7oyF&index=2
 %}

{% embed https://www.youtube.com/watch?v=WUwoqmCIA9I&list=PLeiyXUuWBjKHvSzYExu1pTLbxcVmn7oyF&index=9 %}

{% embed https://www.youtube.com/watch?v=wQIaab9GGAM&list=PLeiyXUuWBjKHvSzYExu1pTLbxcVmn7oyF&index=7 %}