Zendesk in Google SecOps einbinden

In diesem Dokument wird beschrieben, wie Sie Zendesk in Google Security Operations einbinden.

Anwendungsfälle

Bei der Zendesk-Integration werden Google SecOps-Funktionen verwendet, um die folgenden Anwendungsfälle zu unterstützen:

  • Automatisierte Ticketbearbeitung bei Vorfällen: Erstellen Sie automatisch Zendesk-Tickets aus Sicherheitswarnungen, damit jeder Vorfall nachverfolgt und dem richtigen Team zugewiesen wird.

  • Analystenkommunikation optimieren: Sie können Tickets direkt über Playbooks Kommentare und interne Notizen hinzufügen, um Stakeholder zu informieren, ohne die Plattform verlassen zu müssen.

  • Workflows für Antworten standardisieren: Wenden Sie Zendesk-Makros auf Tickets an, um sich wiederholende Aktionen zu automatisieren und eine einheitliche Bearbeitung häufiger Sicherheitsprobleme zu gewährleisten.

  • Ticketbearbeitung verfolgen: Rufen Sie regelmäßig Ticketdetails und Statusaktualisierungen ab, um den Vorfalllebenszyklus auf beiden Plattformen zu synchronisieren.

  • Verlaufskontext durchsuchen: Fragen Sie vorhandene Tickets nach Stichwörtern ab, um ähnliche frühere Vorfälle zu finden und aktuelle Untersuchungen zu beschleunigen.

Hinweis

Bevor Sie die Integration in Google SecOps konfigurieren, prüfen Sie, ob die folgenden Anforderungen in Ihrer Zendesk-Umgebung erfüllt sind:

  • API-Token: Ein Administrator muss ein gültiges API-Token generieren, um die Verbindung zu authentifizieren. Eine detaillierte Anleitung finden Sie unter API-Token-Zugriff auf die Zendesk-API verwalten.

  • Kontoberechtigungen: Das Konto, mit dem das API-Token generiert wird, muss über ausreichende Berechtigungen zum Erstellen und Aktualisieren von Tickets in den Zielgruppen verfügen. Die API übernimmt die Berechtigungen des authentifizierenden Nutzers. Das bedeutet, dass ein von einem Administrator generiertes API-Token durch die Berechtigungen der zugewiesenen Rolle dieses Administrators eingeschränkt wird.

  • Token-Zugriff: Aktivieren Sie in Ihren Zendesk-API-Einstellungen Token-Zugriff, damit die Integration mit der Zendesk API kommunizieren kann.

Integrationsparameter

Für die Zendesk-Integration sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Server Address

Erforderlich.

Die URL Ihrer Zendesk-Instanz.

Der Standardwert ist https://{subdomain}.zendesk.com.
User Email Address

Erforderlich.

Die E-Mail-Adresse des Zendesk-Nutzerkontos, das zur Authentifizierung der Verbindung verwendet wird.
Api Token

Erforderlich.

Das eindeutige API-Token, das in den Administratoreinstellungen von Zendesk generiert wurde.

Eine Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.

Bei Bedarf können Sie später Änderungen vornehmen. Nachdem Sie eine Integrationsinstanz konfiguriert haben, können Sie sie in Playbooks verwenden. Weitere Informationen zum Konfigurieren und Unterstützen mehrerer Instanzen finden Sie unter Mehrere Instanzen unterstützen.

Aktionen

Weitere Informationen zu Aktionen finden Sie unter Ausstehende Aktionen über „Mein Arbeitsbereich“ bearbeiten und Manuelle Maßnahme ausführen.

Kommentar zum Ticket hinzufügen

Einem vorhandenen Ticket einen Kommentar hinzufügen

Parameter

Parameter Typ Standardwert Beschreibung
Ticket-ID String – Ticketnummer
Kommentartext String – –
Name des Autors String – –
Interner Hinweis Boolesch – –

Anwendungsfälle

–

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis
Name des Scriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
JSON-Ergebnis
N/A

Makros auf Tickets anwenden

Wenden Sie ein Makro auf ein Ticket an.

Parameter

Parameter Typ Standardwert Beschreibung
Ticket-ID String – Ticketnummer
Makrotitel String – –

Anwendungsfälle

–

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis
Name des Scriptergebnisses Wertoptionen Beispiel
is_applied Wahr/falsch is_applied:False
JSON-Ergebnis
N/A

Ticket erstellen

Erstellen Sie ein Ticket mit bestimmten Attributen.

Bekannte Einschränkungen

E‑Mail-Adressen mit Unicode-Zeichen werden von der Zendesk-API nicht unterstützt. Dies wirkt sich auf den Parameter „E-Mail-CC“ aus. Die Aktion ignoriert sie einfach.

Parameter

Parameter Typ Standardwert Beschreibung
Betreff String – –
Beschreibung String – –
Zugewiesener Nutzer String – Vollständiger Name des Nutzers.
Zuweisungsgruppe String – Gruppenname.
Priorität String – Die Priorität ist eine der folgenden: „Dringend“, „Hoch“, „Normal“ oder „Niedrig“.
Tickettyp String – Die Priorität ist eine der folgenden: „Dringend“, „Hoch“, „Normal“ oder „Niedrig“.
Tag String – –
Interner Hinweis Kästchen Nicht aktiviert Geben Sie an, ob der Kommentar öffentlich oder intern sein soll. Wenn das Kästchen nicht angekreuzt ist, ist die Funktion öffentlich. Wenn es angekreuzt ist, ist sie nur intern verfügbar.
E-Mail-Adressen in Cc CSV – Geben Sie eine durch Kommas getrennte Liste von E‑Mail-Adressen an, die ebenfalls die Benachrichtigung über die Ticketerstellung erhalten sollen. Hinweis: Es können maximal 48 CC-E‑Mail-Adressen hinzugefügt werden. Dies ist eine Zendesk-Einschränkung.
CC-Empfänger von E-Mails validieren Boolesch Aktiviert Wenn diese Option aktiviert ist, wird versucht, zu prüfen, ob Nutzer mit den im Parameter „Email CCs“ angegebenen E‑Mail-Adressen vorhanden sind. Wenn mindestens ein Nutzer nicht vorhanden ist, schlägt die Aktion fehl. Wenn dieser Parameter deaktiviert ist, wird diese Prüfung nicht durchgeführt.

Anwendungsfälle

–

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis
Name des Scriptergebnisses Wertoptionen Beispiel
ticket_id – –
JSON-Ergebnis
N/A
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Wenn „E-Mail-Adressen in CC validieren“ aktiviert ist und mindestens eine E-Mail-Adresse nicht gefunden wurde (Fehler): Fehler beim Ausführen der Aktion „{action name}“. Grund: Nutzer mit den folgenden E-Mail-Adressen wurden nicht gefunden: {entity.identifier}. Überprüfen Sie die Rechtschreibung oder deaktivieren Sie den Parameter „Validate Email CCs“ (E-Mail-Adressen in CC validieren).

Wenn mindestens eine Eingabe keine gültige E-Mail-Adresse ist: Fehler beim Ausführen der Aktion „{action name}“. Grund: Nutzer mit den folgenden E-Mail-Adressen wurden nicht gefunden: {entity.identifier}. Überprüfen Sie die Rechtschreibung oder deaktivieren Sie den Parameter „Validate Email CCs“ (E-Mail-Adressen in CC validieren).

 Allgemein

Ticketdetails abrufen

Rufen Sie Ticketdetails, Kommentare und Anhänge anhand der Ticket-ID ab.

Parameter

Parameter Typ Standardwert Beschreibung
Ticket-ID String – Die ID des Tickets.

Anwendungsfälle

