ServiceNow in Google SecOps einbinden

In diesem Dokument wird beschrieben, wie Sie ServiceNow in Google Security Operations (Google SecOps) einbinden.

Anwendungsfälle

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

  • Automatisierte Ticketerstellung für Vorfälle: ServiceNow-Vorfälle werden automatisch aus Sicherheitswarnungen erstellt, die von Ihrem SIEM oder anderen Sicherheitstools stammen.

  • Incident Response und Anreicherung: Optimieren Sie die Workflows für die Incident Response, indem Sie die manuelle Ticketerstellung reduzieren und Vorfälle mit relevanten Informationen aus der ursprünglichen Benachrichtigung anreichern.

  • Phishing-Abwehr: Automatisieren Sie wiederkehrende Schritte bei der Untersuchung von Phishing-Angriffen, z. B. das Erfassen von E‑Mail-Headern, das Untersuchen von Anhängen und das Suchen nach ähnlichen E‑Mails, um die Reaktionszeiten zu verkürzen.

  • Orchestrierung der Behebung von Sicherheitslücken: Orchestrieren Sie Workflows zur Behebung von Sicherheitslücken, indem Sie automatisch ServiceNow-Änderungsanfragen für Patch- oder Abhilfemaßnahmen basierend auf den Ergebnissen von Scans auf Sicherheitslücken erstellen.

  • Automatisierung des Nutzerlebenszyklus: Automatisieren Sie die Bereitstellung und Aufhebung der Bereitstellung von Nutzern in verschiedenen Systemen (Zugriffssteuerung, E-Mail-Plattformen, Anwendungen) basierend auf Triggern aus ServiceNow-Workflows.

  • Threat Intelligence-Kontext: Sicherheitswarnungen werden mit Threat Intelligence-Daten angereichert, die direkt von der ServiceNow-Plattform stammen. So erhalten Analysten mehr Kontext, um Reaktionsmaßnahmen zu priorisieren.

Hinweis

Bevor Sie die Integration in der Google SecOps-Plattform konfigurieren, müssen Sie die folgenden Voraussetzungen erfüllen:

  • ServiceNow-Nutzerkonto: Ein dediziertes Nutzerkonto mit ausreichenden Berechtigungen zum Abfragen, Erstellen und Aktualisieren von Zieldatensätzen.
  • ServiceNow-Rollen: Das Konto muss die erforderlichen Systemrollen (sn_incident_write und itil) und eine benutzerdefinierte Nutzerzugriffskonfiguration haben, um Zugriff auf das Lesen von Journal-Kommentaren zu ermöglichen.
  • Netzwerkverbindung: Eine Netzwerkkonfiguration, die es ermöglicht, dass Traffic von Google SecOps-IP-Adressen oder Ihrer Remote-Agent-Infrastruktur den Endpunkt Ihrer ServiceNow-Instanz erreicht.
  • Authentifizierungsdetails: Legen Sie die Authentifizierungsrichtlinie Ihrer Organisation fest. Sie können sich mit der standardmäßigen Basisauthentifizierung oder der OAuth 2.0-Authentifizierung authentifizieren.

Nutzerzugriff in ServiceNow konfigurieren

Damit die Integration Kommentare synchronisieren, Felder aktualisieren und Aktionen nahtlos ausführen kann, müssen Sie die folgenden administrativen Aufgaben auf der ServiceNow-Plattform ausführen.

Eine genaue Anleitung zur Navigation auf der ServiceNow-Oberfläche finden Sie in der offiziellen ServiceNow-Produktdokumentation.

  1. Benutzerdefinierte Rolle erstellen: Gehen Sie zu Rollen > Neu und erstellen Sie eine neue Rolle für die Verwaltung des API-Kommentarzustands.
  2. Neue ACL-Regel (Access Control List) erstellen: Die Integration erfordert Lesezugriff auf die Tabelle sys_journal_field, um Kommentare und Arbeitsnotizen zu verfolgen. Rufen Sie Zugriffssteuerung > Neu auf. Sie müssen sich mit einem Konto mit erweiterten Berechtigungen anmelden, um diese Regel zu erstellen.

  3. Konfigurieren Sie die ACL-Parameter:

    • Legen Sie für Typ record fest.
    • Legen Sie für Vorgang den Wert read fest.
    • Wählen Sie in den Feldern Name im ersten Drop-down-Menü Journal Entry sys_journal_field und im zweiten Drop-down-Menü -- Keine -- aus.
    • Gehen Sie unten im Formular zur Liste Erfordert Rolle und fügen Sie die neu erstellte benutzerdefinierte Kommentarrolle hinzu. Klicken Sie auf Senden.

  4. Dem Integrationskonto Rollen zuweisen: Gehen Sie zu Nutzer, öffnen Sie Ihr dediziertes Integrationskonto und weisen Sie die folgenden Rollen zu:

    • Die benutzerdefinierte Rolle, die Sie zum Lesen von Kommentaren erstellt haben.
    • sn_incident_write: Erforderlich für grundlegende Interaktionen, z. B. die Aktionen Vorfall abrufen und Vorfall aktualisieren.
    • itil: Erforderlich für CMDB-Aktionen und zugehörige Suchfunktionen für die Konfigurationsverwaltung von Assets.

Konfigurationsoptionen für die Authentifizierung

Die ServiceNow-Integration unterstützt drei verschiedene Authentifizierungsmethoden. Wählen Sie eine der folgenden Konfigurationsoptionen aus, die den Sicherheitsanforderungen Ihrer Organisation entspricht.

Option 1: OAuth 2.0-Vorgang für Clientanmeldedaten (empfohlen)

Bei dieser Methode wird eine OAuth 2.0-Clientanmeldedaten-Gewährung zusammen mit dem Wechsel der Nutzeridentität verwendet, um den Datenzugriff sicher einzuschränken, ohne dass ein statisches Nutzerpasswort für die Plattform offengelegt wird.

Phase 1: OAuth-Endpunkt in ServiceNow erstellen

  1. Suchen Sie im ServiceNow-Navigationsmenü nach Application Registries und klicken Sie auf New.
  2. Wählen Sie New Inbound Integration Experience (Neue eingehende Integration) aus.
  3. Wählen Sie in der Liste der Verbindungstypen OAuth – Client-Anmeldedaten aus.
  4. Geben Sie im Feld Name einen aussagekräftigen Namen für die Endpunktkonfiguration ein.
  5. Geben Sie den Namen oder die Kennung des OAuth-Anbieters an, der zum Erstellen des Identitätsprofilkontexts erforderlich ist.
  6. Wählen Sie im Feld OAuth-Anwendungsnutzer das dedizierte ServiceNow-Nutzerkonto aus, das für alle automatisierten API-Aktivitäten verwendet werden soll.
  7. Klicken Sie auf Senden oder Speichern.
  8. Öffnen Sie den neu erstellten Registrierungseintrag, um die generierte Client-ID und den Clientschlüssel zu kopieren und zu sichern.

Phase 2: In Google SecOps konfigurieren

  1. Gehen Sie in Google SecOps zu Antwort > Integrationen einrichten und öffnen Sie das ServiceNow-Konfigurationsfenster.
  2. Geben Sie Ihren API-Stamm ein. Ersetzen Sie dabei die Standardplatzhalterdomain durch die tatsächliche URL Ihrer ServiceNow-Instanz.
  3. Geben Sie die Client-ID und den Clientschlüssel an, die in Phase 1 generiert wurden.
  4. Achten Sie darauf, dass die Felder Username, Password und Refresh Token leer sind.
  5. Aktivieren Sie das Kästchen Use Oauth Authentication (OAuth-Authentifizierung verwenden).
  6. Klicken Sie auf Testen, um die Parameter mit einem Konnektivitäts-Ping-Test zu prüfen. Wenn der Test erfolgreich war, klicken Sie auf Speichern.

Option 2: Basisauthentifizierung

Bei dieser Methode wird eine direkte Validierung der Anmeldedaten verwendet. Die Einrichtung ist unkompliziert, kann aber eingeschränkt sein, wenn Ihr Unternehmen die Multi-Faktor-Authentifizierung (MFA) erzwingt oder Header für die einfache Authentifizierung blockiert.

  1. Prüfen Sie in ServiceNow, ob Ihr Integrationsnutzer einen lokalen Nutzernamen und ein lokales Passwort hat.
  2. Geben Sie beim Konfigurieren der Integration in Google SecOps die API-Stamm-URL (ersetzen Sie die Standardplatzhalterdomain durch die tatsächliche URL Ihrer ServiceNow-Instanz), den Nutzernamen und das Passwort an.
  3. Lassen Sie die OAuth-bezogenen Felder leer und achten Sie darauf, dass Use Oauth Authentication deaktiviert ist (Kästchen nicht angeklickt).
  4. Klicken Sie auf Test, um die Verbindungsparameter zu prüfen. Wenn der Vorgang erfolgreich war, klicken Sie auf Speichern.

Option 3: Aktualisierungstoken-Ablauf

