As informações contidas neste documento se aplicam a versão 7.2 do Syhunt Hybrid.

Configurar um rastreador de problemas é uma tarefa simples e as vulnerabilidades podem ser enviadas para um projeto específico com apenas um clique.

Integrando com o GitHub Issues

Primeiramente, caso ainda não tenha feito isso, você precisará criar um token de acesso pessoal com permissão de acesso ao repositório:

1. Faça login no GitHub.
2. No canto superior direito, clique no seu avatar e selecione Settings.
3. No menu Personal settings (lado esquerdo da tela), role para baixo e selecione Developer settings.
4. Selecione Personal access tokens e clique no botão Generate new token.
5. Insira uma nota opcional para o token.
6. Escolha o escopo repo.
7. Clique no botão Generate token.
8. Guarde o token de acesso pessoal em um local seguro. Após sair ou atualizar a página, não será possível acessá-lo novamente.

Em seguida, você precisará adicionar um rastreador do GitHub:

1. Acesse a área de Conectores da interface web.
   
2. Clique no botão Adicionar.
   
3. Insira um nome de referência para o novo rastreador (como NomeDoProjeto).
4. Selecione o tipo Github.
5. Clique no botão Criar e, em seguida, em Fechar.
6. Clique no rastreador recém-criado na lista. A tela de preferências do rastreador será aberta.
7. Insira o nome do projeto no GitHub. O formato deve ser owner/repo.
8. Insira seu token de acesso pessoal do GitHub e clique no botão Salvar.
9. O rastreador está pronto! Abra as configurações do rastreador novamente e clique no botão Run Test para testá-lo.

Se tudo estiver configurado corretamente, um item de problema de teste será criado em https://github.com/[owner]/[repo]/issues. Caso contrário, uma mensagem de erro será exibida com uma indicação do que precisa ser corrigido.

Integrando com o GitLab Issues

Se você deseja integrar o Syhunt com a CI do GitLab e o painel de segurança, por favor leia este outro documento.

Primeiramente, caso ainda não tenha feito isso, você precisará criar um token de acesso pessoal com permissão de acesso à API:

1. Faça login no GitLab.
2. No canto superior direito, clique no seu avatar e selecione Settings.
3. No menu User Settings, selecione Access Tokens.
4. Escolha um nome e uma data de expiração opcional para o token.
5. Escolha o escopo API.
6. Clique no botão Create personal access token.
7. Guarde o token de acesso pessoal em um local seguro. Após sair ou atualizar a página, não será possível acessá-lo novamente.

Em seguida, você precisará adicionar um rastreador do GitLab:

1. Acesse a área de Conectores da interface web.
   
2. Clique no botão Adicionar.
   
3. Insira um nome de referência para o novo rastreador (como NomeDoProjeto).
4. Selecione o tipo GitLab.
5. Clique no botão Criar e, em seguida, em Fechar.
6. Clique no rastreador recém-criado na lista. A tela de preferências do rastreador será aberta.
7. Insira o nome do projeto no GitLab. O formato deve ser owner/repo.
8. Insira a URL do servidor GitLab, ex.: https://gitlab.com/ ou a URL do seu próprio servidor.
9. Insira seu token de acesso pessoal do GitLab e clique no botão Salvar.
10. O rastreador está pronto! Abra as configurações do rastreador novamente e clique no botão Run Test para testá-lo.

Se tudo estiver configurado corretamente, um item de problema de teste será criado em https://[gitlab_server]/[owner]/[repo]/issues. Caso contrário, uma mensagem de erro será exibida com uma indicação do que precisa ser corrigido.

Integrando com o JIRA Issues

Primeiramente, você precisará adicionar um rastreador do JIRA:

1. Acesse a área de Conectores da interface web.
   
2. Clique no botão Adicionar.
   
3. Selecione o tipo GitLab.
4. Clique no botão Criar e, em seguida, em Fechar.
5. Clique no rastreador recém-criado na lista. A tela de preferências do rastreador será aberta.
6. Insira um nome de referência para o novo rastreador (como NomeDoProjeto).
7. Selecione o tipo JIRA.
8. Clique no rastreador recém-criado na lista. A tela de preferências do rastreador será aberta.
9. Insira um nome de projeto JIRA válido.
10. Insira a URL do servidor JIRA, ex.: http://[IP]:8080/
11. Insira um nome de tipo de problema válido caso não queira usar o nome padrão.
12. Insira suas credenciais do JIRA (usuário e senha) e clique no botão Salvar.
13. O rastreador está pronto! Abra as configurações do rastreador novamente e clique no botão Run Test para testá-lo.

Se tudo estiver configurado corretamente, um item de problema de teste será criado na página do seu projeto no JIRA. Caso contrário, uma mensagem de erro será exibida com uma indicação do que precisa ser corrigido.

Enviando Vulnerabilidades para um Rastreador

1. Durante uma varredura em andamento, acesse a aba Vulnerabilidades. Como alternativa, você pode ir até a área de Varreduras, abrir uma varredura na lista e acessar a aba Vulnerabilidades.
2. Marque uma ou mais vulnerabilidades, clique no botão Enviar Para (conforme mostrado na imagem abaixo) e selecione o rastreador para o qual deseja enviar as vulnerabilidades.
   

O Syhunt também pode enviar automaticamente um resumo das vulnerabilidades identificadas para um rastreador:

• Se configurado na tela de agendamento
• Se o parâmetro -tk for fornecido ao comando scanurl ou scancode, conforme explicado na documentação da CLI
• Se estiver usando YML ou Powershell, através do parâmetro -tracker. Exemplo:

-- From Powershell (previously created tracker)
Start-CodeScan -pfcond "medium" -tracker "YOURTRACKERNAME"

-- From Powershell (dynamic tracker)
Start-CodeScan -pfcond "medium" -tracker "?app=github###project=user/project###token=YOURTOKEN"

-- Within GitHub's YML (dynamic tracker)
Start-CodeScan -pfcond "medium" -tracker "?app=github###project=${{ github.repository }}###token=${{ secrets.GITHUB_TOKEN }}"

Ao fornecer IDs de preferência relacionados ao rastreador através do parâmetro -tk ou -tracker, é necessário usar versões abreviadas de seus nomes (conforme mostrado abaixo). Se um ID de preferência de rastreador não estiver listado abaixo com um nome abreviado equivalente, a configuração específica não está disponível para ser definida ou modificada através dos parâmetros -tk ou -tracker.

Relacionado ao DefectDojo:

Para documentação adicional do produto, visite syhunt.com/docs/br