Jira mit Google SecOps integrieren

Dieses Dokument erklärt, wie Jira in Google Security Operations integriert wird.

herunterladen.

Anwendungsfälle

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

  • Automatisierte Ticketerstellung: Erstellen Sie automatisch Jira-Vorgänge aus Google SecOps-Warnungen mithilfe des Jira Connector, um die Übergabe zwischen Sicherheits- und IT-Teams zu optimieren.

  • Bidirektionale Synchronisierung: Gewährleisten Sie die Konsistenz über verschiedene Plattformen hinweg, indem Sie Kommentare und Statusänderungen zwischen Jira-Tickets und Google SecOps-Fällen mithilfe dedizierter Synchronisierungsaufträge automatisch synchronisieren.

  • Vorfallsanreicherung: Fügen Sie Beweise, Protokolle und Screenshots direkt zu Jira-Vorgängen hinzu, indem Sie die Aktion Anhang hochladen verwenden, um den Bearbeitern den vollständigen Kontext bereitzustellen.

  • Dynamisches Aufgabenmanagement: Aktualisieren, weisen Sie verwandte Jira-Vorgänge direkt aus dem Google SecOps-Playbook zu oder verknüpfen Sie diese, um Standardarbeitsanweisungen (SOPs) zu automatisieren.

Hinweis

Bevor Sie die Jira-Integration in der Google SecOps-Plattform konfigurieren, vergewissern Sie sich, dass Sie Folgendes haben:

  • Produktkompatibilität: Zugriff auf entweder eine Jira Cloud-Instanz oder eine Jira Data Center (On-Prem)-Umgebung.

  • Authentifizierungsmethode: Wählen Sie eine Authentifizierungsmethode.

    • Basisauthentifizierung (Jira Cloud): Erfordert einen Benutzernamen (E-Mail-Adresse) und ein Atlassian API-Token.
    • Dienstkontoauthentifizierung (Jira Cloud): Erfordert ein Dienstkontotoken und Ihre Cloud-ID.
    • Standardauthentifizierung (Jira Data Center): Erfordert einen gültigen Benutzernamen und ein gültiges Passwort.

  • API-Root-URL: Das Format des API-Roots hängt von Ihrer Authentifizierungsmethode ab.

    • Standard/Basic: Die Basis-URL Ihrer Jira-Instanz (zum Beispiel https://yourdomain.atlassian.net).
    • Dienstkonto: Die Atlassian API-Proxy-URL, die Ihre Cloud-ID enthalten muss (zum Beispiel https://api.atlassian.com/ex/jira/{cloud_id}).

Authentifizierung für Jira Cloud einrichten

Um sich mit Jira Cloud über ein API-Token zu verbinden, folgen Sie den Anweisungen in der Atlassian-Dokumentation, um ein Token zu generieren.

Authentifizierung für Dienstkonten einrichten

So verwenden Sie die tokenbasierte Authentifizierung (Bearer Token) für Jira Cloud:

  1. SehenServicekonten verstehen Weitere Einzelheiten zur Erstellung eines Dienstkontos mithilfe desAtlassian-Administrationskonsole Die

  2. Rufen Sie Ihre Cloud-ID ab, indem Sie zu folgender Adresse navigieren: https://<your_tenant>.atlassian.net/_edge/tenant_info (wobei <your_tenant> Ihr spezifischer Atlassian-Instanzname ist).

  3. Bei der Konfiguration der Integration lassen Sie das Feld Username leer, um die Bearer-Token-Authentifizierung auszulösen.

Integrationsparameter

Die Jira-Integration erfordert die folgenden Parameter:

Parameter Beschreibung
Api Root

Erforderlich.

Die Basis-URL der Jira-Instanz.
Username

Optional.

Der Benutzername (E-Mail-Adresse), der zur Verbindung mit Jira verwendet wird.

Die Anforderungen an diesen Parameter hängen von der gewählten Authentifizierungsmethode ab:

  • Sofern angegeben, verwendet das System die Basisauthentifizierung.
  • Wenn dieses Feld leer bleibt, verwendet das System standardmäßig die Bearer-Token-Authentifizierung (erforderlich für Dienstkonten).

Weitere Informationen zu Authentifizierungsmethoden finden Sie unter Bevor Sie beginnen.
Api Token

Erforderlich.

Die Anmeldeinformationen, die zur Verbindung mit Jira verwendet werden.

Dieses Feld akzeptiert API-Tokens, Service-Account-Tokens oder Standardpasswörter (für Data Center).
Verify SSL

Optional.

Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat beim Verbindungsaufbau zum Jira-Server.

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

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

Aktionen

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

Kommentar hinzufügen

Mit der Aktion Kommentar hinzufügen können Sie einen Kommentar verfassen und einem vorhandenen Jira-Vorgang hinzufügen.

So können Sie Ergebnisse effektiv dokumentieren, Updates bereitstellen und direkt in Google SecOps mit Teammitgliedern zusammenarbeiten.

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
Issue Key

Erforderlich.

Die eindeutige Kennung des Jira-Vorgangs (z. B. PROJ-123).
Comment

Erforderlich.

Der Text, der dem Jira-Ticket hinzugefügt werden soll.

Aktionsausgaben

Die Aktion Kommentar hinzufügen liefert die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Nicht verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Scriptergebnis

Die folgende Tabelle listet den Wert für die Skriptausgabe bei Verwendung der Aktion Kommentar hinzufügen auf:

Name des Scriptergebnisses Wert
comment_id Die eindeutige ID des neu erstellten Kommentars in Jira.

Problem zuweisen

Verwenden Sie die Aktion Problem zuweisen, um ein Jira-Problem einem bestimmten Benutzer zuzuweisen.

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

Aktionseingaben

Die Aktion Problem zuweisen erfordert die folgenden Parameter:

Parameter Beschreibung
Issue Key

Erforderlich.

Die eindeutige Kennung des Jira-Vorgangs (z. B. PROJ-123).
Assignee

Erforderlich.

Name oder E-Mail-Adresse des Benutzers, dem das Problem zugewiesen werden soll.
Jira Username

Optional.

Der Jira-Benutzername der Person, die die Zuweisungsaktion initiiert hat.

Aktionsausgaben

Die Aktion Problem zuweisen liefert folgende Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Nicht verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Scriptergebnis

Die folgende Tabelle listet den Wert für die Skriptausgabe bei Verwendung der Aktion Problem zuweisen auf:

Name des Scriptergebnisses Wert
success true oder false

Problem beim Erstellen einer Benachrichtigung

Verwenden Sie die Aktion Create Alert Issue, um in Jira ein neues Ticket für eine bestimmte Warnung zu erstellen.

Diese Aktion wird hauptsächlich innerhalb von Playbooks verwendet, um Sicherheitsvorfälle zur weiteren Untersuchung oder Behebung an IT- oder Engineering-Teams zu eskalieren.

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

Aktionseingaben

Die Aktion Create Alert Issue erfordert die folgenden Parameter:

Parameter Beschreibung
Project Key

Erforderlich.

Der eindeutige Kurzschlüssel des Jira-Projekts, in dem das Ticket erstellt wurde (z. B. SEC).
Summary

Erforderlich.

Ein kurzer Titel oder eine kurze Zusammenfassung des Themas.
Issue Type

Erforderlich.

Der Name des Ausgabetyps (z. B. Task, Bug oder Incident).

Aktionsausgaben

Die Aktion Create Alert Issue liefert die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle „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 empfangen wird, wenn die Aktion erfolgreich ein Problem erstellt:

{
   "summary": "Sample issue",
   "description": "Create Enrich entities action using Insights API (IOC search). Write connector for alerts.",
   "project": {
      "key": "PR",
      "name": "Project 1",
      "projectTypeKey": "software"
   },
   "issuetype": {
     "name": "Task",
     "subtask": false
   },
   "status": {
      "name": "DONE",
      "statusCategory": {
         "name": "Done",
         "key": "done"
      }
   },
   "priority": {
      "name": "Medium",
      "id": "3"
   },
   "creator": {
      "displayName": "user1",
      "emailAddress": "john_doe@example.com"
   },
   "assignee": {
      "displayName": "user2",
      "emailAddress": "john_doe@example.com"
   },
   "created": "2018-06-19T15:23:13.701+0300",
   "updated": "2018-09-18T10:02:06.347+0300"
}
Scriptergebnis

Die folgende Tabelle listet den Wert für die Skriptausgabe bei Verwendung der Aktion Create Alert Issue auf:

Name des Scriptergebnisses Wert
issue_key Der eindeutige Kurzschlüssel des neu erstellten Jira-Vorgangs (zum Beispiel SEC-456).

Problem erstellen

Verwenden Sie die Aktion Create Issue, um ein neues Ticket in einem Jira-Projekt zu erstellen.

Diese Aktion bietet umfangreiche Anpassungsmöglichkeiten, darunter die Möglichkeit, Komponenten, Bezeichnungen und benutzerdefinierte Felder mithilfe von JSON anzugeben, wodurch sie sich für komplexe Workflows zur Ticket-Erstellung eignet.

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

Aktionseingaben

Die Aktion Problem erstellen erfordert die folgenden Parameter:

Parameter Beschreibung
Project Key

Erforderlich.

Der eindeutige Kurzschlüssel des Jira-Projekts, in dem das Ticket erstellt wurde (z. B. SEC).
Summary

Erforderlich.

Ein kurzer Titel oder eine kurze Zusammenfassung des Themas.
Description

Optional.

Eine detaillierte Beschreibung des Problems.
Issue Type

Erforderlich.

Der Name des Ausgabetyps (z. B. Task, Bug oder Incident).
Jira Username

Optional.

Der Jira-Benutzername der Person, die die Aktion initiiert.
Assignee

Optional.

Die Kennung des Benutzers, dem das Problem zugewiesen ist.
Components

Optional.

Eine durch Kommas getrennte Liste von Jira-Komponenten, die dem Vorgang zugeordnet werden sollen.
Labels

Optional.

Eine durch Kommas getrennte Liste von Bezeichnungen, die dem Problem hinzugefügt werden sollen.
Custom Fields

Optional.

Ein JSON-Objekt, das zusätzliche Felder und Werte enthält, die während der Erstellung festgelegt werden sollen (z. B. {"customfield_10001": "Value"}).

Die in diesem Parameter angegebenen Werte haben Vorrang und überschreiben andere Feldzuordnungen im Falle eines Konflikts.

Aktionsausgaben

Die Aktion Create Issue liefert die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle „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 Create Issue empfangen wird:

{
   "summary": "Sample issue",
   "description": "Create Enrich entities action using Insights API (IOC search). Write connector for alerts. In a couple of days we will have access to an instance.",
   "project": {
      "key": "PR",
      "name": "Project 1",
      "projectTypeKey": "software"
   },
   "issuetype": {
      "name": "Task",
      "description": "A task that needs to be done.",
      "subtask": false
   },
   "status": {
      "name": "DONE",
      "statusCategory": {
         "name": "Done",
         "key": "done",
         "colorName": "green"
      }
   },
   "priority": {
      "name": "Medium",
      "id": "3"
   },
   "resolution": {
      "name": "Done",
      "description": "Work has been completed on this issue."
   },
   "creator": {
      "displayName": "user1",
      "emailAddress": "john_doe@example.com",
      "active": true,
      "timeZone": "Asia/Jerusalem"
   },
   "assignee": {
      "displayName": "user2",
      "emailAddress": "john_doe@example.com",
      "active": true
   },
   "reporter": {
      "displayName": "user1",
      "emailAddress": "john_doe@example.com"
   },
   "labels": [
      "Label1"
   ],
   "attachment": [
      {
         "id": "1001",
         "filename": "file.rar",
         "mimeType": "binary/octet-stream",
         "size": 15420,
         "created": "2018-06-19T15:23:07.369+0300"
      }
   ],
   "created": "2018-06-19T15:23:13.701+0300",
   "updated": "2018-09-18T10:02:06.347+0300",
   "resolutiondate": "2018-09-18T10:02:06.340+0300",
   "watches": {
      "watchCount": 1,
      "isWatching": false
   }
}
Scriptergebnis

Die folgende Tabelle listet den Wert für die Skriptausgabe bei Verwendung der Aktion Problem erstellen auf:

Name des Scriptergebnisses Wert
issue_key Der eindeutige Kurzschlüssel des neu erstellten Jira-Vorgangs (zum Beispiel SEC-789).

Problem löschen

Verwenden Sie die Aktion Vorgang löschen, um einen Vorgang dauerhaft aus Jira zu entfernen.

Diese Aktion wird typischerweise verwendet, um doppelte Tickets zu bereinigen oder Testdaten zu entfernen, die während der Playbook-Entwicklung entstanden sind.

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

Aktionseingaben

Die Aktion Problem löschen erfordert die folgenden Parameter:

Parameter Beschreibung
Issue Key

Erforderlich.

Der eindeutige Kurzschlüssel des zu löschenden Jira-Vorgangs (zum Beispiel SEC-123).

Aktionsausgaben

Die Aktion Problem löschen liefert folgende Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Nicht verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Scriptergebnis

Die folgende Tabelle listet den Wert für die Skriptausgabe bei Verwendung der Aktion Problem löschen auf:

Name des Scriptergebnisses Wert
success true oder false

Anhänge herunterladen

Verwenden Sie die Aktion Anhänge herunterladen, um alle Dateien abzurufen, die einem bestimmten Jira-Vorgang angehängt sind. Wenn es sich bei einem Anhang um eine .eml-Datei handelt, werden durch die Aktion auch alle in dieser E-Mail enthaltenen Dateien heruntergeladen.

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
Issue Key

Erforderlich.

Der eindeutige Kurzschlüssel des Jira-Vorgangs (zum Beispiel SEC-123).
Download Path

Optional.

Der lokale oder interne Pfad zu dem Ordner, in dem die Aktion die heruntergeladenen Anhänge speichert.

Das erforderliche Format hängt von Ihrem Bereitstellungstyp ab:

  • SaaS-Bereitstellung: Der Pfad ist intern auf der gehosteten Plattform, z. B. /attachments/.
  • Remote Agent Deployment: Der Pfad muss ein absoluter, gültiger Verzeichnispfad auf dem lokalen Rechner sein, auf dem der Remote-Agent installiert ist. Zum Beispiel C:\temp\attachments für Windows oder /var/tmp/attachments/ für Linux.
Download Attachments to the Case Wall

Optional.

Wenn diese Option ausgewählt ist, werden die Anhänge des Jira-Vorgangs direkt in die aktuelle Google SecOps-Fallwand heruntergeladen.

Für Anbauteile, die an der Gehäusewand angebracht werden, gibt es eine Größenbeschränkung. Große Dateien können möglicherweise nicht hochgeladen werden.

Standardmäßig deaktiviert.

Aktionsausgaben

Die Aktion Anhänge herunterladen bietet die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle „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-Ausgabe, die bei Verwendung der Aktion Anhänge herunterladen empfangen wird:

[
  {
    "download_path": "downloads/Security_Evidence.eml",
    "attachment_details": {
      "id": "10007",
      "filename": "Security_Evidence.eml",
      "author": {
        "displayName": "Security Analyst",
        "emailAddress": "analyst@example.com",
        "active": true,
        "timeZone": "Asia/Calcutta"
      },
      "created": "2024-05-25T20:27:09.066+0530",
      "size": 12049140,
      "mimeType": "message/rfc822"
    }
  },
  {
    "download_path": "downloads/Logs_Attachment.txt",
    "attachment_details": {
      "id": "10005",
      "filename": "Logs_Attachment.txt",
      "author": {
        "displayName": "System Admin",
        "emailAddress": "admin@example.com",
        "active": true,
        "timeZone": "Asia/Calcutta"
      },
      "created": "2024-05-16T11:48:24.141+0530",
      "size": 43,
      "mimeType": "text/plain"
    }
  }
]
Scriptergebnis

Die folgende Tabelle listet den Wert für die Skriptausgabe bei Verwendung der Aktion Anhänge herunterladen auf:

Name des Scriptergebnisses Wert
is_success true oder false

Ausgaben anfordern

Verwenden Sie die Aktion Get Issues, um die vollständigen Details für ein oder mehrere Jira-Vorgänge abzurufen.

Diese Aktion ist nützlich, um Google SecOps-Fälle mit aktuellen Ticket-Metadaten (wie Status, Bearbeiter und Priorität) anzureichern.

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

Aktionseingaben

Die Aktion Get Issues erfordert die folgenden Parameter:

Parameter Beschreibung
Issue Keys

Erforderlich.

Eine durch Kommas getrennte Liste der abzurufenden Jira-Vorgangsschlüssel (zum Beispiel SEC-123, SEC-456).

Aktionsausgaben

Die Aktion Get Issues liefert die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle „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 Get Issues empfangen wird:

{
  "issues_details_list": [
    {
      "key": "TES-65",
      "summary": "New summary",
      "description": "Detailed description of the security incident.",
      "project": {
        "key": "TES",
        "name": "test-project1",
        "projectTypeKey": "software"
      },
      "issuetype": {
        "name": "Bogue",
        "subtask": false
      },
      "status": {
        "name": "Fini",
        "statusCategory": {
          "name": "Terminé",
          "key": "done"
        }
      },
      "priority": {
        "name": "Medium",
        "id": "3"
      },
      "assignee": {
        "displayName": "Vasil Daskalov",
        "emailAddress": "vasil.daskalov@siemplify.co"
      },
      "creator": {
        "displayName": "admin@siemplifylab.local",
        "emailAddress": "admin@siemplifylab.local"
      },
      "created": "2021-08-31T12:15:22.089+0000",
      "updated": "2021-11-11T13:16:50.552+0000",
      "resolution": {
        "name": "Terminé",
        "description": "Ce ticket a été traité."
      },
      "labels": [],
      "components": []
    }
  ]
}
Scriptergebnis

Die folgende Tabelle listet den Wert für die Skriptausgabe bei Verwendung der Aktion Get Issues auf:

Name des Scriptergebnisses Wert
issues_details_list Eine Liste mit den vollständigen Metadaten der angeforderten Jira-Vorgänge.

Verwenden Sie die Aktion Link Issues, um eine Beziehung zwischen mehreren Jira-Vorgängen herzustellen.

Diese Aktion wird hauptsächlich innerhalb von Playbooks verwendet, um verwandte Sicherheitsvorfälle zu verknüpfen oder Abhängigkeiten zwischen Untersuchungstickets zu verfolgen.

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

Aktionseingaben

Die Aktion Link Issues erfordert die folgenden Parameter:

Parameter Beschreibung
Inward Issue ID

Erforderlich.

Eine durch Kommas getrennte Liste von Eingangsausgabe-IDs.

Wenn beispielsweise Relation Type auf Blocks gesetzt ist, wird in der Jira-Benutzeroberfläche die Beziehung is blocked by angezeigt.
Outward Issue IDs

Erforderlich.

Der Kurzschlüssel des ausgehenden Jira-Vorgangs.

Wenn beispielsweise Relation Type auf Blocks gesetzt ist, wird in der Jira-Benutzeroberfläche die Beziehung blocks angezeigt.
Relation Type

Erforderlich.

Die Art der Verknüpfung, die zwischen den Problemen hergestellt werden soll.

Eine Liste der verfügbaren Relationstypen erhalten Sie durch Ausführen der Aktion List Relation Types.

Der Standardwert ist Blocks.

Aktionsausgaben

Die Aktion Link Issues liefert folgende Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle „Fall-Repository“ Nicht verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Ausgabenachrichten

Die Aktion Link Issues kann die folgenden Ausgabemeldungen zurückgeben:

Ausgabemeldung Nachrichtenbeschreibung

Successfully linked issue ISSUE_ID with the following issues in Jira: ISSUE_IDS.

Action konnte die folgenden Zielvorgänge in Jira nicht finden: ISSUE_IDS.

 Die Maßnahme war erfolgreich.
Error executing action "Link Issues". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

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

Die folgende Tabelle listet den Wert für die Skriptausgabe bei Verwendung der Aktion Link Issues auf:

Name des Scriptergebnisses Wert
success true oder false

Probleme auflisten

Verwenden Sie die Aktion Auflistung von Vorgängen, um anhand bestimmter Filterkriterien eine Liste von Jira-Vorgangsschlüsseln zu suchen und abzurufen.

Diese Aktion ist nützlich, um bestehende Tickets zu identifizieren, die einem Alarmkontext entsprechen, um Duplikate zu vermeiden oder um Massenaktualisierungen innerhalb eines Playbooks durchzuführen.

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

Aktionseingaben

Die Aktion List Issues bietet die folgenden optionalen Filterparameter. Werden keine Parameter angegeben, gibt die Aktion alle für den Integrationsbenutzer zugänglichen Vorgänge zurück.

Parameter Beschreibung
Project Names

Optional.

Eine durch Kommas getrennte Liste von Projektnamen, in der gesucht werden soll.
Summary

Optional.

Sofern angegeben, filtert die Aktion die Ausgaben nach der spezifischen Zusammenfassung oder dem Titel.
Description

Optional.

Falls angegeben, filtert die Aktion die Probleme anhand des in der Beschreibung enthaltenen Textes.
Issue Types

Optional.

Eine durch Kommas getrennte Liste von Ausgabetypen (zum Beispiel Bug,Task).

Der Standardwert ist Bug.
Priorities

Optional.

Eine durch Kommas getrennte Liste von Prioritätsstufen, nach denen gefiltert werden soll (z. B. High,Medium).
Created From

Optional.

Falls angegeben, filtert die Aktion nach Vorgängen, die an oder nach diesem Datum erstellt wurden (im Format YYYY/MM/DD).
Updated From

Optional.

Falls angegeben, filtert die Aktion nach Problemen, die an oder nach diesem Datum aktualisiert wurden (im Format YYYY/MM/DD).
Assignees

Optional.

Eine durch Kommas getrennte Liste von Empfängerkennungen, nach denen gefiltert werden soll.
Reporter

Optional.

Eine durch Kommas getrennte Liste von Reporter-IDs, nach denen gefiltert werden soll.
Statuses

Optional.

Eine durch Kommas getrennte Liste der Vorgangsstatus, nach denen gefiltert werden soll (z. B. Open,In Progress).
Created Before

Optional.

Das neueste Erstellungsdatum, nach dem gefiltert werden soll. Format: YYYY/MM/DD oder relativer Offset (z. B. -24h, -7d). Wird kein Format angegeben, wird kein Filter verwendet.
Custom JQL

Optional.

Benutzerdefinierte JQL-Abfrage. Falls angegeben, werden alle anderen Filter ignoriert.

Aktionsausgaben

Die Aktion List Issues liefert die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle „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 List Issues empfangen wird:

[ 
  "PR-123", 
  "PR-124",
  "SEC-789"
]
Scriptergebnis

Die folgende Tabelle listet den Wert für die Skriptausgabe bei Verwendung der Aktion Probleme auflisten auf:

Name des Scriptergebnisses Wert
issues Eine Liste mit den eindeutigen Kurzbezeichnungen der gefundenen Jira-Vorgänge.

Listenrelationstypen

Verwenden Sie die Aktion Listenbeziehungstypen, um eine Liste aller verfügbaren Linkbeziehungstypen abzurufen, die in Ihrer Jira-Instanz konfiguriert sind.

Diese Aktion ist nützlich, um gültige Eingabewerte für die Aktion Link Issues zu überprüfen.

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

Aktionseingaben

Die Aktion Listenbeziehungstypen erfordert die folgenden Parameter:

Parameter Beschreibung
Filter Key

Optional.

Das Feld, das zum Filtern der Beziehungstypen verwendet wird.

Wenn die Filterlogik auf Equal oder Contains eingestellt ist, müssen Sie ein anderes Feld als Select One auswählen, um einen Ausführungsfehler zu vermeiden.

Folgende Werte sind möglich:

  • Name
  • Inward
  • Outward

Der Standardwert ist Select One.
Filter Logic

Optional.

Der logische Operator, angewendet auf den Filter.

Folgende Werte sind möglich:

  • Not Specified
  • Equal
  • Contains

Der Standardwert ist Not Specified.
Filter Value

Optional.

Der spezifische Zeichenkettenwert, der zum Filtern basierend auf den ausgewählten Filter Key und Filter Logic verwendet wird.

Wird kein Wert angegeben, wird der Filter auch dann nicht angewendet, wenn ein Schlüssel und eine Logik ausgewählt sind.
Max Records To Return

Optional.

Die maximale Anzahl der in den Ergebnissen zurückzugebenden Datensätze.

Der Standardwert ist 50.

Aktionsausgaben

Die Aktion Listenbeziehungstypen liefert die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle „Fall-Repository“ Verfügbar
Anreicherungstabelle Nicht verfügbar
JSON-Ergebnis Verfügbar
Ausgabenachrichten Verfügbar
Scriptergebnis Verfügbar
Tabelle „Fall-Repository“

Die Aktion Listenbeziehungstypen liefert die folgende Tabelle:

Tabellenname: Available Relation

Tabellenspalten:

  • Name
  • Einwärts
  • Auswärts
JSON-Ergebnis

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

[{
    "id": "10000",
    "name": "Blocks",
    "inward": "is blocked by",
    "outward": "blocks"
}]
Ausgabenachrichten

Die Aktion Listenbeziehungstypen kann die folgenden Ausgabemeldungen zurückgeben:

Ausgabemeldung Nachrichtenbeschreibung

Successfully found relation types for the provided criteria in Jira.

The filter was not applied, because parameter "Filter Value" has an empty value.

 Die Aktion wurde erfolgreich ausgeführt.
Error executing action "List Relation types". Reason: ERROR_REASON

Die Aktion ist fehlgeschlagen.

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

Die folgende Tabelle listet den Wert für die Skriptausgabe bei Verwendung der Aktion Listenbeziehungstypen auf:

Name des Scriptergebnisses Wert
is_success true oder false

Ping

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

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

Aktionseingaben

Keine.

Aktionsausgaben

Die Aktion Ping bietet die folgenden Ausgaben:

Ausgabetyp der Aktion Verfügbarkeit
Anhang im Fall-Repository Nicht verfügbar
Link zum Fall‑Repository Nicht verfügbar
Tabelle „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 Scriptergebnisses Wert
success true oder false

Update-Problem

Beschreibung

Ein Problem aktualisieren. Bei der neuen Jira-API versucht die Aktion, anhand der Benutzer-E-Mail einen passenden Bearbeiter für die Zuweisung eines Vorgangs zu finden und versucht es dann mit dem Feld displayName.

Parameter

Parameter Typ Standardwert Ist obligatorisch Beschreibung
Ausgabeschlüssel String – Ja Der Schlüssel zum Problem liegt in der Aktualisierung.
Status String – Nein Geben Sie den entsprechenden Übergangsnamen an, um dieses Problem in den gewünschten neuen Status zu überführen.
Zusammenfassung String – Nein Die neue Zusammenfassung des Problems.
Beschreibung String – Nein Die neue Problembeschreibung.
Art des Problems String – Nein Die neue Art des Problems.
Zuständige Person String – Nein Der neue Inhaber der Angelegenheit.
Jira-Benutzername String – Nein Der Jira-Benutzername des Aktionsinitiators.
Komponenten String – Nein

Das Komponentenfeld des Problems.

Für diesen Parameter können mehrere Werte als kommagetrennter String angegeben werden.
Benutzerdefinierte Felder JSON – Nein

Geben Sie ein JSON-Objekt an, das alle Felder und Werte enthält, die bei der Erstellung eines Vorgangs verwendet werden.

Hinweis: Dieser Parameter hat Priorität und alle Felder werden mit dem für diesen Parameter angegebenen Wert überschrieben.

Beispiel: {"field":"value"}
Labels String – Nein

Das Komponentenfeld des Problems.

Für diesen Parameter können mehrere Werte als kommagetrennter String angegeben werden.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Scriptergebnisses Wertoptionen Beispiel
Erfolgreich Wahr/falsch Erfolg:Falsch
JSON-Ergebnis
{
   "comment":
     {
       "total": 0,
       "startAt": 0,
       "comments": [],
       "maxResults": 0
      },
   "creator":
     {
       "displayName": "user1",
       "name": "user1",
       "self": "",
       "avatarUrls":
          {
            "24x24": "",
            "16x16": "",
            "48x48": "",
            "32x32": ""
           },
        "emailAddress": "john_doe@example.com",
        "key": "user1user",
        "active": true,
        "timeZone": "Asia/Jerusalem",
        "accountId": "0"
       },
   "aggregatetimeestimate": null,
   "labels": ["Label1"],
   "aggregatetimespent": null,
   "watches":
      {
        "self": "",
        "watchCount": 1,
        "isWatching": false
       },
   "assignee":
      {
        "displayName": "user2",
        "name": "user2",
        "self": "",
        "avatarUrls":
           {
              "24x24": "",
              "16x16": "",
              "48x48": "",
              "32x32": ""
            },
        "emailAddress": "john_doe@example.com",
        "key": "user2",
        "active": true,
        "timeZone": "Asia/Jerusalem",
        "accountId": ""
       },
   "lastViewed": "2019-01-22T10:14:02.910+0200",
   "issuelinks": [],
   "Worklog":
      {
        "worklogs": [],
        "total": 0,
        "startAt": 0,
        "maxResults": 20
       },
   "aggregateprogress":
      {
        "progress": 0,
        "total": 0
       },
   "Priority":
      {
        "iconUrl": "",
        "self": "",
        "name": "Medium",
        "id": "3"
       },
   "votes":
       {
          "hasVoted": false,
          "self": "",
          "votes": 0
        },
   "workratio": -1,
   "fixVersions": [],
   "environment": null,
   "timespent": null,
   "attachment":
      [{
          "mimeType": "binary/octet-stream",
          "created": "2018-06-19T15:23:07.369+0300",
          "self": "",
          "author":
             {
               "displayName": "user1",
               "name": "user1",
               "self": "",
               "avatarUrls":
                  {
                     "24x24": "",
                     "16x16": "",
                     "48x48": "",
                     "32x32": ""
                   },
               "emailAddress": "john_doe@example.com",
               "key": "user1",
               "active": true,
               "timeZone": "Asia/Jerusalem",
               "accountId": "0"
              },
           "filename": "file.rar",
           "content": "",
           "id": "0",
           "size": 0
        }],
   "progress":
        {
          "progress": 0,
          "total": 0
         },
   "duedate": null,
   "status":
        {
          "statusCategory":
              {
                 "name": "Done",
                 "self": "",
                 "id": 3,
                 "key": "done",
                 "colorName": "green"
               },
          "description": "",
          "self": "",
          "iconUrl": "",
          "id": "0",
          "name": "DONE"
         },
   "updated": "2018-09-18T10:02:06.347+0300",
   "subtasks": [],
   "description": "Create Enrich entities action using Insights API (IOC search)\\n\\nWrite connector for laerts\\n\\nIn a couple of days we will have access to an instance",
   "reporter":
         {
           "displayName": "user1",
           "name": "user1",
           "self": "",
           "avatarUrls":
               {
                 "24x24": "",
                 "16x16": "",
                 "48x48": "",
                 "32x32": ""
               },
           "emailAddress": "john_doe@example.com",
           "key": "user1",
           "active": true,
           "timeZone": "Asia/Jerusalem",
           "accountId": "0"
          },
    "timeoriginalestimate": null,
    "aggregatetimeoriginalestimate": null,
    "created": "2018-06-19T15:23:13.701+0300",
    "versions": [],
    "resolutiondate": "2018-09-18T10:02:06.340+0300",
    "summary": "Sample issue",
    "project":
          {
             "name": "Project 1",
             "self": "",
             "projectTypeKey": "software",
             "avatarUrls":
                 {
                   "24x24": "",
                   "16x16": "",
                   "48x48": "",
                   "32x32": ""
                  },
             "key": "PR",
             "id": "0"
           },
    "timetracking": {},
    "components": [],
    "issuetype":
          {
             "name": "Task",
             "self": "",
             "iconUrl": "",
             "subtask": false,
             "avatarId": 10318,
             "id": "10002",
             "description": "A task that needs to be done."
           },
    "security": null,
    "resolution":
           {
             "id": "10000",
             "self": "",
             "description": "Work has been completed on this issue.",
              "name": "Done"
             },
    "timeestimate": null
}

Anhang hochladen

Beschreibung

Füge einem Problem einen Anhang hinzu.

Parameter

Parameter Typ Standardwert Ist obligatorisch Beschreibung
Ausgabeschlüssel String – Ja Dateipfade.
Dateipfade String – Ja

Die absoluten Pfade der hochzuladenden Dateien, durch Kommas getrennt.

Das erforderliche Format hängt vom Bereitstellungstyp ab:

  • SaaS-Bereitstellung: Der Pfad ist intern auf der gehosteten Plattform, z. B. /attachments/.
  • Remote-Agent-Bereitstellung: Der Pfad muss ein absoluter, gültiger Verzeichnispfad auf dem lokalen Computer sein, auf dem der Remote-Agent installiert ist. Beispiel: C:\temp\attachments für Windows oder /var/tmp/attachments/ für Linux.

Ausführen am

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

Aktionsergebnisse

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

Nutzer suchen

Suchen Sie nach Nutzern in Jira.

Entitäten

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

Aktionseingaben

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

Parameter
User Email Addresses Optional

Eine durch Kommas getrennte Liste von E‑Mail-Adressen, für die die Nutzer zurückgegeben werden sollen.
User Names Optional

Eine durch Kommas getrennte Liste der Nutzernamen, für die die Nutzer zurückgegeben werden sollen.
Project Optional

Name des Projekts, in dem nach E-Mail-Adressen gesucht werden soll. Falls angegeben, wird nur Project Assignable Users zurückgegeben.

Aktionsausgaben

Ausgabetyp der Aktion
Anhang im Fall-Repository –
Link zum Fall‑Repository –
Tabelle „Fall-Repository“ –
Anreicherungstabelle –
JSON-Ergebnis Verfügbar
Scriptergebnis Verfügbar
Scriptergebnis
Name des Scriptergebnisses Wert
is_success Wahr/falsch
JSON-Ergebnis
[
 {
   "Entity": "example",
   "EntityResult": {
     "_resource": "user?accountId={0}",
     "_options": {
       "server": "https://siemplify.atlassian.net",
       "auth_url": "/rest/auth/1/session",
       "context_path": "/",
       "rest_path": "api",
       "rest_api_version": "2",
       "agile_rest_path": "agile",
       "agile_rest_api_version": "1.0",
       "verify": false,
       "resilient": true,
       "async": false,
       "async_workers": 5,
       "client_cert": null,
       "check_update": false,
       "delay_reload": 0,
       "headers": {
         "Cache-Control": "no-cache",
         "Content-Type": "application/json",
         "X-Atlassian-Token": "no-check"
       }
     },
     "_session": "<jira.resilientsession.ResilientSession object>",
     "_base_url": "{server}/rest/{rest_path}/{rest_api_version}/{path}",
     "raw": {
       "self": "https://siemplify.atlassian.net/rest/api/2/user?accountId=example-account-id",
       "accountId": "example-account-id",
       "accountType": "atlassian",
       "emailAddress": "example.user",
       "avatarUrls": {
         "48x48": "https://example.com"
       },
       "displayName": "Example",
       "active": true,
       "timeZone": "UTC",
       "locale": "en_US"
     },
     "self": "https://siemplify.atlassian.net/rest/api/2/user?accountId=example-account-id",
     "accountId": "example-account-id",
     "accountType": "atlassian",
     "emailAddress": "example.user",
     "avatarUrls": "<jira.resources.PropertyHolder object>",
     "displayName": "Example",
     "active": true,
     "timeZone": "UTC",
     "locale": "en_US"
   }
 }
]
Fall-Repository

Die Aktion gibt die folgenden Ausgabenachrichten aus:

Ausgabemeldung Nachrichtenbeschreibung

Successfully found the following users in Jira for project PROJECT_NAME: USER_LIST

The following users were not found in Jira for project PROJECT_NAME: USER_LIST

None of the provided users were found in the project PROJECT_NAME

 Aktion erfolgreich.
Error executing action "Search Users". Reason: ERROR_REASON

Aktion fehlgeschlagen.

Überprüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldeinformationen.

Konfiguration der Zuordnung von Schließungsgründen

Der Parameter Closed Reason Mapping erfordert eine JSON-Struktur. Sie können statische Werte zuordnen oder dynamische Jira-Feldnamen übergeben (z. B. resolution, customfield_10010). Falls ein extrahierter dynamischer Grund ungültig ist oder fehlt, verwendet der Job automatisch die angegebene Fallback-Zuordnung.

Beispiel einer JSON-Konfiguration:

{
  "Done": {
    "reason": "Maintenance",
    "root_cause": "Other"
  },
  "Fallback": {
    "reason": "Maintenance",
    "root_cause": "Other"
  }
}

Connectors

Jira Connector

Beschreibung

Vorgänge von Jira zu Google SecOps abrufen.

Jira Connector in Google SecOps konfigurieren

Eine ausführliche Anleitung zum Konfigurieren eines Connectors in Google SecOps finden Sie unter Connector konfigurieren.

Connector-Parameter

Verwenden Sie die folgenden Parameter, um den Connector zu konfigurieren:

Parameter Beschreibung
DeviceProductField

Erforderlich.

Der Feldname, der zur Bestimmung des Geräteprodukts verwendet wird.

Der Standardwert ist device_product.
EventClassId

Optional.

Der Feldname, der zur Bestimmung des Ereignisnamens (Untertyp) verwendet wird.

Der Standardwert ist name.
PythonProcessTimeout

Erforderlich.

Das Timeout-Limit (in Sekunden) für den Python-Prozess, der das aktuelle Skript ausführt.

Der Standardwert ist 60.
API Root

Erforderlich.

Der API-Root der Jira-Instanz.

Der Standardwert ist https://{jira_address}.
Username

Optional.

Der Benutzername (E-Mail-Adresse), der zur Verbindung mit Jira verwendet wird.

Die Anforderungen an diesen Parameter hängen von der gewählten Authentifizierungsmethode ab:

  • Sofern angegeben, verwendet das System die Basisauthentifizierung.
  • Wenn dieses Feld leer bleibt, verwendet das System standardmäßig die Bearer-Token-Authentifizierung (erforderlich für Dienstkonten).

Weitere Informationen zu Authentifizierungsmethoden finden Sie unter Bevor Sie beginnen.
API Token

Erforderlich.

Die Anmeldeinformationen, die zur Verbindung mit Jira verwendet werden.
Days Backwards

Optional.

Maximale Anzahl der Tage rückwirkend, aus denen Warnmeldungen abgerufen werden können.

Der Standardwert ist 5.
Max Tickets Per Cycle

Optional.

Maximale Anzahl an Tickets, die in einem Verbindungszyklus abgerufen und verarbeitet werden sollen.

Der Standardwert ist 10.
Project Names

Optional.

Projektnamen durch Komma getrennt.
Issue Statuses

Optional.

Die Statusangaben der einzelnen Vorgänge sind durch Kommas getrennt.
Assignees

Optional.

Die vollständigen Namen der Benutzer, durch Kommas getrennt.
Issue Types

Optional.

Die Problemtypen sind durch Kommas getrennt.
Issue Priorities

Optional.

Die Prioritäten der einzelnen Themen werden durch Kommas getrennt.
Issue Components

Optional.

Die einzelnen Bestandteile des Problems sind durch Kommas getrennt.
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.
Environment Field Name

Optional.

Beschreibt den Namen des Felds, in dem der Umgebungsname gespeichert ist. Wenn das Feld „Umgebung“ nicht gefunden wird, wird die Standardumgebung verwendet.

Der Standardwert ist "".
Environment Regex Pattern

Optional.

Ein regulärer Ausdruck, der auf den Wert im Feld „Name des Umgebungsfelds“ angewendet wird. Dient dazu, dem Benutzer die Manipulation des Umgebungsfelds mithilfe von regulären Ausdrücken zu ermöglichen.

Der Standardwert ist .*.
Use Jira Project as Environment

Optional.

Verwenden Sie das Jira-Projekt als Umgebung oder den Umgebungsfeldnamen als Umgebung.
Verify SSL

Erforderlich.

Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat beim Verbindungsaufbau zum Jira-Server.

Standardmäßig aktiviert.

Connector-Regeln

Proxyunterstützung

Der Connector unterstützt Proxys.

Dynamische Liste und Sperrliste

Der Konnektor unterstützt dynamische Listen- und Sperrlistenregeln nur für bestimmte Labels innerhalb von Jira.

Jobs

Synchronisierungsauftrag für Schließung

Beschreibung

Schließen Sie Tickets in Jira, wenn entsprechende Google SecOps-Warnungen oder -Fälle geschlossen wurden, und synchronisieren Sie den Schließungsstatus und die benutzerdefinierten Felder von Jira zurück zu Google SecOps.

Parameter

Parameter Beschreibung
API Root

Erforderlich.

Jira-Instanz-API-Stamm-URL.

Der Standardwert ist https://{jira_address}.
Username

Optional.

Der Benutzername (E-Mail-Adresse), der zur Verbindung mit Jira verwendet wird.

Die Anforderungen an diesen Parameter hängen von der gewählten Authentifizierungsmethode ab:

  • Sofern angegeben, verwendet das System die Basisauthentifizierung.
  • Wenn Sie dieses Feld leer lassen, verwendet das System standardmäßig die Bearer-Token-Authentifizierung (erforderlich für Dienstkonten).
API Token

Erforderlich.

Die Anmeldeinformationen, die zur Verbindung mit Jira verwendet werden.
Project Names

Erforderlich.

Jira-Projektnamen, durch Komma getrennt, die der Job überwachen soll.

Der Standardwert ist project names separated by a comma.
Environment

Optional.

Der Name der Umgebung.
Days Backwards

Erforderlich.

Maximale Anzahl an Tagen, um den Ticketstatus rückwärts zu synchronisieren.

Der Standardwert ist 1.
Job Scope

Erforderlich.

Umfang der Jobsynchronisierung. Optionen:

  • Case: Synchronisiert Jira-Vorgänge auf Fallebene. Stellen Sie sicher, dass der Kontext JIRA_ISSUE_KEY enthält.
  • Alert: Synchronisiert Jira-Vorgänge auf Alarmebene. Bei über Connectors erstellten Fällen wird der Jira-Ticketschlüssel automatisch extrahiert. Für simulierte Fälle muss der Kontextschlüssel manuell auf JIRA_ISSUE_KEY gesetzt werden.

Der Standardwert ist Alert.
Supported Closed Statuses

Erforderlich.

Durch Kommas getrennte Liste von Jira-Statusmeldungen, die in Google SecOps als abgeschlossen behandelt werden (z. B. Done, Closed).

  • SecOps zu Jira: Der Job verwendet den ersten Wert in der Liste (zum Beispiel Done) als Lösungsstatus beim Schließen des Jira-Tickets.
  • Jira zu SecOps:Der Abschlussstatus des Jira-Tickets muss in dieser Liste vorhanden sein, damit eine Synchronisierung erfolgt.

Der Standardwert ist Done.
Closed Reason Mapping

Erforderlich.

JSON-Wörterbuch, in dem Jira-Status „Geschlossen“ Google SecOps-Schließungsgründen und ‑Ursachen zugeordnet werden. Unterstützt die Zuordnung zu benutzerdefinierten Feldern und erfordert einen obligatorischen Fallback-Schlüssel. Konfigurationsdetails und Beispiele finden Sie unter Zuordnung von Schließungsgrund und benutzerdefiniertem Feld.
Custom Fields Mapping

Optional.

JSON-Objekt, das Zuordnungen zwischen Anzeigenamen von benutzerdefinierten Google SecOps-Feldern und Namen von benutzerdefinierten Jira-Feldern für die Datensynchronisierung von Jira zu Google SecOps definiert. Konfigurationsdetails und Beispiele finden Sie unter Zuordnung von Schließungsgrund und benutzerdefiniertem Feld.

Zuordnung von Grund für das Schließen und benutzerdefiniertem Feld

Verwenden Sie die folgenden Details und Beispiele, um benutzerdefinierte Zuordnungen für Schließungsgründe und benutzerdefinierte Felder zu konfigurieren.

Zuordnung von Gründen für das Schließen

Definiert, wie Jira-Schließungsstatus Google SecOps-Schließungsgründen und ‑Ursachen für Fälle oder Benachrichtigungen zugeordnet werden.

  • Beispiel für die Standard-JSON-Zuordnung:

    {
  "Done": {
    "reason": "Malicious",
    "root_cause": "Other"
  },
  "Fallback": {
    "reason": "Maintenance",
    "root_cause": "Other"
  }
}

    Wenn ein Jira-Ticket mit dem Status Done geschlossen wird, wird der Google SecOps-Vorgang oder die Benachrichtigung mit dem Grund Malicious und der Ursache Other geschlossen. Wenn das Ticket mit einem Status geschlossen wird, der nicht explizit zugeordnet ist (z. B. Closed), verwendet das System standardmäßig die Fallback-Einstellungen.

  • Beispiel für die Zuordnung benutzerdefinierter Felder:

    Wenn Sie in Jira benutzerdefinierte Felder mit den Namen Jira reason und Jira rootcause haben, konfigurieren Sie die JSON-Zuordnung so:

    {
  "Done": {
    "reason": "Jira reason",
    "root_cause": "Jira rootcause"
  },
  "Fallback": {
    "reason": "Maintenance",
    "root_cause": "Other"
  }
}

    Voraussetzungen:

    • Der aus dem benutzerdefinierten Feld Jira reason extrahierte Wert muss in einen der folgenden genauen Strings aufgelöst werden: Malicious, Maintenance, Inconclusive oder Not malicious. Andernfalls greift das System auf die Fallback-Werte zurück.
    • Für den Jobbereich Case müssen Werte für die Ursache in den Administratoreinstellungen konfiguriert werden. Für den Jobbereich Alert ist keine Administratorkonfiguration erforderlich und jeder im benutzerdefinierten Feld angegebene Wert wird akzeptiert.

Zuordnung benutzerdefinierter Felder

Diese Zuordnung dient ausschließlich dazu, benutzerdefinierte Feldwerte aus Jira mit Google SecOps zu synchronisieren. Geben Sie Schlüssel/Wert-Paare an, wobei der Schlüssel der Anzeigename des benutzerdefinierten Google SecOps-Felds und der Wert der Name des benutzerdefinierten Jira-Felds ist:

{
  "SOAR Custom field": "Jira ticket id"
}

In diesem Beispiel wird der Wert aus dem Jira-Feld Jira ticket id direkt mit dem Google SecOps-Feld SOAR Custom field synchronisiert.

Synchronisierungsauftrag für Kommentare

Beschreibung

Kommentare zwischen dem Google SecOps-Fall und dem entsprechenden Jira-Vorgang synchronisieren. Die Synchronisierung erfolgt in beide Richtungen, also von Google SecOps zu Jira und von Jira zu Google SecOps.

Wenn durch den Job ein Kommentar erstellt wird, wird das Präfix angewendet. Wenn ein Google SecOps-Nutzer einen Kommentar im Google SecOps-Fall hinterlässt, wird mit dem Job der Nutzerkommentar im entsprechenden Jira-Vorgang erstellt und synchronisiert. Dabei wird der Parameter Chronicle Comment Prefix verwendet.

Diese Funktion wurde aus zwei Gründen hinzugefügt:

  1. Sichtbarkeit.
  2. Verhindern Sie, dass Kommentare, die vom Job hinzugefügt wurden, noch einmal mit der anderen Seite synchronisiert werden und eine Schleife verursachen.

Parameter

Parameter Beschreibung
API Root

Erforderlich.

Jira-Instanz-API-Stamm-URL.

Der Standardwert ist https://{jira_address}.
Username

Optional.

Der Benutzername (E-Mail-Adresse), der zur Verbindung mit Jira verwendet wird.

Die Anforderungen an diesen Parameter hängen von der gewählten Authentifizierungsmethode ab:

  • Sofern angegeben, verwendet das System die Basisauthentifizierung.
  • Wenn Sie dieses Feld leer lassen, verwendet das System standardmäßig die Bearer-Token-Authentifizierung (erforderlich für Dienstkonten).
API Token

Erforderlich.

Die Anmeldeinformationen, die zur Verbindung mit Jira verwendet werden.
Project Names

Erforderlich.

Durch Kommas getrennte Namen von Jira-Projekten, die vom Job überwacht werden sollen.

Der Standardwert ist project names separated by comma.
Environment

Optional.

Der Name der Umgebung.
Siemplify Comment Prefix

Erforderlich.

Präfix, das vom Synchronisierungsjob zu Kommentaren hinzugefügt wird, die für Jira-Vorgänge erstellt wurden.

Der Standardwert ist Google SecOps:.
Jira Comment Prefix

Erforderlich.

Präfix, das vom Synchronisierungsauftrag zu den Kommentaren des Google SecOps-Alarmfalls hinzugefügt wird.

Der Standardwert ist Jira Comment Sync Job:.

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