Diese Anleitung führt Sie durch die Einrichtung und Verwaltung der CyberHoot-ConnectWise-PSA-Integration mithilfe der CyberHoot-Autopilot-Plattform. Nach der Verbindung werden die Benutzer der ConnectWise-Unternehmen, die Sie CyberHoot-Mandanten zuordnen, automatisch für CyberHoot-Cybersicherheitsschulungen angemeldet und jede Nacht synchronisiert.
Was die Integration bewirkt:
- Firmen: ConnectWise-Unternehmen, die Sie CyberHoot-Mandanten zuordnen, haben ihre Benutzer in CyberHoot synchronisiert.
- Benutzer: Alle aktiven Nutzer eines erfassten Unternehmens mit einer E-Mail-Adresse werden für Cybersicherheitsschulungen zu CyberHoot hinzugefügt. In ConnectWise als inaktiv markierte Nutzer werden übersprungen und in CyberHoot archiviert, sofern sie zuvor synchronisiert wurden.
- Schedule: Die Synchronisierung läuft automatisch einmal täglich, gegen 12:30 Uhr in der Zeitzone Ihres Einsatzortes. Sie können sie auch manuell ausführen. Jetzt synchronisieren.
- Schreibgeschützt: CyberHoot liest ausschließlich die in Ihrer ConnectWise PSA-Instanz gespeicherten Unternehmen und deren Kontaktdaten. Es werden niemals Daten in Ihre ConnectWise-Instanz geschrieben, und diese Informationen werden ausschließlich für Cybersicherheitsschulungen verwendet.
1. API-Zugangsdaten in ConnectWise PSA erstellen:
CyberHoot benötigt API-Zugangsdaten für die Kommunikation mit Ihrem ConnectWise-Konto. Erstellen Sie diese zuerst in ConnectWise und übertragen Sie sie anschließend auf CyberHoot.
- Gehen Sie in ConnectWise PSA zu System > Sicherheitsrollen und eine Rolle erstellen (zum Beispiel CyberHoot API) mit Kontakt (Nur-Lese-)Zugriff auf Unternehmen > Unternehmenspflege und Unternehmen > Kontakte.
- Zurück Nach System > Mitglieder, öffne das API-Mitglieder Tab und klicken Sie auf + Um ein neues API-Mitglied zu erstellen, weisen Sie ihm die soeben erstellte Rolle „Nur Lesen“ zu und speichern Sie die Einstellungen.
- Öffnen Sie auf diesem API-Mitglied die API-Keys Tab, klicken Sie auf +Geben Sie dem Schlüssel eine Beschreibung von CyberHoot und speichern. Kopieren Sie die public Key und Private KeyDer private Schlüssel wird nur einmal angezeigt.
- Melden Sie sich bei der an ConnectWise-Entwicklernetzwerk (developer.connectwise.com), offen Kunden ID und registrieren Sie eine neue Client-ID für die CyberHoot-Integration. Kopieren Sie die generierte Kunden-ID.
- Notieren Sie Ihre Firmen-ID (das Unternehmen, mit dem Sie sich anmelden) und Ihr API-Host für Ihre Region.
Im nächsten Schritt benötigen Sie folgende Werte:
- ConnectWise-Website-URL – Ihr ConnectWise API-Host, zum Beispiel https://api-na.myconnectwise.net (verwenden Sie api-eu oder api-au für die Regionen EU oder AU, oder Ihre eigene Server-URL, wenn Sie On-Premise sind).
- Firmen-ID – die Firmen-ID, mit der Sie sich bei ConnectWise PSA anmelden.
- public Key – der für das CyberHoot-API-Mitglied generierte öffentliche Schlüssel.
- Private Key – der für das CyberHoot-API-Mitglied generierte private Schlüssel.
- Kunden-ID – die Client-ID, die Sie im ConnectWise Developer Network registriert haben.
2. Verbindung zu CyberHoot im Autopilotmodus herstellen:
- Navigieren Sie auf der CyberHoot Autopilot-Plattform zu Partner-Dashboard > Integrationen.
- Auswählen ConnectWise PSA und klicke auf "Loslegen".
- Geben Sie die in Schritt 1 gesammelten Werte ein: ConnectWise-Website-URL, Firmen-ID, public Key, Private Key, Kunden-ID.
- Durch Anklicken von „Verbindung zu ConnectWise PSA herstellenCyberHoot validiert die Anmeldeinformationen anhand von ConnectWise, bevor sie gespeichert werden.
Hinweis: Sollte die Verbindung fehlschlagen, überprüfen Sie die ConnectWise-Site-URL und stellen Sie sicher, dass die Anmeldeinformationen ohne führende oder nachfolgende Leerzeichen kopiert wurden.
3. Kartenunternehmen und Synchronisierung:
- Klicken Sie auf derselben Seite auf „KartenunternehmenCyberHoot listet links alle Unternehmen Ihres ConnectWise-Kontos auf, rechts befindet sich ein Dropdown-Menü mit Ihren CyberHoot-Mandanten.
- Wählen Sie für jedes ConnectWise-Unternehmen, das Sie schulen möchten, den entsprechenden CyberHoot-Mandanten aus der Dropdown-Liste aus. Sie können auch auswählen Als neuen automatischen Mandanten erstellen (Das Training beginnt am nächsten Tag) oder Als neuen Power-Mandanten erstellen Lassen Sie CyberHoot den Mandanten für Sie erstellen.
- Durch Anklicken von „KartenunternehmenGeben Sie unten im Fenster " ein, um die Zuordnungen zu speichern." ein.
- Durch Anklicken von „Jetzt synchronisieren„um die erste Synchronisation durchzuführen.“ Protokoll synchronisieren zeigt an, wie viele Kunden aktualisiert wurden und wie viele Benutzer hinzugefügt, aktualisiert oder übersprungen wurden.
Hinweis: Wenn Sie die Benutzer innerhalb eines zugeordneten CyberHoot-Mandanten betrachten, wird der Benutzertyp als „ConnectWise“ angezeigt.
4. Laufende Verwaltung:
- Neue Benutzer, die einem zugeordneten Unternehmen in ConnectWise hinzugefügt werden, werden automatisch bei der nächsten nächtlichen Synchronisierung (oder sofort mit Jetzt synchronisieren).
- Um die Schulung eines Benutzers zu beenden, markieren Sie ihn in ConnectWise als inaktiv (oder entfernen Sie seine E-Mail-Adresse). Er wird beim nächsten Synchronisieren in CyberHoot archiviert.
- Um mit der Schulung eines neuen Kunden zu beginnen, ordnen Sie dessen ConnectWise-Unternehmen einem CyberHoot-Mandanten über „Unternehmen zuordnen“ zu.
- Das Letzte Synchronisierungszeit und Protokoll synchronisieren Auf der Integrationsseite wird angezeigt, was beim letzten Durchlauf passiert ist.
5. Entfernung eines Unternehmens:
- Navigieren Sie auf der CyberHoot Autopilot-Plattform zu Partner-Dashboard > Integrationen.
- Auswählen ConnectWise PSA und klicke auf "Kartenunternehmen".
- Klicken Sie auf das rote „XKlicken Sie neben dem Unternehmen, das Sie entfernen möchten, auf „Kartenunternehmen" speichern.
- Durch Anklicken von „Jetzt synchronisieren„um die Entfernung abzuschließen.“
Hinweis: Durch das Aufheben der Zuordnung eines Unternehmens werden alle synchronisierten Benutzer dieses Mandanten in CyberHoot archiviert. Sie können diese einfach wieder hinzufügen, indem Sie das Unternehmen erneut zuordnen und eine Synchronisierung durchführen.
6. Trennung der Integration (falls erforderlich):
- Navigieren Sie auf der CyberHoot Autopilot-Plattform zu Partner-Dashboard > Integrationen.
- Auswählen ConnectWise PSA und klicke auf "Disconnect".
Hinweis: Wählen Sie die unten stehende Option sorgfältig aus.
Wenn Sie CyberHoot ohne die Integration mit ConnectWise weiterhin nutzen möchten, wählen Sie „ Trennen & Lokal einrichten “. Dadurch werden alle synchronisierten Benutzer lokal in CyberHoot verwaltet.
Wenn Sie planen, alle synchronisierten Benutzer in CyberHoot nach dem Trennen der Verbindung zu archivieren, wählen Sie „ Trennen & Archivieren “.
Durch das Trennen der Verbindung werden die Integrationseinstellungen und Firmenzuordnungen aus CyberHoot entfernt. CyberHoot ändert jedoch niemals etwas an Ihrer ConnectWise-Instanz.
Weitere CyberHoot-Integrationen: