Para demonstrarmos como importar apontamentos de ativos do tipo Aplicação Web, iremos utilizar como exemplo um arquivo simulando um checklist do OWASP Top 10 (versão web | versão pdf).
Como utilizar o Custom Parser
1. Clique no Menu "Adicionar".
2. Em "Tipo", selecione "Custom Parser".
3. Clique no botão "Selecionar" e procure o arquivo CSV em seu computador e clique em "Upload"
4. Após a conclusão, o nome do arquivo se transformará em um link. Clique nele.
5. Escreva um nome para a importação;
6. Verifique qual caractere está sendo usado para separar os campos do arquivo CSV (geralmente é vírgula ou ponto-e-vírgula). Dentro da seção "Configuração", você poderá selecionar o carácter correspondente. A pré-visualização do arquivo será atualizada.
7. Arraste os campos do GAT Core para as colunas correspondentes do arquivo.
Os campos em vermelho são obrigatórios.
Os demais campos são opcionais, porém alguns são dependentes de outros
Alguns campos podem ser utilizados em mais de uma coluna
8. Mude para a aba "Ativos";
9. Selecione a opção "Aplicação";A lógica nessa etapa é a mesma que a anterior
10. Se o seu arquivo CSV tiver um cabeçalho na primeira linha, é necessário avisar o GAT Core para pular essa linha
11. É possível ainda criar um Template, para reutilizar esse mapeamento de forma instantânea na próxima importação.
12. Por último, basta clicar no botão "Importar", no canto inferior esquerdo!
Campos do Apontamento
Título: nome do apontamento
Exemplo: "VNC Server 'password' Password"
Observação: campo obrigatório
Severidade: severidade do apontamento, de acordo com a tabela abaixo
Observação: campo obrigatório
Tipo de Ferramenta: pode ser uma das opções abaixo
MANUAL
NESSUS
ACUNETIX
ARACHNI
ALIENVAULT
QUALYS
CUSTOM_PARSER
NESSUS_AUDIT
TENABLEIO
LEGACY
NEXPOSE
OPENVAS
FORTIFY
LUCY
BURP
APPSCAN
NETSPAKER
NIKTO
WEBINSPECT
W3AF
ID da Ferramenta: é o ID do apontamento com relação ao Tipo de Ferramenta
Exemplo: para o apontamento "VNC Server 'password' Password" do Nessus, o ID da ferramenta corresponderia ao Plugin ID, que é 61708
URL de Referência: é a URL de uma referência do apontamento
Exemplo: http://www.securityfocus.com/bid/104659
Observação: esse campo pode ser utilizado mais de uma vez
Título da Referência: é o título da referência do apontamento
Exemplo: "Microsoft ASP.NET Core CVE-2018-8171 Security Bypass Vulnerability"
Observação: esse campo pode ser utilizado mais de uma vez
Recomendação: é a descrição de uma recomendação para corrigir o apontamento
Exemplo: "Aplicar o KB Microsoft 4339279"
Observação: ao utilizar esse campo, o campo "Título da Recomendação" torna-se obrigatório. Esse campo pode ser utilizado mais de uma vez
Título da Recomendação: é o título de uma recomendação para corrigir o apontamento
Exemplo: "Security Updates for Microsoft .NET core and ASP.NET (Bypass) (July 2018)"
Observação: ao utilizar esse campo, o campo "Recomendação" torna-se obrigatório. Esse campo pode ser utilizado mais de uma vez
Mitigação: é a descrição de um controle para mitigar o apontamento
Exemplo: "Para mitigar o ataque de SQL Injection, recomenda-se a utilização de um WAF"
Observação: ao utilizar esse campo, o campo "Título da Mitigação" torna-se obrigatório. Esse campo pode ser utilizado mais de uma vez
Título da Mitigação: é o título de um controle para mitigar o apontamento
Exemplo: "Utilização de WAF"
Observação: ao utilizar esse campo, o campo "Mitigação" torna-se obrigatório. Esse campo pode ser utilizado mais de uma vez
Teste: é a descrição de um teste feito para identificar um apontamento
Exemplo: "Para verificar se o roteador está com a senha padrão, acesse sua console Web e coloque as credenciais admin / admin"
Observação: ao utilizar esse campo, o campo "Título do Teste" torna-se obrigatório. Esse campo pode ser utilizado mais de uma vez
Título do Teste: é o título de um teste feito para identificar um apontamento
Exemplo: "Roteador com senha padrão"
Observação: ao utilizar esse campo, o campo "Teste" torna-se obrigatório. Esse campo pode ser utilizado mais de uma vez
Descrição: é a descrição do apontamento
Exemplo: "O Servidor VNC está rodando com sua senha padrão: 'password'"
Nome do Serviço: é o nome do serviço afetado pelo apontamento
Exemplo: HTTP
Estado: é o estado do apontamento dentro do ciclo de vida, conforme tabela abaixo:
Se essa coluna não for mapeada, todos os Apontamentos ficarão com estado Pendente
Causa Raiz: é a causa raiz do problema. Uma forma de categorizar os apontamentos e verificar quais áreas precisam de mais atenção
Exemplo: Gerenciamento de Senhas
Categoria: categoria a que o apontamento pertence
Exemplo: Web Servers
Observação: não há uma regra para a utilização desse campo. É uma forma de categorizar os apontamentos de acordo com sua necessidade. Esse campo pode ser utilizado mais de uma vez
CVE: código do CVE associado ao apontamento
Exemplo: CVE-2018-8171
Observação: esse campo pode ser utilizado mais de uma vez
CWE: código do CWE associado ao apontamento
Exemplo: 564
Observação: esse campo pode ser utilizado mais de uma vez
Data de Criação a data da detecção do apontamento
Exemplo: 2018-01-22
Campos do Ativo Aplicação Web
URL: é o campo principal desse tipo de ativo, a URL da Aplicação Web
Exemplo: http://ibliss.digital
Observações:
a URL tem que iniciar com algum dos seguintes protocolos:
http://
https://
ftp://
Este campo é obrigatório
Severity: é a severidade do ativo, de acordo com a tabela abaixo
Asset Description: é a descrição do ativo
Exemplo: Site institucional da empresa
Credentials: as credenciais de acesso, quando houver
Exemplo: admin:admin
Port: a porta em que a aplicação web roda dentro do servidor
Exemplo: 443
HTTP Method: é o método HTTP utilizado para explorar a vulnerabilidade em questão
Exemplo: POST
URL Vulnerable Parameter: é o path que está vulnerável ao ataque em questão na aplicação web
Exemplo: /admin/change_password
Vulnerable Parameter: é o parâmetro que está vulnerável ao ataque em questão na aplicação web
Exemplo: new-password
Possíveis erros ao utilizar o Custom Parser
Esquecer de pular a(s) linha(s) do cabeçalho do arquivo
Nesse caso, o GAT Core irá gerar um erro na primeira etapa do processamento, pois irá ler o cabeçalho esperando encontrar os valores para cada coluna
Ter alguma informação faltando em um campo obrigatório
O GAT Core informará em qual linha ocorreu o erro
Ter alguma informação inválida em algum campo
O GAT Core informará em qual linha ocorreu o erro
Série
Importar apontamentos de Infra Estrutura utilizando o Custom Parser
Importar apontamentos de Processos utilizando o Custom Parser
Importar apontamentos de Cloud utilizando o Custom Parser
Importar apontamentos de Pessoa utilizando o Custom Parser