Webhood URL Scanner (Pré-visualização)

Este é o esquema do Swagger 2.0 para a API do scanner de URL do Webhood

Este conector está disponível nos seguintes produtos e regiões:

Webhood é um scanner de URL privado usado por caçadores de ameaças e analistas de segurança para analisar phishing e sites maliciosos. Esse conector permite controlar verificações usando os Aplicativos Lógicos do Azure e o Power Automate.

Pré-requisitos

• Instância Webhood

A instância Webhood pode ser auto-hospedada seguindo as instruções de implantação do Webhood URL Scanner . O conector é testado com a versão mais recente do Webhood.

Você também pode obter uma versão hospedada do Webhood inscrevendo-se no Webhood Cloud.

• chave de API

A chave da API é usada para autenticar o conector na instância do Webhood. Consulte Obtendo credenciais para obter instruções sobre como criar uma chave de API.

• Certificado https válido para a instância Webhood se estiver usando HTTPS (necessário para o Power Automate)

Como obter credenciais

1. Faça login na sua instância do Webhood com uma conta de administrador.
2. Vá para Settings ->Accounts ->API Tokens para criar uma nova chave de API.
3. Selecione Add Token e selecione scanner como a função.
4. Copie a chave de API gerada (Token) e use-a como no API Key conector.

A chave da API será exibida apenas uma vez, pois não é armazenada em sua instância do Webhood.

Observe que todas as chaves de API expiram após 365 dias. Você pode criar uma nova chave de API a qualquer momento. Se quiser revogar uma chave de API, você pode excluí-la da instância Webhood selecionando Revoke. Recomendamos que você anote o ID do token para que possa identificá-lo mais tarde.

Introdução ao conector

A principal característica deste conector é a capacidade de verificar URLs em busca de phishing e conteúdo malicioso. O conector fornece ações para criar uma nova verificação, passar por varreduras, obter varredura por ID e obter captura de tela por ID de digitalização.

Isso permite automatizar o processo de digitalização e integrá-lo com outros serviços. Por exemplo, você pode criar uma nova verificação quando uma nova URL é adicionada a uma lista do SharePoint ou obter os resultados da verificação quando uma verificação é concluída.

Você também pode integrar esse conector ao Microsoft Sentinel para verificar automaticamente URLs de alertas de segurança.

Exemplo simples de fluxo:

1. Create a new scan- Acionar uma nova verificação para um URL com uma entrada, por exemplo. https://example.com
2. Get scan by ID - Obtenha os detalhes da digitalização fornecendo o ID da digitalização da etapa anterior.
3. Faça um loop até que o status da verificação seja done ou error.
4. Produza um link para os resultados da verificação combinando slug a partir da etapa 2. com o URL da sua instância Webhood, por exemplo https://yourwebhoodinstance.example/scan/{slug}.

O exemplo a seguir mostra um manual do Sentinel com um gatilho Entity:

Problemas conhecidos e limitações

• O Get screenshot by scan ID retorna uma captura de tela do site. No entanto, atualmente não há nenhuma maneira de exibir a imagem no Power Automate. Solução alternativa simples é usar a Get scan by ID ação para obter o e abri-lo url em um navegador.

Erros e soluções comuns

• Erro: 401 Unauthorized - A chave da API é inválida ou expirou.
• A verificação permanece no pending status por um longo tempo - Certifique-se de ter implantado uma instância do Scanner e ela esteja em execução. Verifique se há erros nos logs do scanner.

FAQ

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limites de Limitação

Ações

Criar uma nova verificação

Obter captura de ecrã por ID de Análise

Obter digitalização por ID

Passe por verificações, opcionalmente filtre por status

Definições

Varredura