–

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis
Name des Scriptergebnisses Wertoptionen Beispiel
ticket_details – –
JSON-Ergebnis
{
   "Details":
      {
        "ticket":
           {
             "follower_ids": [],
             "via":
               {
                     "source":
                           {"to": {},
                            "from": {},
                            "rel": "None"},
                    "channel": "web"
                },
              "updated_at": "2019-02-03T10:08:00Z",
              "submitter_id": 360638872459,
              "assignee_id": 360638872459,
              "brand_id": 360000159559,
              "id": 2,
              "custom_fields": [],
              "satisfaction_rating": "None",
              "sharing_agreement_ids": [],
              "allow_attachments": "True",
              "collaborator_ids": [],
              "priority": "high",
              "subject": "Test",
              "type": "incident",
              "status": "open",
              "description": "Test Test Test",
              "tags": ["test"],
              "forum_topic_id": "None",
              "organization_id": 360018882419,
              "due_at": "None",
              "is_public": "True",
              "requester_id": 360638872459,
              "followup_ids": [],
              "recipient": "None",
              "problem_id": "None",
              "url": "https://siemplifyhelp.zendesk.com/api/v2/tickets/2.json", "fields": [],
              "created_at": "2019-02-03T10:08:00Z",
              "raw_subject": "Test",
              "email_cc_ids": [],
              "allow_channelback": "False",
              "has_incidents": "False",
              "group_id": 360000361099,
              "external_id": "None"
           }
       },
    "Comments":
       [{
          "body": "Test Test Test",
          "plain_body": "Test Test Test",
          "via":
           {
              "source":
                      {"to": {},
                       "from": {},
                       "rel": "None"},
              "channel": "web"
            },
          "attachments":
           [{
              "thumbnails": [],
              "url": "https://siemplifyhelp.zendesk.com/api/v2/attachments/360701661660.json",
              "file_name": "Siemplify 10 2018-12-11 (1).lic",
              "content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
               "height": "None",
               "width": "None",
               "mapped_content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
               "content_type": "application/unknown",
               "inline": "False",
               "id": 360701661660,
               "size": 1272
            }],
          "audit_id": 393260420939,
          "created_at": "2019-02-03T10:08:00Z",
          "id": 393260420979,
          "author_id": 360638872459,
          "html_body": "<div> Test Test Test < br >< /div>",
          "type": "Comment",
          "public": "True",
          "metadata":
            {
               "system":
                  {
                     "latitude": 32.066599999999994,
                     "client": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36",
                      "ip_address": "1.1.1.1",
                      "location": "Tel Aviv, 05, Israel",
                      "longitude": 34.764999999999986
                   },
               "custom": {}
             }
         }],
     "Attachments": [{"test.txt": ""}]
 }

Ping

Verbindung testen

Parameter

–

Anwendungsfälle

–

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis
Name des Scriptergebnisses Wertoptionen Beispiel
is_connected Wahr/falsch is_connected:False
JSON-Ergebnis
N/A

Tickets suchen

Nach Tickets mit einem bestimmten Keyword suchen

Parameter

Parameter Typ Standardwert Beschreibung
Suchanfrage String – Inhalte abfragen (z. B. type:ticket status:pending).

Anwendungsfälle

–

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis
Name des Scriptergebnisses Wertoptionen Beispiel
results_count – –
JSON-Ergebnis
N/A

Ticket aktualisieren

Vorhandene Ticketdetails aktualisieren

Parameter

Parameter Typ Standardwert Beschreibung
Ticket-ID String – Ticketnummer
Betreff String – Der Betreff des Tickets.
Zugewiesener Nutzer String – Vollständiger Name des Nutzers.
Zuweisungsgruppe String – Gruppenname.
Priorität String – Die Priorität ist eine der folgenden: „Dringend“, „Hoch“, „Normal“ oder „Niedrig“.
Tickettyp String – Der Tickettyp ist einer der folgenden: Problem, Vorfall, Frage oder Aufgabe.
Tag String – Das Tag, das dem Ticket hinzugefügt werden soll.
Status String – Der Status ist einer der folgenden: „Neu“, „Offen“, „Ausstehend“, „Zurückgestellt“, „Gelöst“ oder „Geschlossen“.
Zusätzlicher Kommentar String – Wenn Sie dem Ticket einen Kommentar hinzufügen möchten, geben Sie den gewünschten Text hier ein.
Interner Hinweis Kästchen Nicht aktiviert Geben Sie an, ob der Kommentar öffentlich oder intern sein soll. Wenn das Kästchen nicht angekreuzt ist, ist die Funktion öffentlich. Wenn es angekreuzt ist, ist sie nur intern verfügbar.

Anwendungsfälle

–

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis
Name des Scriptergebnisses Wertoptionen Beispiel
is_updated Wahr/falsch is_updated:False
JSON-Ergebnis
N/A

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten