Jira in Google SecOps einbinden

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

Anwendungsfälle

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

  • Automatisierte Ticketerstellung: Mit dem Jira-Connector können Sie automatisch Jira-Tickets aus Google SecOps-Benachrichtigungen erstellen, um die Übergabe zwischen Sicherheits- und IT-Teams zu optimieren.

  • Bidirektionale Synchronisierung: Sorgen Sie für Konsistenz auf allen Plattformen, indem Sie Kommentare und Statusänderungen zwischen Jira-Tickets und Google SecOps-Fällen mithilfe dedizierter Synchronisierungsjobs automatisch synchronisieren.

  • Anreicherung von Vorfällen: Hängen Sie Nachweise, Logs und Screenshots direkt an Jira-Probleme an. Verwenden Sie dazu die Aktion Anhang hochladen, um den Behebern den vollständigen Kontext bereitzustellen.

  • Dynamische Aufgabenverwaltung: Sie können zugehörige Jira-Probleme direkt im Google SecOps-Playbook aktualisieren, zuweisen oder verknüpfen, um Standardarbeitsanweisungen (SOPs) zu automatisieren.

Hinweis

Bevor Sie die Jira-Integration in der Google SecOps-Plattform konfigurieren, müssen Sie Folgendes tun:

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

  • Authentifizierungsmethode: Wählen Sie eine Authentifizierungsmethode aus.

    • Standardauthentifizierung (Jira Cloud): Erfordert einen Nutzernamen (E-Mail-Adresse) und ein Atlassian API-Token.
    • Dienstkonto-Authentifizierung (Jira Cloud): Erfordert ein Dienstkonto-Token und Ihre Cloud-ID.
    • Standardauthentifizierung (Jira Rechenzentrum): Erfordert einen gültigen Nutzernamen und ein gültiges Passwort.

  • API-Stamm-URL: Das Format der API-Stamm-URL hängt von Ihrer Authentifizierungsmethode ab.

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

Authentifizierung für Jira Cloud einrichten

Wenn Sie über ein API-Token eine Verbindung zu Jira Cloud herstellen möchten, folgen Sie der Anleitung in der Atlassian-Dokumentation, um ein Token zu generieren.

Authentifizierung für Dienstkonten einrichten

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

  1. Weitere Informationen zum Erstellen eines Dienstkontos mit der Atlassian-Admin-Konsole finden Sie unter Dienstkonten verstehen.

  2. Rufen Sie Ihre Cloud-ID ab, indem Sie zu https://<your_tenant>.atlassian.net/_edge/tenant_info gehen (wobei <your_tenant> der Name Ihrer spezifischen Atlassian-Instanz ist).

  3. Lassen Sie beim Konfigurieren der Integration das Feld Nutzername leer, um die Inhabertoken-Authentifizierung auszulösen.

Integrationsparameter

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

Parameter Beschreibung
Api Root

Pflichtangabe.

Die Basis-URL der Jira-Instanz.
Username

Optional.

Der Nutzername (E‑Mail-Adresse) für die Verbindung mit Jira.

Die Anforderung für diesen Parameter hängt von der ausgewählten Authentifizierungsmethode ab:

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

Weitere Informationen zu Authentifizierungsmethoden finden Sie unter Vorbereitung.
Api Token

Pflichtangabe.

Die Authentifizierungsdaten, die für die Verbindung mit Jira verwendet werden.

In diesem Feld können API-Tokens, Dienstkonto-Tokens oder Standardpasswörter (für Rechenzentrum) eingegeben werden.
Verify SSL

Optional.

Wenn diese Option ausgewählt ist, wird das SSL-Zertifikat bei der Verbindung mit dem Jira-Server validiert.

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

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

Aktionen

Weitere Informationen zu Aktionen finden Sie unter Auf ausstehende Aktionen im Workdesk reagieren und Manuelle Aktion in einem Fall ausführen.

Kommentar hinzufügen

Verwenden Sie die Aktion Kommentar hinzufügen, um einen Kommentar zu verfassen und einem vorhandenen Jira-Problem hinzuzufügen.

So können Sie Ergebnisse 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

Pflichtangabe.

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

Pflichtangabe.

Der Text, der dem Jira-Ticket 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 ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Kommentar hinzufügen verwendet wird:

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

Problem zuweisen

Mit der Aktion Assign Issue (Problem zuweisen) können Sie ein Jira-Problem einem bestimmten Nutzer zuweisen.

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

Aktionseingaben

Für die Aktion Assign Issue sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Issue Key

Pflichtangabe.

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

Pflichtangabe.

Der Name oder die E‑Mail-Adresse des Nutzers, dem das Problem zugewiesen werden soll.
Jira Username

Optional.

Der Jira-Nutzername der Person, die die Zuweisungsaktion initiiert.

Aktionsausgaben

Die Aktion Assign Issue 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 Assign Issue verwendet wird:

Name des Skriptergebnisses Wert
success true oder false

Benachrichtigungsproblem erstellen

Mit der Aktion Benachrichtigungsproblem erstellen können Sie in Jira ein neues Ticket für eine bestimmte Benachrichtigung erstellen.

Diese Aktion wird hauptsächlich in 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

Für die Aktion Create Alert Issue sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Project Key

Pflichtangabe.

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

Pflichtangabe.

Ein kurzer Titel oder eine Zusammenfassung des Problems.
Issue Type

Pflichtangabe.

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

Aktionsausgaben

Die Aktion Benachrichtigungsproblem 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 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

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

Name des Skriptergebnisses Wert
issue_key Der eindeutige Kurzschlüssel des neu erstellten Jira-Vorgangs (z. B. SEC-456).

Problem erstellen

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

Diese Aktion bietet umfangreiche Anpassungsoptionen, einschließlich der Möglichkeit, Komponenten, Labels und benutzerdefinierte Felder mithilfe von JSON anzugeben. Sie eignet sich daher für komplexe Workflows zur Ticketerstellung.

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

Aktionseingaben

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

Parameter Beschreibung
Project Key

Pflichtangabe.

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

Pflichtangabe.

Ein kurzer Titel oder eine Zusammenfassung des Problems.
Description

Optional.

Eine ausführliche Beschreibung des Problems
Issue Type

Pflichtangabe.

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

Optional.

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

Optional.

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

Optional.

Eine durch Kommas getrennte Liste von Jira-Komponenten, die mit dem Problem verknüpft werden sollen.
Labels

Optional.

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

Optional.

Ein JSON-Objekt mit zusätzlichen Feldern und Werten, 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, wenn ein Konflikt auftritt.

Aktionsausgaben

Die Aktion Problem 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 bei Verwendung der Aktion Problem erstellen 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

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

Name des Skriptergebnisses Wert
issue_key Der eindeutige Kurzschlüssel des neu erstellten Jira-Vorgangs (z. B. SEC-789).

Problem löschen

Verwenden Sie die Aktion Problem löschen, um ein Problem endgültig aus Jira zu entfernen.

Diese Aktion wird normalerweise verwendet, um doppelte Tickets zu bereinigen oder Testdaten zu entfernen, die während der Playbook-Entwicklung generiert wurden.

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

Aktionseingaben

Für die Aktion Problem löschen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Issue Key

Pflichtangabe.

Der eindeutige Kurzschlüssel des zu löschenden Jira-Tickets (z. B. SEC-123).

Aktionsausgaben

Die Aktion Problem löschen 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 Problem löschen verwendet wird:

Name des Skriptergebnisses Wert
success true oder false

Anhänge herunterladen

Verwenden Sie die Aktion Anhänge herunterladen, um alle Dateien abzurufen, die an ein bestimmtes Jira-Problem angehängt sind. Wenn ein Anhang eine .eml-Datei ist, werden mit der 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

Pflichtangabe.

Der eindeutige Kurzschlüssel des Jira-Tickets (z. B. SEC-123).
Download Path

Optional.

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

Das erforderliche Format hängt vom Bereitstellungstyp ab:

  • SaaS-Bereitstellung: Der Pfad ist intern für die gehostete 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.
Download Attachments to the Case Wall

Optional.

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

Für Anhänge, die dem Fall-Repository hinzugefügt werden, gilt eine Größenbeschränkung. Das Hochladen großer Dateien kann fehlschlagen.

Standardmäßig deaktiviert.

Aktionsausgaben

Die Aktion Anhänge herunterladen liefert die folgenden Ausgaben:

Aktionsausgabetyp Verfügbarkeit
Anhang im Fall-Repository 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:

[
  {
    "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

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

Probleme abrufen

Verwenden Sie die Aktion Probleme abrufen, um vollständige Details zu einem oder mehreren Jira-Problemen abzurufen.

Diese Aktion ist nützlich, um Google SecOps-Fälle mit aktuellen Ticketmetadaten (z. B. Status, zugewiesene Person und Priorität) anzureichern.

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

Aktionseingaben

Für die Aktion Get Issues sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Issue Keys

Pflichtangabe.

Eine durch Kommas getrennte Liste von Jira-Problemschlüsseln, die abgerufen werden sollen (z. B. SEC-123, SEC-456).

Aktionsausgaben

Die Aktion Probleme 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 Probleme abrufen erhalten:

{
  "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

In der folgenden Tabelle sind die Werte für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Probleme abrufen aufgeführt:

Name des Skriptergebnisses Wert
issues_details_list Eine Liste mit den vollständigen Metadaten für die angeforderten Jira-Probleme.

Verwenden Sie die Aktion Probleme verknüpfen, um eine Beziehung zwischen mehreren Jira-Problemen herzustellen.

Diese Aktion wird hauptsächlich in Playbooks verwendet, um zusammenhängende 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

Für die Aktion Probleme verknüpfen sind die folgenden Parameter erforderlich:

Parameter Beschreibung
Inward Issue ID

Pflichtangabe.

Eine durch Kommas getrennte Liste von IDs für eingehende Probleme.

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

Pflichtangabe.

Der Kurzschlüssel des ausgehenden Jira-Tickets.

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

Pflichtangabe.

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

Eine Liste der verfügbaren Beziehungstypen finden Sie, wenn Sie die Aktion Beziehungstypen auflisten ausführen.

Der Standardwert ist Blocks.

Aktionsausgaben

Die Aktion Probleme verknüpfen 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
Ausgabenachrichten

Die Aktion Probleme verknüpfen kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

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

Die Aktion konnte die folgenden Zielprobleme in Jira nicht finden: ISSUE_IDS.

 Die Aktion war erfolgreich.
Error executing action "Link Issues". 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 Probleme verknüpfen verwendet wird:

Name des Skriptergebnisses Wert
success true oder false

Probleme auflisten

Verwenden Sie die Aktion Probleme auflisten, um anhand bestimmter Filterkriterien nach einer Liste von Jira-Problemschlüsseln zu suchen und diese abzurufen.

Diese Aktion ist nützlich, um vorhandene Tickets zu identifizieren, die einem Benachrichtigungskontext entsprechen, um Duplikate zu vermeiden oder Bulk-Updates in einem Playbook durchzuführen.

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

Aktionseingaben

Die Aktion Probleme auflisten bietet die folgenden optionalen Filterparameter. Wenn keine Parameter angegeben werden, gibt die Aktion alle Probleme zurück, auf die der Integrationsnutzer zugreifen kann.

Parameter Beschreibung
Project Names

Optional.

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

Optional.

Falls angegeben, werden die Probleme durch die Aktion nach der spezifischen Zusammenfassung oder dem Titel gefiltert.
Description

Optional.

Wenn angegeben, filtert die Aktion Probleme nach dem in der Beschreibung enthaltenen Text.
Issue Types

Optional.

Eine durch Kommas getrennte Liste von Problemtypen (z. B. 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 Problemen, die am oder nach diesem Datum erstellt wurden (im Format YYYY/MM/DD).
Updated From

Optional.

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

Optional.

Eine durch Kommas getrennte Liste von Kennungen der zugewiesenen Personen, nach denen gefiltert werden soll.
Reporter

Optional.

Eine durch Kommas getrennte Liste von Melderkennungen, nach denen gefiltert werden soll.
Statuses

Optional.

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

Optional.

Das späteste Erstellungsdatum, nach dem gefiltert werden soll. Format: YYYY/MM/DD oder relativer Versatz (z. B. -24h, -7d). Wenn nicht angegeben, wird der Filter nicht verwendet.
Custom JQL

Optional.

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

Aktionsausgaben

Die Aktion Probleme 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 Probleme auflisten empfangen wird:

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

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

Name des Skriptergebnisses Wert
issues Eine Liste mit den eindeutigen Kurzschlüsseln der gefundenen Jira-Probleme.

Beziehungstypen auflisten

Verwenden Sie die Aktion Beziehungstypen auflisten, 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 Probleme verknüpfen zu validieren.

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

Aktionseingaben

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

Parameter Beschreibung
Filter Key

Optional.

Das Feld, das zum Filtern der Beziehungstypen verwendet wird.

Wenn die Filterlogik auf Equal oder Contains festgelegt 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, der auf den Filter angewendet wird.

Folgende Werte sind möglich:

  • Not Specified
  • Equal
  • Contains

Der Standardwert ist Not Specified.
Filter Value

Optional.

Der spezifische Stringwert, der für die Filterung basierend auf den ausgewählten Filter Key und Filter Logic verwendet wird.

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

Optional.

Die maximale Anzahl von Datensätzen, die in den Ergebnissen zurückgegeben werden soll.

Der Standardwert ist 50.

Aktionsausgaben

Die Aktion Beziehungstypen 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 Beziehungstypen auflisten stellt die folgende Tabelle bereit:

Tabellenname: Available Relation

Tabellenspalten:

  • Name
  • Nach innen
  • Nach außen
JSON-Ergebnis

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

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

Die Aktion Beziehungstypen auflisten kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung Beschreibung der Nachricht

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 war erfolgreich.
Error executing action "List Relation types". 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 Beziehungstypen auflisten verwendet wird:

Name des Skriptergebnisses 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 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
success true oder false

Problem aktualisieren

Beschreibung

Problem aktualisieren Bei der neuen Jira API versucht die Aktion, eine Übereinstimmung für den Rechtsnachfolger zu finden, um ein Problem basierend auf der E-Mail-Adresse des Nutzers zuzuweisen. Anschließend wird das Feld „displayName“ verwendet.

Parameter

Parameter Typ Standardwert Ist obligatorisch Beschreibung
Problem-ID String – Ja Der Schlüssel des Problems, das aktualisiert werden soll.
Status String – Nein Geben Sie den relevanten Übergangsnamen an, um dieses Problem in den neuen gewünschten Status zu überführen.
Zusammenfassung String – Nein Die neue Zusammenfassung des Problems.
Beschreibung String – Nein Die neue Beschreibung des Problems.
Art des Problems String – Nein Der neue Typ des Problems.
Zuständige Person String – Nein Die neue zuständige Person für das Problem.
Jira-Nutzername String – Nein Der Jira-Nutzername des Initiators der Aktion.
Komponenten String – Nein

Das Feld „Komponenten“ des Problems.

Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String.
Benutzerdefinierte Felder JSON – Nein

Geben Sie ein JSON-Objekt an, das alle Felder und Werte enthält, die beim Erstellen des Problems 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 Feld „Komponenten“ des Problems.

Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String.

Ausführen am

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

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
Erfolgreich Wahr/falsch Success:False
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ügen Sie einem Problem einen Anhang hinzu.

Parameter

Parameter Typ Standardwert Ist obligatorisch Beschreibung
Problem-ID 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 für die gehostete 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 Entitäten ausgeführt.

Aktionsergebnisse

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

Nutzer suchen

Suchen Sie in Jira nach Nutzern.

Entitäten

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

Aktionseingaben

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

Parameter
User Email Addresses Optional

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

Durch Kommas getrennte Liste von Nutzernamen, für die die Nutzer zurückgegeben werden sollen.
Project Optional

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

Aktionsausgaben

Aktionsausgabetyp
Anhang im Fall-Repository –
Link zum Fall-Repository –
Tabelle mit Fall-Repository –
Anreicherungstabelle –
JSON-Ergebnis Verfügbar
Scriptergebnis Verfügbar
Scriptergebnis
Name des Skriptergebnisses 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 liefert die folgenden Ausgabenachrichten:

Ausgabemeldung Beschreibung der Nachricht

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.

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

Konfiguration der Zuordnung von Schließgrü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). Wenn ein extrahierter dynamischer Grund ungültig ist oder fehlt, verwendet der Job automatisch die angegebene Fallback-Zuordnung.

Beispiel für eine JSON-Konfiguration:

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

Connectors

Jira-Connector

Beschreibung

Probleme aus Jira in Google SecOps abrufen.

Jira-Connector in Google SecOps konfigurieren

Eine detaillierte 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

Pflichtangabe.

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

Pflichtangabe.

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

Der Standardwert ist 60.
API Root

Pflichtangabe.

Der API-Stamm der Jira-Instanz.

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

Optional.

Der Nutzername (E‑Mail-Adresse) für die Verbindung mit Jira.

Die Anforderung für diesen Parameter hängt von der ausgewählten Authentifizierungsmethode ab:

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

Weitere Informationen zu Authentifizierungsmethoden finden Sie unter Vorbereitung.
API Token

Pflichtangabe.

Die Authentifizierungsdaten, die für die Verbindung mit Jira verwendet werden.
Days Backwards

Optional.

Maximale Anzahl von Tagen, für die Benachrichtigungen abgerufen werden sollen.

Der Standardwert ist 5.
Max Tickets Per Cycle

Optional.

Maximale Anzahl von Tickets, die in einem Connector-Zyklus abgerufen und verarbeitet werden sollen.

Der Standardwert ist 10.
Project Names

Optional.

Projektnamen, durch Kommas getrennt.
Issue Statuses

Optional.

Status der Probleme, durch Kommas getrennt.
Assignees

Optional.

Vollständige Namen der Nutzer, durch Kommas getrennt.
Issue Types

Optional.

Problemtypen, durch Kommas getrennt.
Issue Priorities

Optional.

Problem-Prioritäten, durch Kommas getrennt.
Issue Components

Optional.

Problemkomponenten, 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 „environment“ nicht gefunden wird, ist die Umgebung die Standardumgebung.

Der Standardwert ist "".
Environment Regex Pattern

Optional.

Ein Regex-Muster, das für den Wert im Feld „Name des Umgebungsfelds“ ausgeführt werden soll. Wird verwendet, um dem Nutzer die Bearbeitung des Umgebungsfelds mithilfe von Regex-Logik zu ermöglichen.

Der Standardwert ist .*.
Use Jira Project as Environment

Optional.

Verwenden Sie das Jira-Projekt als Umgebung oder den Namen des Umgebungsfelds als Umgebung.
Verify SSL

Pflichtangabe.

Wenn diese Option ausgewählt ist, wird das SSL-Zertifikat bei der Verbindung mit dem Jira-Server validiert.

Standardmäßig aktiviert.

Connector-Regeln

Proxyunterstützung

Der Connector unterstützt Proxys.

Dynamische Liste und Sperrliste

Der Connector unterstützt dynamische Zulassungs- und Sperrlistenregeln nur für bestimmte Labels in Jira.

Jobs

Synchronisierungsauftrag für Schließungen

Beschreibung

Tickets in Jira schließen, wenn entsprechende Google SecOps-Warnungen oder ‑Fälle geschlossen wurden, und den Schließungsstatus und benutzerdefinierte Felder von Jira mit Google SecOps synchronisieren.

Parameter

Parameter Beschreibung
API Root

Pflichtangabe.

API-Stamm-URL der Jira-Instanz.

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

Optional.

Der Nutzername (E‑Mail-Adresse) für die Verbindung mit Jira.

Die Anforderung für diesen Parameter hängt von der ausgewählten Authentifizierungsmethode ab:

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

Pflichtangabe.

Die Authentifizierungsdaten, die für die Verbindung mit Jira verwendet werden.
Project Names

Pflichtangabe.

Durch Kommas getrennte Jira-Projektnamen, die vom Job überwacht werden sollen.

Der Standardwert ist project names separated by a comma.
Environment

Optional.

Der Name der Umgebung.
Days Backwards

Pflichtangabe.

Maximale Anzahl von Tagen, für die der Ticketstatus rückwirkend synchronisiert werden soll.

Der Standardwert ist 1.
Job Scope

Pflichtangabe.

Bereich für die Jobsynchronisierung. Optionen:

  • Case: Synchronisiert Jira-Probleme auf Fallebene. Der Kontext muss die JIRA_ISSUE_KEY enthalten.
  • Alert: Synchronisiert Jira-Vorgänge auf Warnungsebene. Bei vom Connector erstellten Fällen wird der Jira-Ticketschlüssel automatisch extrahiert. Lege den Kontextschlüssel für simulierte Fälle manuell auf JIRA_ISSUE_KEY fest.

Der Standardwert ist Alert.
Supported Closed Statuses

Pflichtangabe.

Durch Kommas getrennte Liste der geschlossenen Jira-Status, die in Google SecOps als geschlossen behandelt werden (z. B. Done, Closed).

  • SecOps zu Jira: Der Job verwendet den ersten Wert in der Liste (z. B. Done) als Lösungsstatus, wenn das Jira-Ticket geschlossen wird.
  • Jira zu SecOps: Der Abschlussstatus des Jira-Tickets muss in dieser Liste enthalten sein, damit die Synchronisierung erfolgen kann.

Der Standardwert ist Done.
Closed Reason Mapping

Pflichtangabe.

JSON-Wörterbuch, das geschlossene Jira-Status den Google SecOps-Schließungsgründen und -Ursachen zuordnet. Unterstützt die Zuordnung zu benutzerdefinierten Feldern und erfordert einen obligatorischen Fallback-Schlüssel. Weitere Informationen zur Konfiguration und Beispiele finden Sie unter Grund für Schließung und Zuordnung benutzerdefinierter Felder.
Custom Fields Mapping

Optional.

JSON-Objekt, das Zuordnungen zwischen den Anzeigenamen benutzerdefinierter Felder in Google SecOps und den Namen benutzerdefinierter Felder in Jira für die Datensynchronisierung von Jira zu Google SecOps definiert. Weitere Informationen zur Konfiguration und Beispiele finden Sie unter Grund für Schließung und Zuordnung benutzerdefinierter Felder.

Zuordnung von Schließungsgrund und benutzerdefiniertem Feld

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

Zuordnung von Schließungsgründen

Definiert, wie Jira-Schließungsstatus den Schließungsgründen und Ursachen von Google SecOps-Fällen oder ‑Benachrichtigungen zugeordnet werden.

  • Beispiel für 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-Fall oder die Google SecOps-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 Einstellungen für Fallback.

  • 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 genau einem der folgenden Strings entsprechen: Malicious, Maintenance, Inconclusive oder Not malicious. Andernfalls werden die Fallback-Werte wiederhergestellt.
    • Für den Jobbereich Case müssen die 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 der Synchronisierung von benutzerdefinierten Feldwerten von Jira mit Google SecOps. 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.

Job zum Synchronisieren von Kommentaren

Beschreibung

Kommentare zwischen dem Google SecOps-Fall und dem entsprechenden Jira-Ticket synchronisieren. Die Synchronisierung erfolgt bidirektional, d. h. von Google SecOps zu Jira und von Jira zu Google SecOps.

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

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

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

Parameter

Parameter Beschreibung
API Root

Pflichtangabe.

API-Stamm-URL der Jira-Instanz.

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

Optional.

Der Nutzername (E‑Mail-Adresse) für die Verbindung mit Jira.

Die Anforderung für diesen Parameter hängt von der ausgewählten Authentifizierungsmethode ab:

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

Pflichtangabe.

Die Authentifizierungsdaten, die für die Verbindung mit Jira verwendet werden.
Project Names

Pflichtangabe.

Durch Kommas getrennte Jira-Projektnamen, die vom Job überwacht werden sollen.

Der Standardwert ist project names separated by comma.
Environment

Optional.

Der Name der Umgebung.
Siemplify Comment Prefix

Pflichtangabe.

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

Der Standardwert ist Google SecOps:.
Jira Comment Prefix

Pflichtangabe.

Präfix, das vom Synchronisierungsjob den Kommentaren zu Google SecOps-Benachrichtigungsfällen hinzugefügt wird.

Der Standardwert ist Jira Comment Sync Job:.

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