Scanneur d’URL Webhood (préversion)

Il s’agit du schéma Swagger 2.0 pour l’API du scanneur d’URL Webhood

Ce connecteur est disponible dans les produits et régions suivants :

Webhood est un scanneur d’URL privé utilisé par les chasseurs de menaces et les analystes de sécurité pour analyser le hameçonnage et les sites malveillants. Ce connecteur vous permet de contrôler les analyses à l’aide d’Azure Logic Apps et de Power Automate.

Prerequisites

• Instance webhood

L’instance Webhood peut être auto-hébergée en suivant les instructions de déploiement du scanneur d’URL Webhood . Le connecteur est testé avec la dernière version de Webhood.

Vous pouvez également obtenir une version hébergée de Webhood en vous inscrivant à Webhood Cloud.

• Clé API

La clé API est utilisée pour authentifier le connecteur auprès de l’instance Webhood. Consultez Obtenir des informations d’identification pour obtenir des instructions sur la création d’une clé API.

• Certificat HTTPS valide pour l’instance Webhood si vous utilisez HTTPS (requis pour Power Automate)

Comment obtenir des informations d’identification

1. Connectez-vous à votre instance Webhood avec un compte d’administrateur.
2. Accédez à Settings ->>AccountsAPI Tokens pour créer une clé API.
3. Sélectionnez Add Token et sélectionnez scanner le rôle.
4. Copiez la clé API générée (Token) et utilisez-la API Key comme connecteur.

La clé API ne s’affiche qu’une seule fois, car elle n’est pas stockée dans votre instance Webhood.

Notez que toutes les clés API expirent après 365 jours. Vous pouvez créer une clé API à tout moment. Si vous souhaitez révoquer une clé API, vous pouvez la supprimer de l’instance Webhood en sélectionnant Revoke. Nous vous recommandons de noter l’ID du jeton afin de pouvoir l’identifier ultérieurement.

Bien démarrer avec votre connecteur

La fonctionnalité clé de ce connecteur est la possibilité d’analyser les URL pour le hameçonnage et le contenu malveillant. Le connecteur fournit des actions pour créer une analyse, obtenir des analyses passées, obtenir l’analyse par ID et obtenir une capture d’écran par ID d’analyse.

Cela vous permet d’automatiser le processus d’analyse et de l’intégrer à d’autres services. Par exemple, vous pouvez créer une analyse lorsqu’une nouvelle URL est ajoutée à une liste SharePoint ou obtenir les résultats de l’analyse lorsqu’une analyse est terminée.

Vous pouvez également intégrer ce connecteur à Microsoft Sentinel pour analyser automatiquement les URL à partir d’alertes de sécurité.

Exemple de flux simple :

1. Create a new scan - Déclencher une nouvelle analyse pour une URL avec une entrée, par exemple https://example.com.
2. Get scan by ID - Obtenez les détails de l’analyse en fournissant l’ID d’analyse de l’étape précédente.
3. Effectuez une boucle jusqu’à ce que l’état de l’analyse soit done ou error.
4. Affichez un lien vers les résultats de l’analyse en combinant slug l’étape 2. avec l’URL de votre instance Webhood, par exemple https://yourwebhoodinstance.example/scan/{slug}.

L’exemple suivant montre un playbook Sentinel avec un déclencheur d’entité :

Problèmes connus et limitations

• Retourne Get screenshot by scan ID une capture d’écran du site. Toutefois, il n’existe actuellement aucun moyen d’afficher l’image dans Power Automate. La solution de contournement simple consiste à utiliser l’action Get scan by ID pour l’obtenir url et l’ouvrir dans un navigateur.

Erreurs courantes et solutions

• Erreur : 401 Unauthorized - La clé API n’est pas valide ou a expiré.
• L’analyse reste dans l’état pending pendant longtemps : vérifiez que vous avez déployé une instance de scanneur et qu’elle est en cours d’exécution. Vérifiez les journaux d’activité du scanneur pour toutes les erreurs.

Questions fréquentes (FAQ)

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Ce n’est pas une connexion partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Limitations

Actions

Créer une analyse

Obtenir les analyses passées, filtrer éventuellement par état

Obtenir l’analyse par ID

Obtenir une capture d’écran par ID d’analyse

Définitions

Scan