Datto Autotask

Über die Datto-Autotask-Integration erstellt SEC AUDITOR automatisiert ein Ticket in Autotask, sobald ein sicherheitsrelevantes Ereignis erkannt wird. Damit landen Befunde direkt in Ihrem PSA-Prozess und bleiben dort nachverfolgbar, statt manuell übertragen werden zu müssen.

Voraussetzungen

  • Einen aktiven SEC AUDITOR Account mit Serviceprovider-Zugang
  • Administrator-Zugriff auf Ihren Autotask-Mandanten, um einen API-Benutzer anzulegen
  • Ausreichend freie API-Benutzer-Lizenzen in Ihrem Autotask-Vertrag (ein dedizierter API-Benutzer wird benötigt, keine bestehende Techniker-Anmeldung)

Einrichtung

1. API-Benutzer in Autotask anlegen

Legen Sie einmalig pro Autotask-Mandant einen dedizierten API-Benutzer an, über den SEC AUDITOR sich authentifiziert:

  1. In Autotask oben rechts über das Zahnrad-Symbol Admin öffnen
    Autotask Kopfzeile mit geöffnetem Einstellungsmenü und dem Eintrag „Admin"
  2. Im Reiter Account Settings & Users zum Abschnitt Resources/Users (HR) scrollen und auf „Resources/Users" klicken
    Autotask Admin-Bereich, Reiter Account Settings & Users, mit dem Abschnitt Resources/Users (HR)
  3. Auf der Resources-Liste über den Pfeil neben „New" „New API User" wählen – nicht „New Resource"
    Autotask Resources-Liste mit aufgeklapptem New-Menü und dem Eintrag „New API User"
  4. Im Formular „Edit API User" mindestens First Name, Last Name und eine gültige Email Address vergeben (die E-Mail-Adresse ist zugleich der spätere API-Benutzername), „Active" angehakt lassen und als Security Level ein Profil mit API-Zugriff auf Firmen, Tickets und Ticket-Feldinformationen wählen – Autotask bietet dafür das mitgelieferte Profil „API User (system) Can't Read Costs" an
    Autotask „Edit API User"-Formular mit First Name, Last Name, Email Address, Active-Checkbox und Security-Level-Auswahl
  5. Unter „Credentials" ein Secret für den API-Benutzer vergeben (bzw. generieren lassen)
  6. Im Abschnitt „API-Tracking-Identifikator" die Option „Integrationsanbieter" auswählen und darunter als Integrationsanbieter „SEC AUDITOR UG" eintragen, dann speichern.
    Autotask „Edit API User"-Formular, Abschnitt API-Tracking-Identifikator mit ausgewählter Option „Integrationsanbieter" und dem Wert „SEC AUDITOR UG"

Hinweis

Verwenden Sie für die Integration einen eigenen, dedizierten API-Benutzer statt der Zugangsdaten eines echten Technikers – API-Benutzer zählen bei Autotask als eigene Lizenzklasse und lassen sich unabhängig von Personalwechseln verwalten.

2. Integration in SEC AUDITOR konfigurieren

Die Integration lässt sich unter „Domäne → Einstellungen → Integrationen → Autotask PSA“ konfigurieren.

  1. API-Benutzername (die E-Mail-Adresse aus Schritt 1) und das Secret eintragen und fortfahren – die Verbindung wird dabei geprüft und die Autotask-Zonen-URL automatisch ermittelt
  2. Die Firma auswählen, unter der Tickets angelegt werden sollen (bei genau einer gefundenen Firma wird sie automatisch vorausgewählt)
  3. Warteschlange und Standard-Status aus den aus Autotask geladenen Auswahllisten wählen – Autotask lehnt Tickets ohne Warteschlange ab
  4. Für jede Kritikalitätsstufe (Kritisch, Hoch, Mittel, Niedrig, Info) eine Autotask-Priorität festlegen – ohne vollständige Zuordnung lässt sich die Einrichtung nicht abschließen
  5. Optional Tickettyp und Abrechnungscode-ID setzen (Abrechnungscode nur nötig, wenn die Firma in Autotask einen Arbeitstyp erzwingt) sowie die Fälligkeit in Tagen anpassen (Standard: 7)
  6. Auslöser (neu / erneut aufgetreten / behoben) festlegen und die gewünschten Kritikalitätsstufen einzeln auswählen (Standard: Kritisch, Hoch und Mittel aktiv, Niedrig und Info aus), Integration aktivieren und speichern

Ab jetzt wird jedes Sicherheitsereignis, das die konfigurierten Filter erfüllt, automatisch als Ticket an Autotask übergeben.

Ticket-Inhalt

Jedes Ticket enthält im Titel den Änderungstyp und den Titel des Findings (z. B. „NEW …“), in der Beschreibung Details wie betroffenes Objekt und Kritikalität als Klartext (Autotask rendert kein HTML). Priorität und Fälligkeitsdatum richten sich nach der in SEC AUDITOR hinterlegten Zuordnung bzw. Fälligkeit in Tagen. Jedes Ticket erhält zusätzlich eine deterministische externe ID, über die Autotask ein bereits angelegtes Ticket zum selben Finding wiedererkennt.

Fehlerbehebung

MeldungUrsache → Lösung
Fehler beim Speichern der Zugangsdaten / Verbindungstest schlägt fehlAPI-Benutzername oder Secret falsch, oder der API-Benutzer ist in Autotask nicht mehr aktiv → Zugangsdaten und Status des API-Benutzers in Autotask prüfen
Firmenliste konnte nicht geladen werdenDem Security Level des API-Benutzers fehlt der Lesezugriff auf Firmen → Security Level in Autotask anpassen oder das Profil „API User (system) Can't Read Costs" verwenden
Auswahllisten (Warteschlange/Status/Priorität/Tickettyp) konnten nicht geladen werdenDem Security Level des API-Benutzers fehlt der Zugriff auf die Ticket-Feldinformationen → Security Level in Autotask anpassen
Es wurde keine Autotask-Firma gefundenIm Autotask-Mandanten existiert keine aktive Firma, oder der API-Benutzer sieht keine → Firmenstatus in Autotask prüfen und Liste neu laden
„Bitte eine Priorität auswählen“ trotz vollständig wirkender KonfigurationEs fehlt die Priorität für eine einzelne Kritikalitätsstufe – die Meldung nennt die betroffene Stufe → fehlende Stufe im Schritt „Ticket-Ziel“ ergänzen
Tickets werden nicht angelegt, obwohl die Verbindung funktioniertAuslöser- oder Kritikalitäts-Filter der Integration greifen nicht auf das Ereignis zu, oder die Integration ist deaktiviert → Einstellungen unter „Domäne → Einstellungen → Integrationen → Autotask PSA“ prüfen
Ticket-Erstellung schlägt dauerhaft fehl (z. B. wegen fehlendem Abrechnungscode)Die Firma in Autotask erzwingt einen Arbeitstyp/Abrechnungscode, der in SEC AUDITOR nicht hinterlegt ist → passende Abrechnungscode-ID im Schritt „Ticket-Ziel“ eintragen

Nicht die richtige Antwort gefunden?

Wir helfen gerne weiter!

Support kontaktieren