Verwenden Sie diese Methode, wenn Ihre Organisation OAuth-Sicherheitskontrollen mit einer Aktualisierungstokenkette benötigt, um Zugriffstokens im Hintergrund programmatisch abzurufen.

  1. Führen Sie Phase 1 in Ihrer ServiceNow-Instanz aus, um eine Client-ID und einen Clientschlüssel zu generieren.
  2. Führen Sie die Schritte im Abschnitt Aktualisierungstoken generieren aus, um einen gültigen Autorisierungstoken-String abzurufen.
  3. Öffnen Sie in Google SecOps das Konfigurationsfenster für Ihre ServiceNow-Integrationsinstanz.
  4. Geben Sie die Parameter vollständig mit Ihren konfigurierten Anmeldedaten ein:
    • Api Root (ersetzen Sie die Standard-Platzhalterdomain durch die tatsächliche URL Ihrer ServiceNow-Instanz).
    • Nutzername
    • Passwort
    • Client-ID
    • Clientschlüssel
  5. Markieren Sie das Kästchen Use Oauth Authentication (OAuth-Authentifizierung verwenden).
  6. Fügen Sie den Tokenstring, den Sie im Workflow des Abschnitts Aktualisierungstoken generieren abgerufen haben, in das Feld Aktualisierungstoken ein.
  7. Klicken Sie auf Testen, um die Verbindungsparameter zu prüfen. Wenn der Vorgang erfolgreich war, klicken Sie auf Speichern.

Aktualisierungstoken generieren (Google SecOps)

Zum Generieren des Aktualisierungstokens müssen Sie die Integration vorübergehend so konfigurieren, dass eine Hilfsaktion ausgeführt wird.

  1. Gehen Sie in Google SecOps zu Antwort > Integrationen einrichten.
  2. Achten Sie darauf, dass das Kästchen OAuth-Authentifizierung verwenden für diesen ersten Einrichtungsschritt nicht angeklickt ist.
  3. Konfigurieren Sie eine temporäre ServiceNow-Integrationsinstanz mit dem API-Stamm, dem Nutzernamen, dem Passwort, der Client-ID und dem Clientschlüssel und klicken Sie auf Speichern.
  4. Simulieren Sie einen Fall oder öffnen Sie einen vorhandenen Fall.
  5. Führen Sie die ServiceNow-Aktion Get Oauth Token manuell für die Anfrage aus.
  6. Kopieren Sie den Wert refresh_token aus dem JSON-Ergebnis der Aktion, um ihn im Feld Aktualisierungstoken zu verwenden, wenn Sie die endgültige Integrationsinstanz konfigurieren.

Integrationsparameter

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

Parameter Beschreibung
Api Root

Pflichtangabe.

Der API-Stamm der ServiceNow-Instanz.

Der Standardwert ist https://INSTANCE.service-now.com/api/now/v1/.
Username

Pflichtangabe.

Der Nutzername des ServiceNow-Kontos.
Password

Pflichtangabe.

Das Passwort des ServiceNow-Kontos.
Incident Table

Optional.

Der API-Tabellenname oder -Pfad, der für vorfallbezogene Aktionen und das Abrufen von Einträgen verwendet werden soll.

Standardmäßig verwendet die Integration den Pfad table/incident.
Verify SSL

Optional.

Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum ServiceNow-Server hergestellt wird.

Standardmäßig aktiviert.
Client ID

Optional.

Die Client-ID für die ServiceNow-Integration, die für die OAuth 2.0-Authentifizierung mit Clientanmeldedaten erforderlich ist.

Sie können sich entweder mit dem Aktualisierungstoken oder mit den Clientanmeldedaten authentifizieren. Wenn sowohl das Aktualisierungstoken als auch die Clientanmeldedaten konfiguriert sind, verwendet die Integration das Aktualisierungstoken für die Authentifizierung.
Client Secret

Optional.

Der Clientschlüssel für die ServiceNow-Integration, der für die OAuth 2.0-Authentifizierung mit Clientanmeldedaten erforderlich ist.

Sie können sich entweder mit dem Aktualisierungstoken oder mit den Clientanmeldedaten authentifizieren. Wenn sowohl das Aktualisierungstoken als auch die Clientanmeldedaten konfiguriert sind, verwendet die Integration das Aktualisierungstoken für die Authentifizierung.
Refresh Token

Optional.

Das Aktualisierungstoken für die ServiceNow-Integration, das für die OAuth 2.0-Authentifizierung mit einem Aktualisierungstoken erforderlich ist.

Dieses konfigurierte Aktualisierungstoken läuft alle 90 Tage ab.

Sie können sich entweder mit dem Aktualisierungstoken oder mit den Clientanmeldedaten authentifizieren. Wenn sowohl das Aktualisierungstoken als auch die Clientanmeldedaten konfiguriert sind, wird das Aktualisierungstoken für die Authentifizierung verwendet.
Use Oauth Authentication

Optional.

Wenn diese Option ausgewählt ist, wird für die Authentifizierung der Integration OAuth 2.0 verwendet.

Für die OAuth 2.0-Authentifizierung müssen entweder die Clientanmeldedaten (Client ID und Client Secret) oder Refresh Token festgelegt werden.

Standardmäßig deaktiviert.

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.

Anhang hinzufügen

Verwenden Sie die Aktion Anhang hinzufügen, um einem Tabelleneintrag in ServiceNow Anhänge hinzuzufügen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Anhang hinzufügen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Table Name

Pflichtangabe.

Der Name der Tabelle, die den Eintrag enthält, dem der Anhang hinzugefügt wird.
Record Sys ID

Pflichtangabe.

Die System-ID (sys_id) des Datensatzes, dem der Anhang hinzugefügt wird.
File Path

Pflichtangabe.

Eine durch Kommas getrennte Liste mit absoluten Pfaden für die anzuhängenden Dateien.
Mode

Optional.

Das Verhalten der Aktion, wenn bereits eine Datei mit demselben Namen im Datensatz vorhanden ist.

Folgende Werte sind möglich:

  • Add New Attachment: Die Datei wird als neuer, separater Anhang hinzugefügt. Dateien mit demselben Namen sind zulässig.
  • Overwrite Existing Attachment: Die Aktion ersetzt den vorhandenen Anhang mit demselben Namen.

Der Standardwert ist Add New Attachment.

Aktionsausgaben

Die Aktion Anhang hinzufügen liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Anhang hinzufügen empfangen wird:

{
    "result": {
        "size_bytes": "742",
        "file_name": "placeholder_document.txt",
        "sys_mod_count": "0",
        "average_image_color": "",
        "image_width": "",
        "sys_updated_on": "2025-01-01 10:00:00",
        "sys_tags": "",
        "table_name": "incident",
        "sys_id": "TEST_SYS_ID_ATTACH_123456789",
        "image_height": "",
        "sys_updated_by": "admin",
        "download_link": "https://placeholder.service-now.com/api/now/attachment/TEST_SYS_ID_ATTACH_123456789/file",
        "content_type": "multipart/form-data",
        "sys_created_on": "2025-01-01 10:00:00",
        "size_compressed": "438",
        "compressed": "true",
        "state": "pending",
        "table_sys_id": "TEST_SYS_ID_RECORD_ABCDEFG",
        "chunk_size_bytes": "700000",
        "hash": "test_hash_0000000000000000000000000000000000000000000000000000000000000000",
        "sys_created_by": "admin"
    }
}
Ausgabenachrichten

Die Aktion Anhang hinzufügen kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

Successfully added the following attachments to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS

Action wasn't able to add the following attachments to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS

No attachments were added to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS

 Die Aktion war erfolgreich.
Error executing action "Add Attachment". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle sind die Werte für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Anhang hinzufügen verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

Kommentar hinzufügen

Verwenden Sie die Aktion Kommentar hinzufügen, um einem ServiceNow-Vorfall einen Kommentar hinzuzufügen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Kommentar hinzufügen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Incident Number

Pflichtangabe.

Die Nummer des Vorfalls, dem der Kommentar hinzugefügt werden soll, im Format INCINCIDENT_NUMBER.
Comment

Pflichtangabe.

Der Kommentar, der dem Vorfall hinzugefügt werden soll.

Aktionsausgaben

Die Aktion Kommentar hinzufügen liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Nicht verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Scriptergebnis

In der folgenden Tabelle sind die Werte für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Kommentar hinzufügen verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

Kommentar hinzufügen und auf Antwort warten

Mit der Aktion Kommentar hinzufügen und auf Antwort warten können Sie einem ServiceNow-Vorfall einen Kommentar hinzufügen und die Playbook-Ausführung dann pausieren, bis ein neuer Kommentar oder eine Antwort zu diesem Vorfall hinzugefügt wird. Die Ausgabe der Aktion ist der Inhalt des neuen Kommentars.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Kommentar hinzufügen und auf Antwort warten sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Incident Number

Pflichtangabe.

Die Nummer des Vorfalls, dem der Kommentar hinzugefügt werden soll, im Format INCINCIDENT_NUMBER.
Comment

Pflichtangabe.

Der Kommentar, der dem Vorfall hinzugefügt werden soll.

Aktionsausgaben

Die Aktion Kommentar hinzufügen und auf Antwort warten liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Nicht verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Scriptergebnis

In der folgenden Tabelle sind die Werte für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Kommentar hinzufügen und auf Antwort warten verwendet wird:

Name des Skriptergebnisses Wert
new_comment

Kommentar zu Datensatz hinzufügen

Mit der Aktion Kommentar zu Datensatz hinzufügen können Sie einem bestimmten Tabellendatensatz in ServiceNow einen Kommentar oder eine Arbeitsnotiz hinzufügen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Kommentar zu Datensatz hinzufügen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Table Name

Pflichtangabe.

Der Name der Tabelle, der der Kommentar oder die Notiz hinzugefügt werden soll.
Type

Pflichtangabe.

Die Art des Kommentars oder der Notiz, die hinzugefügt werden soll.

Folgende Werte sind möglich:

  • Comment
  • Work Note

Der Standardwert ist Comment.
Record Sys ID

Pflichtangabe.

Die System-ID (sys_id), der der Kommentar oder die Arbeitsnotiz hinzugefügt werden soll.
Text

Pflichtangabe.

Der Inhalt des Kommentars oder der Arbeitsnotiz.
Wait For Reply

Optional.

Wenn diese Option ausgewählt ist, wird die Aktion asynchron ausgeführt und die Ausführung wird angehalten, bis dem Eintrag ein neuer Kommentar oder eine neue Arbeitsnotiz hinzugefügt wird.

Die Aktion verfolgt Kommentare, wenn Sie einen Kommentar hinzufügen, und Arbeitsnotizen, wenn Sie eine Arbeitsnotiz hinzufügen.

Standardmäßig deaktiviert.

Aktionsausgaben

Die Aktion Kommentar zu Datensatz hinzufügen liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Kommentar zu Datensatz hinzufügen empfangen wird:

{
    "sys_id": "4355183607523010ff23f6fd7c1ed0a8",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "Test comment content.",
    "sys_created_by": "admin",
    "element": "comments"
}
Ausgabenachrichten

Die Aktion Kommentar zu Datensatz hinzufügen kann die folgenden Ausgabemeldungen zurückgeben:

Ausgabemeldung Beschreibung der Nachricht
Successfully added COMMENT_OR_NOTE " CONTENT" to TABLE_NAME with Sys_ID SYS_ID in ServiceNow. Die Aktion war erfolgreich.
Error executing action "Add Comment To Record". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Kommentar zu Datensatz hinzufügen verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

Übergeordneten Vorfall hinzufügen

Verwenden Sie die Aktion Übergeordneten Vorfall hinzufügen, um Vorfällen in ServiceNow einen übergeordneten Vorfall hinzuzufügen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Übergeordneten Vorfall hinzufügen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Parent Incident Number

Pflichtangabe.

Die Nummer des übergeordneten Vorfalls im Format INCINCIDENT_NUMBER (z. B. INC0000051).

Durch die Aktion werden alle Vorfälle in Child Incident Numbers als untergeordnete Elemente für den übergeordneten Vorfall hinzugefügt.
Child Incident Numbers

Pflichtangabe.

Eine durch Kommas getrennte Liste von Vorfallnummern, die als untergeordnete Vorfälle für den angegebenen übergeordneten Vorfall festgelegt werden sollen, im Format INCINCIDENT_NUMBER (z. B. INC0000051).

Aktionsausgaben

Die Aktion Übergeordneten Vorfall hinzufügen liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die Sie erhalten, wenn Sie die Aktion Übergeordneten Vorfall hinzufügen verwenden:

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "2a100a1c2fc42010c518532a2799b621",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
Ausgabenachrichten

Die Aktion Übergeordneten Vorfall hinzufügen kann die folgenden Ausgabemeldungen zurückgeben:

Ausgabemeldung Beschreibung der Nachricht
Successfully set PARENT_INCIDENT_NUMBER as the "Parent Incident" for the following incidents in ServiceNow: CHILD_INCIDENT_NUMBERS. Die Aktion war erfolgreich.
Error executing action "Add Parent Incident". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Vorfall schließen

Mit der Aktion Vorfall schließen können Sie einen ServiceNow-Vorfall schließen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Vorfall schließen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Incident Number

Pflichtangabe.

Die Nummer des zu schließenden Vorfalls im Format INCINCIDENT_NUMBER.
Close Reason

Pflichtangabe.

Der Grund für das Schließen des Vorfalls.
Resolution Code

Pflichtangabe.

Der Lösungscode für den Vorfall.

Folgende Werte sind möglich:

  • Duplicate
  • Known error
  • No resolution provided
  • Resolved by caller
  • Resolved by change
  • Resolved by problem
  • Resolved by request
  • Solution provided
  • Workaround provided
  • User error

Der Standardwert ist Solution provided.
Close Notes

Pflichtangabe.

Die Notizen zur Schließung des Vorfalls.

Aktionsausgaben

Die Aktion Vorfall schließen liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Nicht verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Vorfall schließen verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

Benachrichtigungsvorfall erstellen

Verwenden Sie die Aktion Benachrichtigungsvorfall erstellen, um einen neuen Vorfall in ServiceNow zu erstellen. Die Details der Benachrichtigung, die die Playbook-Ausführung initiiert, werden dabei berücksichtigt.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Vorfall erstellen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Impact

Pflichtangabe.

Die Auswirkungsebene des Vorfalls.

Folgende Werte sind möglich:

  • 1 für „Hoch“
  • 2 für Medium
  • 3 für „Niedrig“

Der Standardwert ist 1.
Urgency

Pflichtangabe.

Die Dringlichkeitsstufe des Vorfalls.

Folgende Werte sind möglich:

  • 1 für „Hoch“
  • 2 für Medium
  • 3 für „Niedrig“

Der Standardwert ist 1.
Category

Optional.

Die Kategorie des Vorfalls.
Assignment Group ID

Optional.

Der vollständige Name der Gruppe, der der Vorfall zugewiesen werden soll.
Assigned User ID

Optional.

Der vollständige Name des Nutzers, dem der Vorfall zugewiesen werden soll.
Description

Optional.

Die Beschreibung des Vorfalls.

Aktionsausgaben

Die Aktion Vorfall erstellen liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die Sie bei Verwendung der Aktion Benachrichtigungsvorfall erstellen erhalten:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010005",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by":
    "admin", "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "1",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 05:13:25",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "4187b92c-7aaa-40ec-a032-833dd5a854e6",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 05:13:25",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 07:13:25",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 05:13:25",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Benachrichtigungsvorfall erstellen verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

Vorfall erstellen

Verwenden Sie die Aktion Vorfall erstellen, um einen neuen Vorfall in ServiceNow zu erstellen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Vorfall erstellen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Short Description

Pflichtangabe.

Die Kurzbeschreibung des Vorfalls.
Impact

Pflichtangabe.

Die Auswirkungsebene des Vorfalls.

Folgende Werte sind möglich:

  • 1 für „Hoch“
  • 2 für Medium
  • 3 für „Niedrig“

Der Standardwert ist 1.
Urgency

Pflichtangabe.

Die Dringlichkeitsstufe des Vorfalls.

Folgende Werte sind möglich:

  • 1 für „Hoch“
  • 2 für Medium
  • 3 für „Niedrig“

Der Standardwert ist 1.
Category

Optional.

Die Kategorie des Vorfalls.
Assignment Group ID

Optional.

Der vollständige Name der Gruppe, der der Vorfall zugewiesen werden soll.

Assigned User ID

Optional.

Der vollständige Name des Nutzers, dem der Vorfall zugewiesen werden soll.

Description

Optional.

Die Beschreibung des Vorfalls.
Custom Fields

Optional.

Ein JSON-formatierter String mit Feldnamen und den entsprechenden zu aktualisierenden Werten (z. B. {"location":"London", "category":"database"}).

Mit diesem Parameter können Sie Felder ändern, die nicht explizit als Aktionseingaben definiert sind.

Aktionsausgaben

Die Aktion Vorfall erstellen liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die Sie bei Verwendung der Aktion Vorfall erstellen erhalten:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010005",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by":
    "admin", "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "1",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 05:13:25",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "4187b92c-7aaa-40ec-a032-833dd5a854e6",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 05:13:25",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 07:13:25",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 05:13:25",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Vorfall erstellen verwendet wird:

Name des Skriptergebnisses Wert
incident_number INCIDENT_NUMBER

Create Record

Verwenden Sie die Aktion Eintrag erstellen, um neue Einträge in verschiedenen ServiceNow-Tabellen zu erstellen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Datensatz erstellen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Table Name

Optional.

Der Name der ServiceNow-Tabelle, in der der neue Datensatz erstellt wird (z. B. incident).
Object Json Data

Optional.

Das JSON-Objekt, das die Feld-Wert-Paare enthält, die zum Definieren des neuen Datensatzes erforderlich sind (z. B. Vorfallfelder oder CMDB-Elementattribute).

Aktionsausgaben

Die Aktion Eintrag erstellen liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die Sie bei Verwendung der Aktion Eintrag erstellen erhalten:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010021",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "3",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "5",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 08:24:34",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": " ",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 08:24:34",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": " ",
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": " ",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 08:24:34",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "3",
    "reopen_count": "0"
}
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Eintrag erstellen verwendet wird:

Name des Skriptergebnisses Wert
object_sys_id OBJECT_SYS_ID

Anhänge herunterladen

Mit der Aktion Anhänge herunterladen können Sie Dateien und Dokumente, die an einen bestimmten ServiceNow-Eintrag angehängt sind, in einen lokalen Ordner in Ihrer Google SecOps-Umgebung herunterladen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Anhänge herunterladen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Table Name

Pflichtangabe.

Der Name der ServiceNow-Tabelle, die den Eintrag enthält, von dem Anhänge heruntergeladen werden sollen (z. B. incident).
Record Sys ID

Pflichtangabe.

Die System-ID (sys_id) des Datensatzes, aus dem die Anhänge heruntergeladen werden.
Download Folder Path

Pflichtangabe.

Der absolute Pfad zum Ordner in der Google SecOps-Umgebung, in dem die heruntergeladenen Anhänge gespeichert werden.
Overewrite

Optional.

Wenn diese Option ausgewählt ist, werden Dateien mit demselben Namen überschrieben.

Standardmäßig deaktiviert.

Aktionsausgaben

Die Aktion Anhänge herunterladen liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Anhänge herunterladen empfangen wird:

{
    "result": [
        {"absolute_file_path" : ["PATH"]
            "size_bytes": "187",
            "file_name": "example.txt",
            "sys_mod_count": "1",
            "average_image_color": "",
            "image_width": "",
            "sys_updated_on": "2020-10-19 09:58:39",
            "sys_tags": "",
            "table_name": "problem",
            "sys_id": "SYS_ID",
            "image_height": "",
            "sys_updated_by": "system",
            "download_link": "https://example.service-now.com/api/now/attachment/ID/file",
            "content_type": "text/plain",
            "sys_created_on": "2020-10-19 09:58:38",
            "size_compressed": "172",
            "compressed": "true",
            "state": "available",
            "table_sys_id": "57771d002f002010c518532a2799b6cc",
            "chunk_size_bytes": "700000",
            "hash": "a4fbb8ab71268903845b59724835274ddc66e095de553c5e0c1da8fecd04ee45",
            "sys_created_by": "admin"
        }
    ]
}
Ausgabenachrichten

Die Aktion Anhänge herunterladen kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

Successfully downloaded the following attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME

Action wasn't able to download the following attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME

Action wasn't able to download attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME

 Die Aktion war erfolgreich.
Error executing action "Download Attachments". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Anhänge herunterladen verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

Details zu untergeordneten Vorfällen abrufen

Verwenden Sie die Aktion Details zu untergeordneten Vorfällen abrufen, um Informationen zu untergeordneten Vorfällen basierend auf dem übergeordneten Vorfall in ServiceNow abzurufen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Get Child Incident Details sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Parent Incident Number

Pflichtangabe.

Die Nummer des übergeordneten Vorfalls, von dem die Details des untergeordneten Vorfalls abgerufen werden sollen, im Format INCINCIDENT_NUMBER.
Max Child Incident To Return

Optional.

Die maximale Anzahl von untergeordneten Vorfällen, die die Aktion vom übergeordneten Vorfall zurückgibt.

Der Standardwert ist 50.

Aktionsausgaben

Die Aktion Details zu untergeordnetem Vorfall abrufen liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Tabelle mit Fall-Repository

Die Aktion Details zu untergeordneten Vorfällen abrufen stellt die folgende Tabelle bereit:

Tabellenname: Details zu untergeordneten Vorfällen

Tabellenspalten:

  • Sys ID (zugeordnet als sys_id)
  • Zahl (zugeordnet als number)
  • Kurzbeschreibung (zugeordnet als short_description)
  • Created At (zugeordnet als sys_created_on)
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Get Child Incident Details empfangen wird:

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  ATF Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "2a100a1c2fc42010c518532a2799b621",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
Ausgabenachrichten

Die Aktion Untergeordnete Vorfalldetails abrufen kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

Successfully retrieved information about child incidents related to the PARENT_INCIDENT_NUMBER incident in ServiceNow.

Action wasn't able to retrieve information about the child incidents in ServiceNow. Reason: incident PARENT_INCIDENT_NUMBER was not found.

No child incidents were found.

 Die Aktion war erfolgreich.
Error executing action "Get Child Incident Details". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Get Child Incident Details verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

CMDB-Eintragsdetails abrufen

Verwenden Sie die Aktion CMDB-Eintragsdetails abrufen, um detaillierte CMDB-Einträge aus derselben Klasse in ServiceNow abzurufen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion CMDB-Eintragsdetails abrufen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Class Name

Pflichtangabe.

Der Name der CMDB-Klasse, aus der Datensätze abgerufen werden sollen, z. B. cmdb_ci_appl.

Weitere Informationen zu Klassennamen finden Sie unter Klassendefinition und Metadaten ansehen und bearbeiten.
Sys ID

Pflichtangabe.

Eine durch Kommas getrennte Liste der System-IDs (sys_id) der CMDB-Einträge, für die Details abgerufen werden sollen.
Max Records To Return

Optional.

Die maximale Anzahl von Datensatzbeziehungen, die für jeden Beziehungstyp (z. B. relates to oder depends on) zurückgegeben werden sollen.

Der Standardwert ist 50.

Aktionsausgaben

Die Aktion CMDB-Eintragsdetails abrufen liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion CMDB-Eintragsdetails abrufen empfangen wird:

{
    "result": {
        "outbound_relations": [
            {
                "sys_id": "56f3a7ad7f701200bee45f19befa910f",
                "type": {
                    "display_value": "Members::Member of",
                    "link": "https://example.service-now.com/api/now/table/cmdb_rel_type/ID",
                    "value": "ID"
                },
                "target": {
                    "display_value": "Example",
                    "link": "https://example.service-now.com/api/now/cmdb/instance/cmdb_ci/ID",
                    "value": "ID"
                }
            }
        ],
        "attributes": {
            "attested_date": "",
            "skip_sync": "false",
            "operational_status": "1",
            "caption": "",
            "cluster_type": "",
            "sys_updated_on": "2016-01-06 19:04:07",
            "attestation_score": "",
            "discovery_source": "",
            "first_discovered": "",
            "sys_updated_by": "example.user",
            "cluster_status": "",
            "due_in": "",
            "sys_created_on": "2016-01-06 16:47:15",
            "sys_domain": {
                "display_value": "global",
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "install_date": "",
            "invoice_number": "",
            "gl_account": "",
            "sys_created_by": "example.user",
            "warranty_expiration": "",
            "cluster_version": "",
            "asset_tag": "",
            "fqdn": "",
            "change_control": "",
            "owned_by": "",
            "checked_out": "",
            "sys_domain_path": "/",
            "delivery_date": "",
            "maintenance_schedule": "",
            "install_status": "1",
            "cost_center": "",
            "attested_by": "",
            "supported_by": "",
            "dns_domain": "",
            "name": "SAP-LB-Win-Cluster",
            "assigned": "",
            "purchase_date": "",
            "subcategory": "Cluster",
            "short_description": "",
            "assignment_group": "",
            "managed_by": "",
            "managed_by_group": "",
            "last_discovered": "",
            "can_print": "false",
            "sys_class_name": "cmdb_ci_win_cluster",
            "manufacturer": "",
            "sys_id": "SYS_ID",
            "cluster_id": "",
            "po_number": "",
            "checked_in": "",
            "sys_class_path": "/!!/!5/!$",
            "vendor": "",
            "mac_address": "",
            "company": "",
            "model_number": "",
            "justification": "",
            "department": "",
            "assigned_to": "",
            "start_date": "",
            "cost": "",
            "comments": "",
            "sys_mod_count": "1",
            "serial_number": "",
            "monitor": "false",
            "model_id": "",
            "ip_address": "",
            "duplicate_of": "",
            "sys_tags": "",
            "cost_cc": "USD",
            "support_group": "",
            "order_date": "",
            "schedule": "",
            "environment": "",
            "due": "",
            "attested": "false",
            "unverified": "false",
            "correlation_id": "",
            "attributes": "",
            "location": "",
            "asset": "",
            "category": "Resource",
            "fault_count": "0",
            "lease_id": ""
        },
        "inbound_relations": [
            {
                "sys_id": "3b3d95297f701200bee45f19befa910c",
                "type": {
                    "display_value": "Depends on::Used by",
                    "link": "https://example.service-now.com/api/now/table/cmdb_rel_type/ID",
                    "value": "ID"
                },
                "target": {
                    "display_value": "IP-Router-3",
                    "link": "https://example.service-now.com/api/now/cmdb/instance/cmdb_ci/ID",
                    "value": "ID"
                }
            }
        ]
    }
}
Ausgabenachrichten

Die Aktion CMDB-Eintragsdetails abrufen kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

Successfully returned details for CMDB records in the Class CLASS_NAME from ServiceNow for the following Sys IDs: SYS_ID_LIST.

Action wasn't able to return details for CMDB records in the Class CLASS_NAME from ServiceNow for the following Sys IDs: SYS_ID_LIST

Action wasn't able to return details for CMDB records in the Class CLASS_NAME in ServiceNow. Reason: Class CLASS_NAME was not found.

Action wasn't able to return details for CMDB record with Sys ID SYS_ID in the Class CLASS_NAME in Service Now. Reason: Record with Sys ID SYS_ID was not found in Class CLASS_NAME.

Information about the provided Sys IDs was not found.

 Die Aktion war erfolgreich.
Error executing action "Get CMDB Record Details". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Get CMDB Record Details verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

Vorfall abrufen

Verwenden Sie die Aktion Vorfall abrufen, um Informationen zu einem ServiceNow-Vorfall abzurufen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Vorfall abrufen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Incident Number

Pflichtangabe.

Die eindeutige Kennung des abzurufenden ServiceNow-Vorfalls im Format INCINCIDENT_NUMBER.

Aktionsausgaben

Die Aktion Vorfall abrufen liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die Sie bei Verwendung der Aktion Vorfall abrufen erhalten:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": "2012",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010041",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "10",
    "notify": "1",
    "resolved_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": "2020-07-10 12:53:06",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "priority": "1",
    "state": "7",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 12:18:04",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "sdf",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": "0",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": "Closed by Caller",
    "business_duration": "1970-01-01 00:00:00",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 13:13:57",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": "1970-01-01 00:35:02",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "false",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 14:33:28",
    "severity": "3",
    "incident_state": "7",
    "resolved_at": "2020-07-10 12:53:06",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 12:18:04",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": "Closed/Resolved by Caller",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Vorfall abrufen verwendet wird:

Name des Skriptergebnisses Wert
incident_number INCIDENT_NUMBER

OAuth-Token abrufen

Verwenden Sie die Aktion OAuth-Token abrufen, um ein OAuth-Aktualisierungstoken für ServiceNow abzurufen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Keine.

Aktionsausgaben

Die Aktion OAuth-Token abrufen liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion OAuth-Token abrufen empfangen wird:

{
    "access_token": "Na4Kb1oWpFcYNUnyAjsYldiTMxYF1Cz79Q",
    "refresh_token": "0ryCENbbvfggZbNG9rFFd8_C8X0UgAQSMQkPJNStGwEEt0qNt-F1lw",
    "scope": "useraccount",
    "token_type": "Bearer",
    "expires_in": 1799
}
Ausgabenachrichten

Die Aktion OAuth-Token abrufen kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht
Successfully generated Oauth tokens for ServiceNow. Now navigate to the configuration tab and put "refresh_token" value in the "Refresh Token" parameter. Note: "Username" and "Password" parameters can be emptied. Die Aktion war erfolgreich.
Error executing action "Get Oauth Token". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion OAuth-Token abrufen verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

Eintragsdetails abrufen

Verwenden Sie die Aktion Eintragsdetails abrufen, um Informationen zu bestimmten Tabelleneinträgen in ServiceNow abzurufen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Eintragsdetails abrufen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Table Name

Pflichtangabe.

Der Name der ServiceNow-Tabelle, die den Datensatz enthält, aus dem Informationen abgerufen werden sollen (z. B. incident).
Record Sys ID

Pflichtangabe.

Die System-ID (sys_id) des spezifischen ServiceNow-Eintrags, für den Details abgerufen werden sollen.
Fields

Optional.

Eine durch Kommas getrennte Liste bestimmter Felder (Spalten), die aus dem abgerufenen Datensatz zurückgegeben werden sollen (z. B. sys_id,number,short_description).

Wenn kein Wert angegeben ist, gibt die Aktion die Standardfelder für den Datensatz zurück.

Aktionsausgaben

Die Aktion Eintragsdetails abrufen liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die Sie bei Verwendung der Aktion Eintragsdetails abrufen erhalten:

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  ATF Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "SYS_ID",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
Ausgabenachrichten

Die Aktion Eintragsdetails abrufen kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

Successfully retrieved information about the TABLE_NAME record with a Sys ID RECORD_SYS_ID in ServiceNow.

Action wasn't able to retrieve information about the TABLE_NAME record with a Sys ID RECORD_SYS_ID in ServiceNow. Reason: ERROR_REASON.

 Die Aktion war erfolgreich.
Error executing action "Get Record Details". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Eintragsdetails abrufen verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

Nutzerdetails abrufen

Verwenden Sie die Aktion Get User Details, um Informationen zum Nutzer mit dem Parameter sys_id in ServiceNow abzurufen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Nutzerdetails abrufen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
User Sys IDs

Optional.

Eine durch Kommas getrennte Liste der System-IDs, die den Nutzern entsprechen, für die Details abgerufen werden sollen (z. B. sys_id_1,sys_id_2).
Emails

Optional.

Eine durch Kommas getrennte Liste von E‑Mail-Adressen der Nutzer, für die Details abgerufen werden sollen (z. B. email1@example.com,email2@example.com).

Aktionsausgaben

Die Aktion Get User Details liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Tabelle mit Fall-Repository

Die Aktion Nutzerdetails abrufen stellt die folgende Tabelle bereit:

Tabellenname: User Details

Tabellenspalten:

  • Sys ID (zugeordnet als sys_id)
  • Name (zugeordnet als name)
  • Nutzername (zugeordnet als user_name)
  • E-Mail-Adresse (zugeordnet als email)
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Get User Details empfangen wird:

{
    "result": [
        {
            "calendar_integration": "1",
            "country": "",
            "last_position_update": "",
            "user_password": "example",
            "last_login_time": "",
            "source": "",
            "sys_updated_on": "2020-08-29 02:42:42",
            "building": "",
            "web_service_access_only": "false",
            "notification": "2",
            "enable_multifactor_authn": "false",
            "sys_updated_by": "user@example",
            "sys_created_on": "2012-02-18 03:04:52",
            "agent_status": "",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "",
            "vip": "false",
            "sys_created_by": "admin",
            "longitude": "",
            "zip": "",
            "home_phone": "",
            "time_format": "",
            "last_login": "",
            "default_perspective": "",
            "geolocation_tracked": "false",
            "active": "true",
            "sys_domain_path": "/",
            "cost_center": {
                "link": "https://example.service-now.com/api/now/table/cmn_cost_center/ID",
                "value": "ID"
            },
            "phone": "",
            "name": "Example User",
            "employee_number": "",
            "password_needs_reset": "false",
            "gender": "Male",
            "city": "",
            "failed_attempts": "",
            "user_name": "example.user",
            "latitude": "",
            "roles": "",
            "title": "",
            "sys_class_name": "sys_user",
            "sys_id": "SYS_ID",
            "internal_integration_user": "false",
            "ldap_server": "",
            "mobile_phone": "",
            "street": "",
            "company": {
                "link": "https://example.service-now.com/api/now/table/core_company/ID",
                "value": "ID"
            },
            "department": {
                "link": "https://dev98773.service-now.com/api/now/table/cmn_department/ID",
                "value": "ID"
            },
            "first_name": "Example",
            "email": "example@example.com",
            "introduction": "",
            "preferred_language": "",
            "manager": "",
            "business_criticality": "3",
            "locked_out": "false",
            "sys_mod_count": "4",
            "last_name": "User",
            "photo": "",
            "avatar": "063e38383730310042106710ce41f13b",
            "middle_name": "",
            "sys_tags": "",
            "time_zone": "",
            "schedule": "",
            "on_schedule": "",
            "date_format": "",
            "location": {
                "link": "https://example.service-now.com/api/now/table/cmn_location/ID",
                "value": "ID"
            }
        }
    ]
}
Ausgabenachrichten

Die Aktion Get User Details kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

Successfully retrieved information about users from ServiceNow with the following Sys IDs: SYS_ID_LIST.

Action wasn't able to retrieve information about the users in ServiceNow with the following Sys IDs: SYS_ID_LIST.

Information about the users with specified Sys IDs was not found in ServiceNow.

 Die Aktion war erfolgreich.
Error executing action "Get User Details". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Get User Details verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

CMDB-Einträge auflisten

Verwenden Sie die Aktion CMDB-Einträge auflisten, um CMDB-Einträge derselben Klasse in ServiceNow aufzulisten.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Abfragefilter generieren

Der Parameter Query Filter akzeptiert standardmäßige ServiceNow-codierte Abfragestrings (sysparm_query). Sie können diese Strings direkt in der ServiceNow-Oberfläche generieren (z. B. indem Sie einen Filter für eine Listenansicht erstellen und Abfrage kopieren auswählen) oder sie manuell erstellen.

Eine Anleitung zum Generieren und Verwenden dieser Strings finden Sie in der ServiceNow-Dokumentation unter Codierte Abfragestrings.

Aktionseingaben

Für die Aktion CMDB-Einträge auflisten sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Class Name

Pflichtangabe.

Der Name der CMDB-Klasse, aus der Datensätze abgerufen werden sollen, z. B. cmdb_ci_appl.

Weitere Informationen zu ServiceNow-Klassennamen finden Sie unter Klassendefinition und Metadaten ansehen und bearbeiten.
Query Filter

Optional.

Der codierte Abfragestring, der zum Filtern der zurückgegebenen Einträge verwendet wird (z. B. sys_idLIKE1^sys_idSTARTSWITH0).

Sie können gültige Abfragestrings mit der Option Abfrage kopieren in ServiceNow-Listenansichten generieren. Weitere Informationen finden Sie unter Codierte Abfragestrings.
Max Records To Return

Optional.

Die maximale Anzahl von Datensätzen, die basierend auf den angewendeten Filtern abgerufen werden sollen.

Der Standardwert ist 50.

Aktionsausgaben

Die Aktion CMDB-Einträge auflisten liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Tabelle mit Fall-Repository

Die Aktion CMDB-Einträge auflisten stellt die folgende Tabelle bereit:

Tabellenname: CLASS_NAME-Datensätze

Tabellenspalten:

  • Name (zugeordnet als name)
  • Sys ID (zugeordnet als sys_id)
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion CMDB-Einträge auflisten empfangen wird:

{
    "result": [
        {
            "sys_id": "SYS_ID",
            "name": "Example server"
        }
    ]
}
Ausgabenachrichten

Die Aktion CMDB-Einträge auflisten kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

Successfully listed CMDB records for the Class CLASS_NAME in ServiceNow.

Action wasn't able to list CMDB records for the Class CLASS_NAME in ServiceNow. Reason: Class CLASS_NAME was not found in Service Now.".format(Class name)

 Die Aktion war erfolgreich.
Error executing action "List CMDB Records". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion CMDB-Einträge auflisten verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

Kommentare zu Datensätzen auflisten

Verwenden Sie die Aktion Datensatzkommentare auflisten, um Kommentare zu einem bestimmten Tabellendatensatz in ServiceNow aufzulisten.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Datensatzkommentare auflisten sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Table Name

Pflichtangabe.

Der Name der ServiceNow-Tabelle, die den Eintrag enthält, für den Kommentare aufgelistet werden sollen (z. B. incident).
Record Sys ID

Pflichtangabe.

Die System-ID (sys_id) des Datensatzes, für den Kommentare aufgelistet werden sollen.
Type

Pflichtangabe.

Der Typ der Kommentare oder Notizen, die abgerufen werden sollen.

Folgende Werte sind möglich:

  • Comment
  • Work Note

Der Standardwert ist Comment.
Max Results To Return

Optional.

Die maximale Anzahl der zurückzugebenden Kommentare oder Arbeitsnotizen.

Der Standardwert ist 50.

Aktionsausgaben

Die Aktion Datensatzkommentare auflisten liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Datensatzkommentare auflisten empfangen wird:

{
    "sys_id": "SYS_ID",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "test",
    "sys_created_by": "admin",
    "element": "comments"
}
Ausgabenachrichten

Die Aktion List Record Comments kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

Successfully returned CONTENT_TYPE related to TABLE_NAME with Sys ID SYS_ID in ServiceNow.

No CONTENT_TYPE were found for TABLE_NAME with Sys ID SYS_ID in ServiceNow.

 Die Aktion war erfolgreich.
Error executing action "List Record Comments". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Datensatzkommentare auflisten verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

Verwenden Sie die Aktion List Records Related To User, um Datensätze aus einer Tabelle aufzulisten, die mit einem Nutzer in ServiceNow verknüpft sind.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Datensätze zu Nutzer auflisten sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Table Name

Pflichtangabe.

Der Name der ServiceNow-Tabelle, in der nach zugehörigen Datensätzen gesucht werden soll (z. B. incident).
Usernames

Pflichtangabe.

Eine durch Kommas getrennte Liste von Nutzernamen, für die die zugehörigen Einträge abgerufen werden sollen.
Max Days Backwards

Pflichtangabe.

Die Anzahl der Tage, die ab dem aktuellen Datum zurückgerechnet werden, um nach zugehörigen Datensätzen zu suchen.

Der Standardwert ist 1.
Max Records To Return

Optional.

Die maximale Anzahl von Datensätzen, die für jeden Nutzer zurückgegeben werden sollen.

Der Standardwert ist 50.

Aktionsausgaben

Die Aktion Datensätze auflisten, die mit dem Nutzer verknüpft sind liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die Sie bei Verwendung der Aktion List Records Related To User erhalten:

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-19 14:18:40",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010008",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-19 14:18:40",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-19 14:18:20",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "TEST",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": "",
            "sys_id": "SYS_ID",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": {
                "link": "https://example.service-now.com/api/now/table/core_company/ID",
                "value": "ID"
            },
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
         "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}
Ausgabenachrichten

Die Aktion Datensätze auflisten, die mit dem Nutzer verknüpft sind kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

Successfully retrieved related records from the table TABLE_NAME in ServiceNow for the following users: USERNAME_LIST.

Action wasn't able to retrieve related records from the table TABLE_NAME in ServiceNow for the following users: USERNAME_LIST.

No related table records were retrieved for the provided users.

Die Aktion war erfolgreich.
Error executing action "List Records Related To User". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Mit Nutzer verknüpfte Datensätze auflisten verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

Ping

Verwenden Sie die Aktion Ping, um die Verbindung zu ServiceNow zu testen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Keine.

Aktionsausgaben

Die Aktion Ping liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Nicht verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Ping aufgeführt:

Name des Skriptergebnisses Wert
is_success true oder false

Vorfall aktualisieren

Verwenden Sie die Aktion Vorfall aktualisieren, um die Vorfallsinformationen zu aktualisieren.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Vorfall aktualisieren sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Incident Number

Pflichtangabe.

Die eindeutige Kennung des zu aktualisierenden ServiceNow-Vorfalls im Format INCINCIDENT_NUMBER.
Short Description

Optional.

Eine kurze Beschreibung des Vorfalls.
Impact

Optional.

Eine Auswirkungsebene für den Vorfall.

Folgende Werte sind möglich:

  • 1 für „Hoch“
  • 2 für Medium
  • 3 für „Niedrig“

Der Standardwert ist 1.
Urgency

Optional.

Eine Dringlichkeitsstufe für den Vorfall.

Folgende Werte sind möglich:

  • 1 für „Hoch“
  • 2 für Medium
  • 3 für „Niedrig“

Der Standardwert ist 1.
Category

Optional.

Eine Kategorie für den Vorfall.
Assignment Group ID

Optional.

Der vollständige Name einer Gruppe, der der Vorfall zugewiesen werden soll.
Assigned User ID

Optional.

Der vollständige Name eines Nutzers, dem der Vorfall zugewiesen werden soll.
Description

Optional.

Die Beschreibung des Vorfalls.
Incident State

Optional.

Der zugrunde liegende ServiceNow-Wert für den Vorfallstatus (z. B. 1 oder in_progress) anstelle des Labels (z. B. New oder In Progress).
Custom Fields

Optional.

Ein JSON-formatierter String mit Feldnamen und den entsprechenden zu aktualisierenden Werten (z. B. {"location":"London", "category":"database"}).

Mit diesem Parameter können Sie Felder ändern, die nicht explizit als Aktionseingaben definiert sind.

Aktionsausgaben

Die Aktion Vorfall aktualisieren liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Nicht verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Vorfall aktualisieren empfangen wird:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": "2012",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010041",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "10",
    "notify": "1",
    "resolved_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": "2020-07-10 12:53:06",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "priority": "1",
    "state": "7",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 12:18:04",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "sdf",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": "0",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": "Closed by Caller",
    "business_duration": "1970-01-01 00:00:00",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 13:13:57",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": "1970-01-01 00:35:02",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "false",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 14:33:28",
    "severity": "3",
    "incident_state": "7",
    "resolved_at": "2020-07-10 12:53:06",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 12:18:04",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": "Closed/Resolved by Caller",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Vorfall aktualisieren verwendet wird:

Name des Skriptergebnisses Wert
incident_number INCIDENT_NUMBER

Datensatz aktualisieren

Verwenden Sie die Aktion Eintrag aktualisieren, um vorhandene Einträge zu ändern, die zu verschiedenen Tabellen in ServiceNow gehören.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Eintrag aktualisieren sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Table Name

Optional.

Der Name der ServiceNow-Tabelle, die den zu aktualisierenden Eintrag enthält (z. B. incident).
Object Json Data

Pflichtangabe.

Ein JSON-Objekt, das die Feld-Wert-Paare enthält, die auf den Eintrag angewendet werden sollen (z. B. {"short_description": "Updated description"}).
Record Sys ID

Pflichtangabe.

Die System-ID (sys_id) des zu aktualisierenden Datensatzes.

Aktionsausgaben

Die Aktion Eintrag aktualisieren liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Eintrag aktualisieren empfangen wird:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010021",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "3",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "5",
    "state": "1",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 08:24:34",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": " ",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 08:24:34",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": " ",
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": " ",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 08:24:34",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "3",
    "reopen_count": "0"
}
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Eintrag aktualisieren verwendet wird:

Name des Skriptergebnisses Wert
record_sys_id RECORD_SYS_ID

Auf Kommentare warten

Mit der Aktion Auf Kommentare warten können Sie die Ausführung des Playbooks pausieren, bis einem bestimmten Tabelleneintrag in ServiceNow ein Kommentar oder eine Arbeitsnotiz hinzugefügt wird.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Auf Kommentare warten sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Table Name

Pflichtangabe.

Der Name der ServiceNow-Tabelle, die den Eintrag enthält, für den auf Kommentare gewartet werden soll (z. B. incident).
Record Sys ID

Pflichtangabe.

Die System-ID (sys_id) des Datensatzes, der auf Kommentare überwacht werden soll.
Type

Pflichtangabe.

Die Art von Kommentaren oder Notizen, auf die die Aktion warten soll.

Folgende Werte sind möglich:

  • Comment
  • Work Note

Der Standardwert ist Comment.
Wait Mode

Pflichtangabe.

Die Bedingung, die bestimmt, wann die Aktion nicht mehr wartet und fortgesetzt wird.

Folgende Werte sind möglich:

  • Until Timeout: Die Aktion wartet den gesamten Zeitüberschreitungszeitraum ab und gibt dann alle akkumulierten Kommentare zurück.
  • Until First Message: Die Aktion wartet, bis der erste neue Kommentar oder die erste neue Arbeitsnotiz nach dem Start der Aktion gepostet wird.
  • Until Specific Text: Die Aktion wartet, bis ein Kommentar oder eine Arbeitsnotiz mit dem in Text angegebenen Text gepostet wird.

Der Standardwert ist Until Timeout.
Text

Optional.

Der spezifische Textstring, auf den die Aktion in einem neuen Kommentar oder einer neuen Arbeitsnotiz wartet.

Dieser Parameter wird nur verwendet, wenn Until Specific Text für den Wert von Wait Mode ausgewählt ist.

Aktionsausgaben

Die Aktion Auf Kommentare warten liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Auf Kommentare warten empfangen wird:

{
    "sys_id": "SYS_ID",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "test",
    "sys_created_by": "admin",
    "element": "comments"
}
Ausgabenachrichten

Die Aktion Auf Kommentare warten kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

Successfully returned CONTENT_TYPE related to TABLE_NAME with Sys ID SYS_ID in ServiceNow.

No new CONTENT_TYPE were added during the timeframe of action execution to TABLE_NAME with Sys ID SYS_ID in ServiceNow.

 Die Aktion war erfolgreich.
Error executing action "Wait For Comments". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Auf Kommentare warten verwendet wird:

Name des Skriptergebnisses Wert
is_success true oder false

Auf Feldaktualisierung warten

Verwenden Sie die Aktion Auf Feldaktualisierung warten, um die Playbook-Ausführung zu pausieren, bis ein bestimmtes Feld in einem ServiceNow-Datensatz auf einen der erwarteten Werte aktualisiert wird.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Auf Feldaktualisierung warten sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Table Name

Pflichtangabe.

Der Name der ServiceNow-Tabelle, die den zu überwachenden Eintrag enthält (z. B. incident).
Record Sys ID

Pflichtangabe.

Die System-ID (sys_id) des Datensatzes, der auf die Feldaktualisierung überwacht werden soll.
Field - Column Name

Pflichtangabe.

Der Name der Spalte (des Felds), die von der Aktion auf Änderungen überwacht wird.
Field - Values

Pflichtangabe.

Eine durch Kommas getrennte Liste von Werten, die, wenn sie im überwachten Feld gefunden werden, dazu führen, dass die Aktion nicht mehr wartet und fortgesetzt wird (z. B. In Progress,Resolved).

Aktionsausgaben

Die Aktion Auf Feldaktualisierung warten liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Nicht verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Auf Feldaktualisierung warten verwendet wird:

Name des Skriptergebnisses Wert
updated_field UPDATED_FIELD

Auf Statusaktualisierung warten

Mit der Aktion Auf Statusaktualisierung warten können Sie die Playbook-Ausführung pausieren, bis ein bestimmter ServiceNow-Vorfallstatus (Status) auf einen der erwarteten Werte aktualisiert wird.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Auf Statusaktualisierung warten sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Incident Number

Pflichtangabe.

Die eindeutige Kennung des zu überwachenden ServiceNow-Vorfalls im Format INCINCIDENT_NUMBER.
Statuses

Pflichtangabe.

Eine durch Kommas getrennte Liste von Vorfallstatuswerten, die, wenn sie erreicht werden, dazu führen, dass die Aktion nicht mehr wartet und fortgesetzt wird (z. B. In Progress,Resolved).

Aktionsausgaben

Die Aktion Auf Statusaktualisierung warten liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall-Repository Nicht verfügbar
Tabelle mit Fall-Repository Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Nicht verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Auf Statusaktualisierung warten verwendet wird:

Name des Skriptergebnisses Wert
new_status STATUS

Connectors

Weitere Informationen zum Konfigurieren von Connectors in Google SecOps finden Sie unter Daten aufnehmen (Connectors).

ServiceNow-Connector

Verwenden Sie den ServiceNow-Connector, um Vorfälle aus ServiceNow abzurufen.

Mit der dynamischen Abfrageliste arbeiten

Im ServiceNow-Connector ändert die dynamische Liste die sysparm_query, die der Connector zum Abfragen von ServiceNow verwendet. So können Sie Einträge nach jedem unterstützten Feld für den Eintragstyp filtern.

Wenn Sie einen Filter definieren möchten, konfigurieren Sie jedes dynamische Listenelement so, dass es ein Feld-Wert-Paar im folgenden Format enthält: FIELD_NAME=VALUE.

Beispiel: category=security.

Wenn Use whitelist as a blacklist aktiviert ist, kehrt der Connector die Abfragelogik um, sodass die dynamische Liste als Sperrliste und nicht als Filter fungiert.

Connector-Eingaben

Für den ServiceNow-Connector sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Product Field Name

Pflichtangabe.

Der Name des Felds, in dem der Produktname gespeichert ist.

Der Produktname wirkt sich hauptsächlich auf die Zuordnung aus. Um den Zuordnungsprozess für den Connector zu optimieren und zu verbessern, wird der Standardwert in einen Fallback-Wert aufgelöst, auf den im Code verwiesen wird. Jede ungültige Eingabe für diesen Parameter wird standardmäßig in einen Fallback-Wert aufgelöst.

Der Standardwert ist Product Name.
Event Field Name

Pflichtangabe.

Der Name des Felds, das den Ereignisnamen (Untertyp) bestimmt.

Der Standardwert ist sys_class_name.
Rule Generator

Optional.

Der Name des Feldes, dessen Wert die spezifische Abfrage oder den Regelsatz definiert, die bzw. der beim Abrufen von Datensätzen angewendet werden soll.
Api Root

Pflichtangabe.

Der API-Stamm der ServiceNow-Instanz.

Der Standardwert ist https://INSTANCE.service-now.com/api/now/v1/.
Username

Pflichtangabe.

Der Nutzername des ServiceNow-Kontos.
Password

Pflichtangabe.

Das Passwort des ServiceNow-Kontos.
Verify SSL

Optional.

Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum ServiceNow-Server hergestellt wird.

Standardmäßig aktiviert.
Use sys_domain Environment

Optional.

Wenn diese Option ausgewählt ist, verwendet der Connector das ServiceNow-Feld sys_domain als Umgebung für den aufgenommenen Fall.

Wenn dieses Feld fehlt oder nicht verfügbar ist, verwendet der Connector standardmäßig den im Parameter Environment angegebenen Wert.
Days Backwards

Optional.

Die Anzahl der Tage, die ab dem aktuellen Zeitpunkt zurückgegangen werden soll, um Datensätze abzurufen.

Dieser Parameter wird für die erste Connector-Ausführung oder als Fallback-Wert verwendet, wenn ein vorheriger Connector-Zeitstempel abgelaufen ist.

Der Standardwert ist 5.
Disable Overflow

Optional.

Wenn diese Option ausgewählt ist, ignoriert der Connector den Google SecOps-Überlaufmechanismus.
Max Incidents Per Cycle

Optional.

Die maximale Anzahl von Vorfällen, die bei jeder Connector-Iteration abgerufen werden sollen.

Der Standardwert ist 10.
Environments Whitelist

Optional.

Eine durch Kommas getrennte Liste von Umgebungen (Domains), die der Connector in Google SecOps aufnehmen soll, z. B. env1,env2.
Use whitelist as a blacklist

Optional.

Wenn diese Option ausgewählt ist, verwendet der Connector die dynamische Liste als Sperrliste.

Standardmäßig deaktiviert.
PythonProcessTimeout

Pflichtangabe.

Das Zeitlimit in Sekunden für den Python-Prozess, der das aktuelle Script ausführt.

Der Standardwert ist 60.
Incident Table

Optional.

Der API-Tabellenname oder -Pfad, der für vorfallbezogene Aktionen und das Abrufen von Einträgen verwendet werden soll.

Standardmäßig verwendet die Integration den Pfad table/incident.
Client ID

Optional.

Die Client-ID für die ServiceNow-Integration, die für die OAuth 2.0-Authentifizierung mit Clientanmeldedaten erforderlich ist.

Sie können sich entweder mit dem Aktualisierungstoken oder mit den Clientanmeldedaten authentifizieren. Wenn sowohl das Aktualisierungstoken als auch die Clientanmeldedaten konfiguriert sind, verwendet die Integration das Aktualisierungstoken für die Authentifizierung.
Client Secret

Optional.

Der Clientschlüssel für die ServiceNow-Integration, der für die OAuth 2.0-Authentifizierung mit Clientanmeldedaten erforderlich ist.

Sie können sich entweder mit dem Aktualisierungstoken oder mit den Clientanmeldedaten authentifizieren. Wenn sowohl das Aktualisierungstoken als auch die Clientanmeldedaten konfiguriert sind, verwendet die Integration das Aktualisierungstoken für die Authentifizierung.
Refresh Token

Optional.

Das Aktualisierungstoken für die ServiceNow-Integration, das für die OAuth 2.0-Authentifizierung mit einem Aktualisierungstoken erforderlich ist.

Dieses konfigurierte Aktualisierungstoken läuft alle 90 Tage ab.

Sie können sich entweder mit dem Aktualisierungstoken oder mit den Clientanmeldedaten authentifizieren. Wenn sowohl das Aktualisierungstoken als auch die Clientanmeldedaten konfiguriert sind, wird das Aktualisierungstoken für die Authentifizierung verwendet.
Assignment Group

Optional.

Der Name der Zuweisungsgruppe, deren Datensätze der Connector aufnehmen soll.
Use Oauth Authentication

Optional.

Wenn diese Option ausgewählt ist, wird für die Authentifizierung der Integration OAuth 2.0 verwendet.

Für die OAuth 2.0-Authentifizierung müssen entweder die Clientanmeldedaten (Client ID und Client Secret) oder Refresh Token festgelegt werden.

Standardmäßig deaktiviert.
Server Time Zone

Optional.

Die auf dem ServiceNow-Server konfigurierte Zeitzone (z. B. UTC oder Asia/Jerusalem).

Der Standardwert ist UTC.
Table Name

Optional.

Der Name der Tabelle, aus der Datensätze abgerufen werden sollen, z. B. incident.
Event Name

Optional.

Der Name des Google SecOps-Ereignisses, das beim Erfassen eines Datensatzes erstellt wird (z. B. ServiceNowEvent).
Proxy Server Address

Optional.

Die Adresse des zu verwendenden Proxyservers.
Proxy Username

Optional.

Der Proxy-Nutzername für die Authentifizierung.
Proxy Password

Optional.

Das Proxy-Passwort für die Authentifizierung.
Get User Information

Optional.

Wenn diese Option ausgewählt ist, ruft der Connector zusätzlich die Informationen zu Nutzern ab, die mit dem Vorfall in Verbindung stehen.

Standardmäßig deaktiviert.

Jobs

Weitere Informationen zu Jobs finden Sie unter Neuen Job konfigurieren und Erweiterte Planung.

ServiceNow – Geschlossene Vorfälle synchronisieren

Verwenden Sie den Job ServiceNow – Geschlossene Vorfälle synchronisieren, um geschlossene ServiceNow-Vorfälle mit den entsprechenden Google SecOps-Warnungen und ‑Fällen zu synchronisieren.

Mit diesem Job werden ServiceNow-Vorfälle verarbeitet, die als Benachrichtigungen und Fälle mit dem Tag ServiceNow und dem Kontextwert TICKET_ID mit der Vorfallnummer aufgenommen wurden.

Jobparameter

Für den Job ServiceNow – Geschlossene Vorfälle synchronisieren sind die folgenden Parameter erforderlich:

Parameter Beschreibung
API Root Obligatorisch

Der API-Stamm der ServiceNow-Instanz. Standardwert ist https://INSTANCE.service-now.com/api/now/v1/.
Username Obligatorisch

Der Nutzername der ServiceNow-Instanz.
Password Obligatorisch

Das Passwort der ServiceNow-Instanz.
Verify SSL Optional

Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum ServiceNow-Server hergestellt wird. Standardmäßig aktiviert.
Client ID Optional

Die Client-ID für die ServiceNow-Integration, die für die OAuth 2.0-Authentifizierung mit Clientanmeldedaten erforderlich ist. Sie können sich entweder mit dem Aktualisierungstoken oder mit den Clientanmeldedaten authentifizieren. Wenn sowohl das Aktualisierungstoken als auch die Clientanmeldedaten konfiguriert sind, wird das Aktualisierungstoken für die Authentifizierung verwendet.
Client Secret Optional

Der Clientschlüssel für die ServiceNow-Integration, der für die OAuth 2.0-Authentifizierung mit Clientanmeldedaten erforderlich ist. Sie können sich entweder mit dem Aktualisierungstoken oder mit den Clientanmeldedaten authentifizieren. Wenn sowohl das Aktualisierungstoken als auch die Clientanmeldedaten konfiguriert sind, wird das Aktualisierungstoken für die Authentifizierung verwendet.
Refresh Token Optional

Das Aktualisierungstoken für die ServiceNow-Integration, das für die OAuth 2.0-Authentifizierung mit einem Aktualisierungstoken erforderlich ist. Dieses konfigurierte Aktualisierungstoken läuft alle 90 Tage ab. Sie können sich entweder mit dem Aktualisierungstoken oder mit Clientanmeldedaten authentifizieren. Wenn sowohl das Aktualisierungstoken als auch die Clientanmeldedaten konfiguriert sind, wird das Aktualisierungstoken für die Authentifizierung verwendet.
Use OAuth Authentication Optional

Wenn diese Option ausgewählt ist, wird für die Authentifizierung der Integration OAuth 2.0 verwendet. Für die OAuth 2.0-Authentifizierung müssen entweder die Clientanmeldedaten (Client ID und Client Secret) oder Refresh Token festgelegt werden. Standardmäßig deaktiviert.
Max Hours Backwards Optional

Die Anzahl der Stunden, die ab der aktuellen Uhrzeit zurückgerechnet werden, um nach geschlossenen Vorfällen zu suchen und diese zu synchronisieren. Standardwert ist 24.
Table Name Obligatorisch

Der Name der Datenbanktabelle, in der nach geschlossenen Vorfällen gesucht werden soll (z. B. incident).

ServiceNow – Vorfälle synchronisieren

Verwenden Sie den Job ServiceNow – Vorfälle synchronisieren, um ServiceNow-Vorfallfelder und ‑Anhänge mit zugehörigen Fällen und Benachrichtigungen in Google SecOps zu synchronisieren.

Zum Ausführen dieses Jobs muss der ServiceNow-Integrationsnutzer die ITIL-Rolle (itil) haben. Weitere Informationen finden Sie in der ServiceNow-Dokumentation unter Base system roles.

Jobanforderungen

Damit der Job ordnungsgemäß funktioniert, müssen im Google SecOps-Fall oder in der Google SecOps-Meldung (je nach Parameter Sync Level) die folgenden Einstellungen konfiguriert sein:

  • Tag: Die Anfrage muss das Tag ServiceNow Incident Sync haben.
  • Kontextwert: Der Fall oder die Meldung muss einen Kontextschlüssel TICKET_ID mit einer durch Kommas getrennten Liste von ServiceNow-Vorfallsnummern (z. B. INC0000050,INC0000051) enthalten. Legen Sie den Kontextwert TICKET_ID mit der Aktion Bereichskontextwert festlegen aus der Siemplify Utilities-Integration fest.

Jobparameter

Für den Job ServiceNow – Vorfälle synchronisieren sind die folgenden Parameter erforderlich:

Parameter Beschreibung
API Root Obligatorisch

Der API-Stamm der ServiceNow-Instanz. Standardwert ist https://INSTANCE.service-now.com/api/now/v1/.
Username Optional

Der Nutzername der ServiceNow-Instanz.

Dieser Parameter ist erforderlich, wenn die Authentifizierung über die Basisauthentifizierung mit Passwort erfolgt.
Password Optional

Das Passwort der ServiceNow-Instanz.

Dieser Parameter ist erforderlich, wenn die Authentifizierung über die Basisauthentifizierung mit Passwort erfolgt.
Sync Level Obligatorisch

Die Ebene, auf der der Job Daten synchronisiert. Mögliche Werte: Case, Alert. Der Standardwert ist Case.
Max Hours Backwards Obligatorisch

Die maximale Anzahl von Stunden, die ab der aktuellen Zeit zurückgerechnet werden, um nach zu synchronisierenden Fällen zu suchen. Standardwert ist 24.
Verify SSL Optional

Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum ServiceNow-Server hergestellt wird. Standardmäßig aktiviert.
Use OAuth Authentication Optional

Wenn diese Option ausgewählt ist, wird für den Job die OAuth-Authentifizierung anstelle der Basisauthentifizierung verwendet. Wenn diese Option ausgewählt ist, sind die Parameter Client ID, Client Secret und Refresh Token erforderlich. Standardmäßig deaktiviert.
Client ID Optional

Die Client-ID der ServiceNow-Anwendung. Erforderlich, wenn Use OAuth Authentication ausgewählt ist.
Client Secret Optional

Der Clientschlüssel der ServiceNow-Anwendung. Erforderlich, wenn Use OAuth Authentication ausgewählt ist.
Refresh Token Optional

Das Aktualisierungstoken für die ServiceNow-Anwendung. Erforderlich, wenn Use OAuth Authentication ausgewählt ist.

Kommentare zu Tabelleneinträgen synchronisieren

Verwenden Sie den Job Sync Table Record Comments, um Kommentare zwischen ServiceNow-Tabelleneinträgen und Google SecOps-Fällen zu synchronisieren.

Jobparameter

Für den Job Sync Table Record Comments sind die folgenden Parameter erforderlich:

Parameter Beschreibung
API Root Obligatorisch

Der API-Stamm der ServiceNow-Instanz. Standardwert ist https://INSTANCE.service-now.com/api/now/v1/.
Username Obligatorisch

Der Nutzername der ServiceNow-Instanz.
Password Obligatorisch

Das Passwort der ServiceNow-Instanz.
Verify SSL Optional

Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum ServiceNow-Server hergestellt wird. Standardmäßig aktiviert.
Client ID Optional

Die Client-ID für die ServiceNow-Integration, die für die OAuth 2.0-Authentifizierung mit Clientanmeldedaten erforderlich ist. Sie können sich entweder mit dem Aktualisierungstoken oder mit den Clientanmeldedaten authentifizieren. Wenn sowohl das Aktualisierungstoken als auch die Clientanmeldedaten konfiguriert sind, wird das Aktualisierungstoken für die Authentifizierung verwendet.
Client Secret Optional

Der Clientschlüssel für die ServiceNow-Integration, der für die OAuth 2.0-Authentifizierung mit Clientanmeldedaten erforderlich ist. Sie können sich entweder mit dem Aktualisierungstoken oder mit den Clientanmeldedaten authentifizieren. Wenn sowohl das Aktualisierungstoken als auch die Clientanmeldedaten konfiguriert sind, wird das Aktualisierungstoken für die Authentifizierung verwendet.
Refresh Token Optional

Das Aktualisierungstoken für die ServiceNow-Integration, das für die OAuth 2.0-Authentifizierung mit einem Aktualisierungstoken erforderlich ist. Dieses konfigurierte Aktualisierungstoken läuft alle 90 Tage ab. Sie können sich entweder mit dem Aktualisierungstoken oder mit Clientanmeldedaten authentifizieren. Wenn sowohl das Aktualisierungstoken als auch die Clientanmeldedaten konfiguriert sind, wird das Aktualisierungstoken für die Authentifizierung verwendet.
Use OAuth Authentication Optional

Wenn diese Option ausgewählt ist, wird für die Authentifizierung der Integration OAuth 2.0 verwendet. Für die OAuth 2.0-Authentifizierung müssen entweder die Clientanmeldedaten (Client ID und Client Secret) oder Refresh Token festgelegt werden. Standardmäßig deaktiviert.
Table Name Obligatorisch

Der Name der ServiceNow-Tabelle, in der nach Datensätzen gesucht werden soll, aus denen Kommentare synchronisiert werden sollen (z. B. incident).

Kommentare zu Tabelleneinträgen nach Tag synchronisieren

Verwenden Sie den Job Sync Table Record Comments By Tag, um Kommentare zwischen ServiceNow-Tabelleneinträgen und Google SecOps-Fällen zu synchronisieren.

Jobanforderungen

Damit der Job ordnungsgemäß funktioniert, muss der Google SecOps-Fall die folgenden beiden Tags haben:

  • ServiceNow TABLE_NAME (wobei <var class="readonly">TABLE_NAME</var> der Name der ServiceNow-Tabelle ist, z. B. incident).
  • ServiceNow TicketId: TICKET_ID (wobei <var class="readonly">TICKET_ID</var> die System-ID oder Nummer des entsprechenden Datensatzes ist).

Jobparameter

Für den Job Sync Table Record Comments By Tag sind die folgenden Parameter erforderlich:

Parameter Beschreibung
API Root Obligatorisch

Der API-Stamm der ServiceNow-Instanz. Standardwert ist https://INSTANCE.service-now.com/api/now/v1/.
Username Obligatorisch

Der Nutzername der ServiceNow-Instanz.
Password Mandatory

Das Passwort der ServiceNow-Instanz.
Table Name Obligatorisch

Der Name der zu durchsuchenden Datenbanktabelle, z. B. incident.
Verify SSL Optional

Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum ServiceNow-Server hergestellt wird. Standardmäßig aktiviert.

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