Conector de dados Rapid7

Para configurar a integração com a Rapid7, você precisa do endereço do endpoint da API da plataforma Rapid7, como “us.api.insight.rapid7.com”. O conector autentica com Autenticação por Chave de API usando um Endpoint e uma Chave de API.

Configuração do Rapid7

  1. Ponto final – localize o ponto final Rapid7. Siga as instruções aqui

  2. Chave de API – esta integração precisa de uma chave de API de utilizador para um utilizador que tenha permissões para obter recursos. Para gerar uma chave de API, veja os detalhes nesta ligação.

    Nota:detetámos que a ligação a uma chave de organização foi mais bem-sucedida do que a ligação a uma chave de utilizador. Recomendamos que opte por uma chave de organização para aumentar a probabilidade de uma ligação com êxito.

Estabelecer conexão com o Rapid7 no Gerenciamento de Exposição

Para estabelecer uma ligação com o Rapid7 na Gestão de Exposição, siga estes passos:

  1. Abra os Conectores de Dados na navegação de Gerenciamento de Exposição e selecione Conectar no bloco da Rapid7.
  2. Introduza os detalhes do Ponto Final e da Chave de API do Rapid7 e selecione Ligar.

Dados obtidos

A Gestão de Exposição obtém dados em dispositivos de computação do Rapid7, incluindo máquinas e máquinas virtuais. Também obtém vulnerabilidades comunicadas pelo Rapid7 nesses dispositivos.

Categoria Propriedades
Recursos/dispositivos e dados por cada identificador – ID do Rapid7
- Nome do anfitrião
- Endereço IP
- Endereço do mac
- Informações do sistema operacional
- Pontuação de risco da Rapid7
- Etiquetas
- Dados de criticidade da Rapid7
- Plataforma em nuvem
Resultados de vulnerabilidades O Rapid7 obtém as conclusões do CVE sobre os recursos que ingere.

Resolução de problemas do conector de dados Rapid7

Seguem-se alguns problemas comuns que podem surgir ao configurar o Conector Rapid7 e sugestões sobre como os resolve.

Tipo de Erro Ação de Resolução de Problemas
Mensagem de erro "Não foi possível resolver o nome do servidor remoto" Verifique o endpoint da Rapid7. Saiba mais sobre como determinar o ponto final da API Rapid7 aqui.
Código de erro 401: Falha de autorização Uma falha de autorização indica que as credenciais podem não estar corretas ou que podem não existir permissões suficientes para aceder aos dados do Rapid7. Verifique a chave de API e verifique se é válida e se a conta não está bloqueada. Em alguns casos, descobrimos que utilizar uma chave de organização funciona com mais êxito do que gerar uma chave de utilizador.
Experimente testar a ligação com uma chave de organização. Pode testar as suas credenciais ao executar os seguintes comandos:
curl -l --request POST --location 'https://\<region\>.api.insight.rapid7.com/vm/v4/integration/assets?size=2&includeSame=true' --header 'X-API-Key:\<key\>' --header 'Content-Type: application/json' –header ‘Accept: application/json’
curl -l --request POST --location 'https://\<region\>.api.insight.rapid7.com/vm/v4/integration/vulnerabilities?size=2’ --header 'X-API-Key:\<key\>' --header 'Content-Type: application/json' –header ‘Accept: application/json’
Se essas ações falharem e houver uma descrição do erro, consulte a documentação da Rapid7 para mitigar o problema.
Código de erro 403: Erro de acesso proibido Este erro indica que as credenciais fornecidas não têm as permissões necessárias para executar as APIs pedidas. Certifique-se de que a chave de API é gerada com um utilizador com permissões suficientes para aceder aos dados do Rapid7.
Código de erro 404: Erro não encontrado Este erro indica que o ponto final pedido não foi encontrado acessível. Verifique se o endpoint do Rapid7 está correto. Saiba mais sobre como determinar o ponto final da API Rapid7 aqui.
Mensagem de erro "Problemas temporários de conectividade" Verifique os detalhes de configuração (URL do ponto final e Chave de API) e certifique-se de que são válidos. Reveja a secção Rapid7 da configuração para obter detalhes.
Não vejo os meus recursos ou as vulnerabilidades comunicadas pelo Rapid7 nos dados ingeridos Veja Dados obtidos para obter uma descrição dos dados esperados a obter pelo conector Rapid7. Se ainda existirem dados em falta, contacte o Suporte.
Os IPs permitidos da Rapid7 precisam ser configurados para permitir que os conectores de Gerenciamento de Exposição acessem a Rapid7 Leia como adicionar o conjunto de IPs a adicionar à lista de permissões aqui: Endereços IP da lista de permissões.

Próximas etapas

Depois de configurar o conector de dados Rapid7:

  • Last updated on