Ce guide vous accompagne dans la configuration et la gestion de l'intégration CyberHoot–ConnectWise PSA à l'aide de la plateforme CyberHoot Autopilot. Une fois la connexion établie, les utilisateurs des entreprises ConnectWise associées aux locataires CyberHoot sont automatiquement inscrits à la formation en cybersécurité CyberHoot et leurs données sont synchronisées chaque nuit.
Fonctionnement de l'intégration :
- Entreprises: Les entreprises ConnectWise que vous associez à des locataires CyberHoot voient leurs utilisateurs synchronisés dans CyberHoot.
- Utilisateurs: Chaque utilisateur actif d'une entreprise répertoriée, disposant d'une adresse électronique, est ajouté à CyberHoot pour une formation en cybersécurité. Les utilisateurs marqués comme inactifs dans ConnectWise sont ignorés et archivés dans CyberHoot s'ils ont été synchronisés précédemment.
- Horaire : La synchronisation s'exécute automatiquement une fois par jour, vers 12h30 dans le fuseau horaire de votre déploiement. Vous pouvez également l'exécuter à la demande. Synchroniser maintenant.
- Lecture seule : CyberHoot consulte uniquement les entreprises présentes dans votre instance ConnectWise PSA ainsi que leurs contacts. Il n'écrit jamais dans votre instance ConnectWise et utilise ces informations uniquement à des fins de formation en cybersécurité.
1. Créez des identifiants API dans ConnectWise PSA :
CyberHoot a besoin d'identifiants API pour communiquer avec votre compte ConnectWise. Créez-les d'abord dans ConnectWise, puis importez-les dans CyberHoot.
- Dans ConnectWise PSA, accédez à Système > Rôles de sécurité et créer un rôle (par exemple API CyberHoot) avec Demander (accès en lecture seule) à Entreprises > Maintenance des entreprises et Entreprises > Contacts.
- Allez dans Système > Membres, ouvre le Membres de l'API onglet et cliquez + Pour créer un nouveau membre API, attribuez-lui le rôle en lecture seule que vous venez de créer et enregistrez.
- Sur ce membre API, ouvrez le Clés de l'API onglet, cliquez sur +, donnez à la clé une description de CyberHoot et enregistrez. Copiez le Clé publique et Clé privéeLa clé privée n'est affichée qu'une seule fois.
- Connectez-vous à la Réseau de développeurs ConnectWise (developer.connectwise.com), ouvert Identité du client et enregistrez un nouvel ID client pour l'intégration CyberHoot. Copiez le fichier généré. identité du client.
- Notez votre Numéro d'identification fiscale (l'entreprise auprès de laquelle vous vous connectez) et votre hébergeur d'API pour votre région.
Vous aurez besoin des valeurs suivantes à l'étape suivante :
- URL du site ConnectWise – votre hôte d'API ConnectWise, par exemple https://api-na.myconnectwise.net (utilisez api-eu ou api-au pour les régions UE ou AU, ou votre propre URL de serveur si vous êtes sur site).
- Numéro d'identification fiscale – l’identifiant de l’entreprise que vous utilisez pour vous connecter à ConnectWise PSA.
- Clé publique – la clé publique générée pour le membre de l'API CyberHoot.
- Clé privée – la clé privée générée pour le membre de l'API CyberHoot.
- identité du client – l’identifiant client que vous avez enregistré sur le réseau de développeurs ConnectWise.
2. Connectez-vous à CyberHoot en mode pilote automatique :
- Sur la plateforme CyberHoot Autopilot, accédez à Tableau de bord partenaire > Intégrations.
- Sélectionner ConnectWise PSA et cliquez "Commencer ».
- Saisissez les valeurs que vous avez recueillies à l'étape 1 : URL du site ConnectWise, Numéro d'identification fiscale, Clé publique, Clé privée, identité du client.
- Cliquez sur "Connectez-vous à ConnectWise PSACyberHoot valide les identifiants auprès de ConnectWise avant de les enregistrer.
Remarque : Si la connexion échoue, vérifiez l’URL du site ConnectWise et assurez-vous que les identifiants ont été copiés sans espaces au début ni à la fin.
3. Cartographier les entreprises et synchroniser :
- Sur la même page, cliquez sur «Sociétés de cartographieCyberHoot affiche à gauche la liste de toutes les entreprises de votre compte ConnectWise et à droite un menu déroulant présentant vos locataires CyberHoot.
- Pour chaque entreprise ConnectWise que vous souhaitez former, sélectionnez le locataire CyberHoot correspondant dans la liste déroulante. Vous pouvez également choisir Créer en tant que nouveau locataire automatique (la formation commence le lendemain) ou Créer un nouveau locataire Power pour que CyberHoot crée le locataire pour vous.
- Cliquez sur "Sociétés de cartographie« » en bas de la fenêtre pour enregistrer les correspondances.
- Cliquez sur "Synchroniser maintenant« pour effectuer la première synchronisation. » Journal de synchronisation indique le nombre de clients mis à jour et le nombre d'utilisateurs ajoutés, mis à jour ou ignorés.
Remarque : Lorsque vous consultez les utilisateurs d'un locataire CyberHoot mappé, le « Type » de l'utilisateur affichera « ConnectWise ».
4. Gestion continue :
- Les nouveaux utilisateurs ajoutés à une entreprise cartographiée dans ConnectWise sont automatiquement pris en compte lors de la prochaine synchronisation nocturne (ou immédiatement avec Synchroniser maintenant).
- Pour interrompre la formation d'un utilisateur, désactivez-le (ou supprimez son adresse e-mail) dans ConnectWise. Ses données seront archivées dans CyberHoot lors de la prochaine synchronisation.
- Pour commencer la formation d'un nouveau client, associez son entreprise ConnectWise à un locataire CyberHoot à l'aide de la fonction « Associer les entreprises ».
- Le Dernière heure de synchronisation et Journal de synchronisation La page d'intégration affiche ce qui s'est passé lors de la dernière exécution.
5. Suppression d'une entreprise :
- Sur la plateforme CyberHoot Autopilot, accédez à Tableau de bord partenaire > Intégrations.
- Sélectionner ConnectWise PSA et cliquez "Sociétés de cartographie ».
- Cliquez sur le rouge "X» à côté de l'entreprise que vous souhaitez supprimer, puis cliquez sur «Sociétés de cartographie" sauver.
- Cliquez sur "Synchroniser maintenant« pour achever le retrait. »
Remarque : La suppression du mappage d’une entreprise archive tous les utilisateurs synchronisés de ce tenant dans CyberHoot. Vous pouvez facilement les rajouter en mappant à nouveau l’entreprise et en effectuant une synchronisation.
6. Déconnexion de l'intégration (si nécessaire) :
- Sur la plateforme CyberHoot Autopilot, accédez à Tableau de bord partenaire > Intégrations.
- Sélectionner ConnectWise PSA et cliquez "Disconnect ».
Remarque : Choisissez soigneusement l'option ci-dessous.
Si vous souhaitez continuer à utiliser CyberHoot sans l'intégration avec ConnectWise, choisissez « Déconnecter et configurer en local ». Tous les utilisateurs synchronisés seront alors gérés localement dans CyberHoot.
Si vous prévoyez d'archiver tous les utilisateurs synchronisés dans CyberHoot après la déconnexion, sélectionnez « Déconnexion et archivage ».
La déconnexion supprime les paramètres d'intégration et les mappages d'entreprise de CyberHoot. CyberHoot ne modifie jamais rien dans votre instance ConnectWise.
Autres intégrations CyberHoot :