Zendesk in Google SecOps einbinden

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

Anwendungsfälle

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

  • Automatisierte Ticketerstellung für Vorfälle: Erstellen Sie automatisch Zendesk-Tickets aus Sicherheitswarnungen, damit jeder Vorfall verfolgt und dem richtigen Team zugewiesen wird.

  • Kommunikation zwischen Analysten optimieren: Sie können Kommentare und interne Notizen direkt aus Playbooks zu Tickets hinzufügen, um Stakeholder auf dem Laufenden zu halten, ohne die Plattform verlassen zu müssen.

  • Reaktionsworkflows standardisieren: Wenden Sie Zendesk-Makros auf Tickets an, um sich wiederholende Aktionen zu automatisieren und eine einheitliche Bearbeitung gängiger Sicherheitsprobleme zu gewährleisten.

  • Ticketlösung verfolgen: Rufen Sie regelmäßig Ticketdetails und Statusaktualisierungen ab, um den Lebenszyklus des Vorfalls auf beiden Plattformen zu synchronisieren.

  • Verlaufskontext durchsuchen: Fragen Sie vorhandene Tickets nach Stichwort ab, um ähnliche Vorfälle in der Vergangenheit 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 ausführliche Anleitung finden Sie unter Managing API token access to the Zendesk API.

  • 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 ist.

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

Integrationsparameter

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

Parameter Beschreibung
Server Address

Pflichtangabe.

Die URL Ihrer Zendesk-Instanz.

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

Pflichtangabe.

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

Pflichtangabe.

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

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

Sie können später bei Bedarf Ä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 Auf ausstehende Aktionen im Workdesk reagieren und Manuelle Aktion in einem Fall ausführen.

Kommentar zu Ticket hinzufügen

Fügen Sie einem vorhandenen Ticket einen Kommentar hinzu.

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 Entitäten ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

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

Makros auf Ticket anwenden

Makro auf ein Ticket anwenden

Parameter

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

Anwendungsfälle

–

Ausführen am

Diese Aktion wird für alle Entitäten ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

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

Ticket erstellen

Ticket mit bestimmten Attributen erstellen

Bekannte Einschränkungen

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

Parameter

Parameter Typ Standardwert Beschreibung
Betreff String – –
Beschreibung String – –
Zugewiesener Nutzer String – Vollständiger Name des Nutzers.
Zugewiesene Gruppe 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 ausgewählt Geben Sie an, ob der Kommentar öffentlich oder intern sein soll. Wenn das Häkchen nicht gesetzt ist, ist die App öffentlich. Wenn das Häkchen gesetzt ist, ist sie nur intern verfügbar.
E‑Mail-Adressen (Cc) CSV – Geben Sie eine durch Kommas getrennte Liste von E‑Mail-Adressen an, die ebenfalls über die Erstellung des Tickets benachrichtigt werden sollen. Hinweis: Es können maximal 48 E-Mail-Adressen im CC hinzugefügt werden. Dies ist eine Einschränkung von Zendesk.
E‑Mail-CCs validieren Boolesch Aktiviert Wenn diese Option aktiviert ist, wird versucht, zu prüfen, ob Nutzer mit den im Parameter „E‑Mail-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 Entitäten ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

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

Wenn „E‑Mail-CCs validieren“ aktiviert ist und mindestens eine E‑Mail-Adresse nicht gefunden wurde (Fehler): Fehler beim Ausführen der Aktion „{Aktionsname}“. Grund: Nutzer mit den folgenden E‑Mail-Adressen wurden nicht gefunden: {entity.identifier}. Prüfen Sie die Schreibweise oder deaktivieren Sie den Parameter „Validate Email CCs“ (CC-E-Mail-Adressen 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}. Prüfen Sie die Schreibweise oder deaktivieren Sie den Parameter „Validate Email CCs“ (CC-E-Mail-Adressen validieren).

 Allgemein

Ticketdetails abrufen

Ticketdetails, Kommentare und Anhänge anhand der Ticket-ID abrufen.

Parameter

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

Anwendungsfälle

–

Ausführen am

Diese Aktion wird für alle Entitäten ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis
Name des Skriptergebnisses 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 Entitäten ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis
Name des Skriptergebnisses 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 – Inhalt der Anfrage (Beispiel: type:ticket status:pending).

Anwendungsfälle

–

Ausführen am

Diese Aktion wird für alle Entitäten ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

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

Ticket aktualisieren

Details eines vorhandenen Tickets aktualisieren

Parameter

Parameter Typ Standardwert Beschreibung
Ticket-ID String – Ticketnummer.
Betreff String – Der Betreff des Tickets.
Zugewiesener Nutzer String – Vollständiger Name des Nutzers.
Zugewiesene Gruppe 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 – Tag, das dem Ticket hinzugefügt werden soll.
Status String – Der Status ist einer der folgenden: „Neu“, „Offen“, „Ausstehend“, „Angehalten“, „Gelöst“ oder „Geschlossen“.
Zusätzlicher Kommentar String – Wenn Sie dem Ticket einen Kommentar hinzufügen möchten, geben Sie hier den gewünschten Text ein.
Interner Hinweis Kästchen Nicht ausgewählt Geben Sie an, ob der Kommentar öffentlich oder intern sein soll. Wenn das Häkchen nicht gesetzt ist, ist die App öffentlich. Wenn das Häkchen gesetzt ist, ist sie nur intern verfügbar.

Anwendungsfälle

–

Ausführen am

Diese Aktion wird für alle Entitäten ausgeführt.

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis
Name des Skriptergebnisses 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