In diesem Artikel erfahren Sie alles, was Sie über die Integrationen zwischen den HEIMDAL-Diensten und anderen RMM-/PSA-Tools wie ConnectWise wissen müssen. Kunden und Partner von HEIMDAL, die die Plattform ConnectWise PSA verwenden, können eine praktische Integration nutzen, mit der sich die Verwaltung von Tickets in der ConnectWise-Plattform automatisieren lässt.
1. Wie funktioniert es?
2. Einrichtung der ConnectWise-PSA-Integration
3. Heimdal Operations
4. Heimdal Cyber Alerts
5. Heimdal M365 Notifications
WIE FUNKTIONIERT ES?
Kunden und Partner von HEIMDAL, die die Plattform ConnectWise PSA verwenden, können eine praktische Integration nutzen, mit der sich die Verwaltung von Tickets in der ConnectWise-Plattform automatisieren lässt. Die Integration HEIMDAL-ConnectWise ermöglicht es Kunden, mehrere HEIMDAL-Warnungen/Benachrichtigungen als Tickets in 3 Boards zu erhalten, die in ConnectWise erstellt werden: Heimdal Operations service board (CPU- oder Speicherbenachrichtigungen, Festplattenbenachrichtigungen, Benachrichtigungen zu Microsoft-Updates, Benachrichtigungen zu Next-Gen Antivirus, Benachrichtigungen zu DNS-Poisoning oder Firewall-Benachrichtigungen), Heimdal Cyber Alerts service board (Warnungen zum Ransomware Encryption Protection, Warnungen zum Privileged Access Management, Warnungen zu Next-Gen Antivirus, Warnungen zur VectorN Detection, Zero-Trust-Warnungen) und Heimdal M365 Notifications board (LAD-Warnungen, REP-Cloud-Warnungen, Warnungen zu Weiterleitungsregeln, Warnungen zur Benutzer-Compliance).
EINRICHTUNG DER CONNECTWISE-PSA-INTEGRATION
Für die Integration sind ein für ein bestimmtes Mitglied generierter API-Schlüssel und eine benutzerdefinierte Sicherheitsrolle erforderlich. Führen Sie zum Generieren eines API-Schlüssels die folgenden Schritte aus:
1. Gehen Sie in ConnectWise zu Systems -> Members und klicken Sie auf API Members. Klicken Sie anschließend auf das Symbol + (Plus).
2. Geben Sie die Benutzerdaten ein und klicken Sie auf Save, um das neue Mitglied zu speichern.
3. Klicken Sie in der Mitgliederliste auf das neue Mitglied und anschließend auf API Keys. Klicken Sie danach auf das Symbol + (Plus).
4. Geben Sie im Feld Description eine Beschreibung für den neuen Schlüssel ein (Beispiel: ConnectWise_Heimdal_integration). Klicken Sie auf Save (verwenden Sie nicht die Option Save and Close).
Es werden zwei API-Schlüssel generiert und angezeigt: ein öffentlicher Schlüssel und ein privater Schlüssel. Der private Schlüssel wird nur bei der Erstellung des Schlüssels angezeigt. Notieren Sie sich beide Schlüssel oder kopieren Sie sie an einen sicheren Ort, da sie nach dem Schließen der Registerkarte nicht wiederhergestellt werden können.
Berechtigungen für API-Mitglieder einrichten
Die Berechtigungen basieren auf Sicherheitsrollen. Führen Sie zum Festlegen der Berechtigungen die folgenden Schritte aus:
1. Gehen Sie zu System -> Security Roles und wählen Sie eine Rolle für die Integration aus.
2. Legen Sie Member als Security Permission fest und klicken Sie auf Companies.
3. Legen Sie in den Berechtigungen für Company Maintenance den Wert All für Inquire Level fest.
4. Legen Sie unter Service Desk für Close Service Tickets, Resource Scheduling den Wert All für Add Level, Edit Level, Inquire Level und für Service Tickets den Wert All für Add Level, Edit Level, Delete Level, Inquire Level fest:
5. Legen Sie unter System für Member Maintenance, My Account, My Company den Wert All für Inquire Level und für Table Setup den Wert All für Add Level, Edit Level, Inquire Level fest:
ConnectWise im HEIMDAL Dashboard einrichten
Die ConnectWise-Integration kann aktiviert werden, indem Sie im Abschnitt Guide -> Customer settings -> Integrations -> ConnectWise PSA des HEIMDAL Dashboard das Kontrollkästchen ConnectWise PSA aktivieren. Nach der Aktivierung können Sie mit den Integrationseinstellungen fortfahren, indem Sie den Company Identifier (eine Zeichenfolge, die Ihren eindeutigen Unternehmensbezeichner darstellt und der My Company ID entspricht), die Base API URL (regionale Basis-URL, Beispiel: api-eu.myconnectwise.net), den Public Key (öffentlicher Schlüssel des generierten Mitglieds, verfügbar unter ConnectWise -> System -> Members -> API Keys) und den Private Key (privater Schlüssel des generierten Mitglieds, der bei der Erstellung eines neuen Mitglieds in ConnectWise generiert wird) angeben:
Schaltflächen „Test Connection“ und „Save“
Die Funktionen Test Connection und Save sind zentrale Elemente im Konfigurationsprozess der Integrationseinstellungen im Heimdal Dashboard. Zum Abschließen der Einrichtung müssen Benutzer den Company Identifier, die Base API URL, den Public Key und den Private Key eingeben.
Sobald die erforderlichen Informationen eingegeben wurden, kann die Schaltfläche Test Connection verwendet werden, um einen dedizierten API-Aufruf durchzuführen. Wenn eine positive Antwort eingeht, wird die Schaltfläche Save aktiviert. Durch Klicken auf Save wird eine Bestätigungsmeldung in grüner Schrift angezeigt, die angibt, dass die Verbindung erfolgreich gespeichert wurde.
Die Konfigurationsschaltflächen im Abschnitt Matching Settings, Configure Heimdal Operations, Configure Heimdal Cyber Alerts, Configure M365 Notifications und Sync Customers (nur auf Reseller-Ebene) bleiben deaktiviert, bis die Einstellungen gespeichert wurden. Nach dem Speichern werden diese Schaltflächen aktiviert und ermöglichen weitere Konfigurationsänderungen für Device oder M365 Views.
Wenn eine vorhandene Einstellung geändert wird, erscheint beim Speichern ein Bestätigungs-Pop-up, in dem gefragt wird, ob die aktuellen Ticket- und Kundeneinstellungen beibehalten werden sollen. Dadurch können Benutzer ihre Konfigurationen beibehalten, ohne sie unnötigerweise neu konfigurieren zu müssen.
Ticketkonfiguration
Der Dashboard-Benutzer kann jedes in seiner ConnectWise-Instanz verfügbare Board auswählen.
Durch Klicken auf Configure Heimdal Operations, Configure Heimdal Cyber Alerts oder Configure M365 Notifications, wird ein Konfigurations-Pop-up angezeigt, das eine Liste der Ticketfelder aus der ConnectWise-API abruft, basierend auf den festgelegten Verbindungseinstellungen für Device oder M365 Views. Zunächst sollte der Benutzer ein ConnectWise-Board auswählen. Nach der Auswahl des Boards sollte der Benutzer die zugehörigen Felder des Boards zuordnen. Für die Zuordnung können verschiedene Elemente ausgewählt und anschließend zur Ticketerstellung verwendet werden. Die Liste der Felder für die Ticketkonfiguration lautet wie folgt:
- Type: aus dem für das zuvor ausgewählte Board verfügbaren Typsatz auszuwählen;
- Subtype: aus dem für das ausgewählte Board verfügbaren Subtypsatz auszuwählen;
- Heimdal Operations - CPU, MEM, DISK, MU, AV, DNSP, FW;
- Heimdal Cyber Alerts - REP, PAM, NextGen Antivirus, VND, ZT;
- Heimdal M365 Notifications - LAD, REP Cloud, Forwarding Rules, User Compliance ; - Status on ticket creation/update: aus dem für das ausgewählte Board verfügbaren Statussatz auszuwählen;
Hinweis: Der Status bei der Ticketaktualisierung ist nur für Tickets des Typs Heimdal Operations verfügbar; - Item: aus dem für das ausgewählte Board verfügbaren Elementsatz auszuwählen;
- Priority: aus dem Prioritätensatz auszuwählen.
Alle Auswahlen mit Ausnahme von „Priority“ werden basierend auf dem ausgewählten Board vorgenommen. Sobald Sie diese Einstellungen bestätigen, werden die 3 Boards (Heimdal Operations, Heimdal Cyber Alerts und Heimdal M365 Notifications) in ConnectWise PSA erstellt:
HEIMDAL OPERATIONS
Das ConnectWise-Serviceboard Heimdal Operations zeigt alle Tickets an, die sich auf die Benachrichtigungen aus dem Benachrichtigungsfenster im HEIMDAL Dashboard beziehen (Active Clients -> Standard view und mit Warnungen zu CPU, Memory, Disk, Microsoft Updates, Next-Gen Antivirus, DNS Poisoning und Firewall verbunden sind). Jedes Mal, wenn der HEIMDAL Agent in den ClientInfo eine Benachrichtigung generiert, wird ein neues Ticket im Heimdal Operations-Serviceboard (in ConnectWise) erstellt. Um die Tickets in ConnectWise PSA anzuzeigen, gehen Sie zu Service Desk -> Service Boards und filtern Sie die Daten nach Heimdal Operations:
Alle neu erstellten Tickets erhalten den Status New und einen der folgenden Typen: CPU, Memory, Disk, DNS Poisoning, Firewall, Microsoft Updates oder Next-Gen Antivirus. Wenn eine Benachrichtigung im HEIMDAL Dashboard nicht mehr vorhanden ist, wird der Ticketstatus automatisch in Closed geändert.
WICHTIG
Betriebliche Tickets können über die ConnectWise-Integration geschlossen werden, sobald die Warnungen gelöst wurden. Damit Tickets in ConnectWise PSA automatisch erstellt/geschlossen werden, müssen die folgenden Warnungen in der HEIMDAL Dashboard - Device View aktiviert sein:
HEIMDAL CYBER ALERTS
Das ConnectWise-Serviceboard Heimdal Cyber Alerts zeigt alle Tickets an, die sich auf alle E-Mail-Warnungen aus dem Abschnitt Accounts des HEIMDAL Dashboard beziehen, mit Ausnahme der Warnungen zu GP-Änderungen und Microsoft-Updates. Um die Tickets in ConnectWise PSA anzuzeigen, gehen Sie zu Service Desk -> Service Boards und filtern Sie die Daten nach Heimdal Cyber Alerts:
Alle neu erstellten Tickets erhalten den Status New und einen der folgenden Typen: Privileged Access Management, Ransomware Encryption, Next-Gen Antivirus, VectorN Detection oder Zero-Trust.
WICHTIG
Damit Tickets in ConnectWise PSA automatisch erstellt werden, müssen die folgenden Warnungen in der HEIMDAL Dashboard - Device View aktiviert sein:
HEIMDAL M365 NOTIFICATIONS
Das ConnectWise-Serviceboard Heimdal M365 Notifications zeigt alle Tickets an, die sich auf alle E-Mail-Warnungen aus dem Abschnitt M365 User Security des HEIMDAL Dashboard beziehen. Um die Tickets in ConnectWise PSA anzuzeigen, gehen Sie zu Service Desk -> Service Boards und filtern Sie die Daten nach Heimdal M365:
Alle neu erstellten Tickets erhalten den Status New und einen der folgenden Typen:
LAD Alerts (Kurzname: LAD) – Verwaltet Tickets für LAD. Dazu gehören Benachrichtigungen zu ungewöhnlichen Anmeldungen, unmöglichen Reisen, verdächtigen Browsern und anonymisierten sowie IP-Adressen;
REP Cloud Alerts (Kurzname: REP-C) – Verwaltet REP-Cloud-Erkennungen;
Forwarding Rules Alerts (Kurzname: FW-R) – Verwaltet Erkennungen von Weiterleitungsregeln;
User compliance notifications (Kurzname: SEC-I) – Verwaltet Tickets zur Benutzer-Compliance. Dazu gehören Benachrichtigungen zu deaktiviertem MFA, deaktivierten sicheren Passwörtern und deaktiviertem Passwortablauf.
WICHTIG
Damit Tickets in ConnectWise PSA automatisch erstellt werden, müssen die folgenden Warnungen in der HEIMDAL Dashboard - M365 View aktiviert sein: