ServiceDesk Plus

Integrationsversion: 5.0

‌ServiceDesk Plus für die Verwendung mit Google Security Operations konfigurieren

1. Um den API-Schlüssel zu generieren, gehen Sie im Nutzerblock zu Administrator > Techniker.
2. Wenn Sie den API-Schlüssel für den vorhandenen Techniker generieren möchten, klicken Sie neben dem Techniker auf das Bearbeitungssymbol. Wenn Sie den API-Schlüssel für einen neuen Techniker generieren möchten, klicken Sie auf den Link Neuen Techniker hinzufügen, geben Sie die Technikerdetails ein und erteilen Sie die Anmeldeberechtigung.
3. Klicken Sie unter dem Block mit API-Schlüsseldetails auf Link generieren. Sie können mit dem Kalendersymbol einen Zeitraum für den Ablauf des Schlüssels auswählen oder den Schlüssel einfach dauerhaft beibehalten.
4. Wenn bereits ein Schlüssel für den Techniker generiert wurde, wird der Link Link neu generieren angezeigt.

ServiceDesk Plus-Integration in Google SecOps konfigurieren

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

Integrationsparameter

Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:

Parameter	Typ	Standardwert	Beschreibung
API-Stamm	String	http://{IP OR FQDN}:8080/api/v3/	API-Stamm von ServiceDesk Plus.

Aktionen

Notiz hinzufügen

Beschreibung

Wenn Sie einem bestimmten Antrag basierend auf Ihren Beobachtungen zusätzliche Informationen, einschließlich technischer Informationen, hinzufügen möchten, können Sie Notizen hinzufügen. Sie können auch Notizen verwenden, um den Status der Anfrage zu aktualisieren.

Parameter

Parameter	Typ	Standardwert	Beschreibung
Anfrage-ID	String	–	Die ID der Anfragen.
Hinweis	String	–	Der Inhalt der Notiz.
Öffentlich	Kästchen	Deaktiviert	Gibt an, ob die Notiz öffentlich sein soll oder nicht.

Ausführen am

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

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
Erfolgreich	Wahr/falsch	success:False

JSON-Ergebnis

N/A

Hinweis hinzufügen und auf Antwort warten

Beschreibung

Fügen Sie eine Notiz hinzu und warten Sie, bis die neuen Notizen der Anfrage hinzugefügt werden.

Parameter

Parameter	Typ	Standardwert	Beschreibung
Anfrage-ID	String	–	Die ID der Anfragen.
Hinweis	String	–	Der Inhalt der Notiz.
Öffentlich	Kästchen	–	Gibt an, ob die Notiz öffentlich sein soll oder nicht.

Ausführen am

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

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
new_notes	–	–

JSON-Ergebnis

N/A

Anfrage schließen

Beschreibung

Wenn ein Anfragender vollständig zufrieden ist, dass seine Anfrage bearbeitet wurde und das gemeldete Problem behoben wurde, kann die Anfrage geschlossen werden.

Parameter

Parameter	Typ	Standardwert	Beschreibung
Anfrage-ID	String	–	Die ID der Anfrage.
Kommentar	String	–	Abschließender Kommentar.
Lösung bestätigt	Kästchen	–	Gibt an, ob die Lösung der Anfrage bestätigt wurde.

Ausführen am

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

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
Erfolgreich	Wahr/falsch	success:False

JSON-Ergebnis

N/A

Benachrichtigungsanfrage erstellen

Beschreibung

Erstellen Sie eine Anfrage zu einer Google SecOps-Benachrichtigung.

Parameter

Parameter	Typ	Standardwert	Beschreibung
Betreff	String	–	Der Betreff der Anfrage.
Anforderer	String	–	Der Anfragesteller. Wenn nicht angegeben, wird der Nutzer des API-Schlüssels verwendet.
Status	String	–	Der Status der Anfrage.
Techniker	String	–	Der Name des Technikers, der der Anfrage zugewiesen ist.
Priorität	String	–	Die Priorität der Anfrage.
Dringlichkeit	String	–	Die Dringlichkeit der Anfrage.
Kategorie	String	–	Die Kategorie der Anfrage.
Anfragevorlage	String	–	Die Vorlage der Anfrage.
Anfragetyp	String	–	Der Typ der Anfrage. Beispiel: Vorfall, Serviceanfrage
Fälligkeitszeit (ms)	String	–	Das Fälligkeitsdatum der Anfrage in Millisekunden.
Modus	String	–	Der Modus der Anfrage.
Level	String	–	Die Ebene der Anfrage.
Website	String	–	Die Website der Anfrage.
Gruppe	String	–	Die Gruppe der Anfrage.
Auswirkungen	String	–	Die Auswirkungen der Anfrage.

Ausführen am

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

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
Erfolgreich	Wahr/falsch	success:False

JSON-Ergebnis

N/A

Anfrage erstellen

Beschreibung

Wenn in Ihrem System ein Fehler oder Problem auftritt, melden Sie es, d.h. senden Sie eine Anfrage an das IT-Helpdesk-Team. Es gibt verschiedene Möglichkeiten, eine Anfrage zu stellen: über ein webbasiertes Formular, per E‑Mail oder telefonisch. ServiceDesk Plus bietet Optionen zum Protokollieren von Details einer Anfrage, die aus einem der oben genannten Formulare stammt.

Parameter

Parameter	Typ	Standardwert	Beschreibung
Betreff	String	–	Der Betreff der Anfrage.
Anforderer	String	–	Der Anfragesteller. Wenn nicht angegeben, wird der Nutzer des API-Schlüssels verwendet.
Beschreibung	String	–	Die Beschreibung der Anfrage.
Status	String	–	Der Status der Anfrage.
Techniker	String	–	Der Name des Technikers, der der Anfrage zugewiesen ist.
Priorität	String	–	Die Priorität der Anfrage.
Dringlichkeit	String	–	Die Dringlichkeit der Anfrage.
Kategorie	String	–	Die Kategorie der Anfrage.
Anfragevorlage	String	–	Die Vorlage der Anfrage.
Anfragetyp	String	–	Der Typ der Anfrage. Beispiel: Vorfall, Serviceanfrage
Fälligkeitszeit (ms)	String	–	Das Fälligkeitsdatum der Anfrage in Millisekunden.
Modus	String	–	Der Modus der Anfrage.
Level	String	–	Die Ebene der Anfrage.
Website	String	–	Die Website der Anfrage.
Gruppe	String	–	Die Gruppe der Anfrage.
Auswirkungen	String	–	Die Auswirkungen der Anfrage.

Ausführen am

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

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
request_id	–	–

JSON-Ergebnis

{
    "isvipuser": "No",
    "subcategory": null,
    "resolvedtime": "0",
    "site": "Chicago",
    "timespentonreq": "0hrs 0min",
    "technician": "Shawn Adams",
    "responseduebytime": "1556101814544",
    "shortdescription": "Testing the API adding request",
    "fr_duetime": "1556101814544",
    "subject": "Testing API 2",
    "impact": "Affects Business",
    "city": "London",
    "group": null,
    "approval_status": null,
    "area": null,
    "requesttype": "Convert the Incident to Change",
    "yettoreplycount": null,
    "priority": "High",
    "respondedtime": "0",
    "asset": null,
    "createdby": "Demo",
    "duebytime": "1556164814544",
    "department": null,
    "status": "Work Inprogress",
    "category": "General",
    "fcr": "false",
    "description": "Testing the API adding request",
    "closurecode": null,
    "workorderid": "123",
    "completedtime": "0",
    "requesttemplate": "Default Request",
    "requester": "Catrin Folkesson",
    "createdtime": "1556092814544",
    "technician_loginname": "adams",
    "editing_status": "0",
    "level": "Tier 1",
    "country": "India",
    "is_catalog_template": "false",
    "sla": "High SLA",
    "item": null,
    "closurecomments": null,
    "mode": "SMS",
    "editorid": "null",
    "impactdetails": null,
    "urgency": "High"
}

GET-Anfrage

Beschreibung

Informationen zu einer Anfrage abrufen.

Parameter

Parameter	Typ	Standardwert	Beschreibung
Anfrage-ID	String	–	Die ID der Anfrage.

Ausführen am

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

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
Erfolgreich	Wahr/falsch	success:False

JSON-Ergebnis

{
    "isvipuser": "No",
    "subcategory": null,
    "resolvedtime": "0",
    "site": "Chicago",
    "timespentonreq": "0hrs 0min",
    "technician": "Shawn Adams",
    "responseduebytime": "1556101814544",
    "shortdescription": "Testing the API adding request",
    "fr_duetime": "1556101814544",
    "subject": "Testing API 2",
    "impact": "Affects Business",
    "city": "London",
    "group": null,
    "approval_status": null,
    "area": null,
    "requesttype": "Convert the Incident to Change",
    "yettoreplycount": null,
    "priority": "High",
    "respondedtime": "0",
    "asset": null,
    "createdby": "Demo",
    "duebytime": "1556164814544",
    "department": null,
    "status": "Work Inprogress",
    "category": "General",
    "fcr": "false",
    "description": "Testing the API adding request",
    "closurecode": null,
    "workorderid": "123",
    "completedtime": "0",
    "requesttemplate": "Default Request",
    "requester": "Catrin Folkesson",
    "createdtime": "1556092814544",
    "technician_loginname": "adams",
    "editing_status": "0",
    "level": "Tier 1",
    "country": "India",
    "is_catalog_template": "false",
    "sla": "High SLA",
    "item": null,
    "closurecomments": null,
    "mode": "SMS",
    "editorid": "null",
    "impactdetails": null,
    "urgency": "High"
}

Ping

Beschreibung

Verbindung zur ServiceDesk Plus-Instanz testen

Parameter

–

Ausführen am

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

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_success	Wahr/falsch	is_success:False

JSON-Ergebnis

N/A

Aktualisierungsanfrage

Beschreibung

Anfrage aktualisieren

Parameter

Parameter	Typ	Standardwert	Beschreibung
Anfrage-ID	String	–	Die ID der zu aktualisierenden Anfrage.
Anforderer	String	–	Der Anfragesteller. Wenn nicht angegeben, wird der Nutzer des API-Schlüssels verwendet.
Beschreibung	String	–	Die Beschreibung der Anfrage.
Status	String	–	Der Status der Anfrage.
Techniker	String	–	Der Name des Technikers, der der Anfrage zugewiesen ist.
Priorität	String	–	Die Priorität der Anfrage.
Dringlichkeit	String	–	Die Dringlichkeit der Anfrage.
Kategorie	String	–	Die Kategorie der Anfrage.
Anfragevorlage	String	–	Die Vorlage der Anfrage.
Anfragetyp	String	–	Der Typ der Anfrage. Beispiel: Vorfall, Serviceanfrage
Fälligkeitszeit (ms)	String	–	Das Fälligkeitsdatum der Anfrage in Millisekunden.
Modus	String	–	Der Modus der Anfrage.
Level	String	–	Die Ebene der Anfrage.
Website	String	–	Die Website der Anfrage.
Gruppe	String	–	Die Gruppe der Anfrage.
Auswirkungen	String	–	Die Auswirkungen der Anfrage.

Ausführen am

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

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
Erfolgreich	Wahr/falsch	success:False

JSON-Ergebnis

{
    "isvipuser": "No",
    "subcategory": null,
    "resolvedtime": "0",
    "site": "Chicago",
    "timespentonreq": "0hrs 0min",
    "technician": "Shawn Adams",
    "responseduebytime": "1556101814544",
    "shortdescription": "Testing the API adding request",
    "fr_duetime": "1556101814544",
    "subject": "Testing API 2",
    "impact": "Affects Business",
    "city": "London",
    "group": null,
    "approval_status": null,
    "area": null,
    "requesttype": "Convert the Incident to Change",
    "yettoreplycount": null,
    "priority": "High",
    "respondedtime": "0",
    "asset": null,
    "createdby": "Demo",
    "duebytime": "1556164814544",
    "department": null,
    "status": "Work Inprogress",
    "category": "General",
    "fcr": "false",
    "description": "Testing the API adding request",
    "closurecode": null,
    "workorderid": "123",
    "completedtime": "0",
    "requesttemplate": "Default Request",
    "requester": "Catrin Folkesson",
    "createdtime": "1556092814544",
    "technician_loginname": "adams",
    "editing_status": "0",
    "level": "Tier 1",
    "country": "India",
    "is_catalog_template": "false",
    "sla": "High SLA",
    "item": null,
    "closurecomments": null,
    "mode": "SMS",
    "editorid": "null",
    "impactdetails": null,
    "urgency": "High"
}

Auf Feldaktualisierung warten

Beschreibung

Warten Sie, bis sich ein Anfragefeld in den gewünschten Wert ändert.

Parameter

Parameter	Typ	Standardwert	Beschreibung
Anfrage-ID	String	–	Die ID der Anfrage.
Feldname	String	–	Der Name des Felds, das aktualisiert werden soll.
Werte	String	–	Gewünschte Werte für das angegebene Feld.

Ausführen am

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

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
new_value	–	–

JSON-Ergebnis

N/A

Auf Statusaktualisierung warten

Beschreibung

Warten Sie, bis der Status einer Anfrage auf den gewünschten Status aktualisiert wird.

Parameter

Parameter	Typ	Standardwert	Beschreibung
Anfrage-ID	String	–	Die ID der Anfrage.
Status	String	–	Gewünschte Anfragestatus, durch Kommas getrennt.

Ausführen am

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

Aktionsergebnisse

Entitätsanreicherung

–

Statistiken

–

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
new_status	–	–

JSON-Ergebnis

N/A

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