Integra Jira con Google SecOps

Questo documento spiega come integrare Jira con Google Security Operations.

Casi d'uso

L'integrazione di Jira utilizza le funzionalità di Google SecOps per supportare i seguenti casi d'uso:

  • Creazione automatica dei ticket: crea automaticamente i problemi di Jira dagli avvisi di Google SecOps utilizzando il connettore Jira per semplificare il passaggio di consegne tra i team di sicurezza e IT.

  • Sincronizzazione bidirezionale: mantieni la coerenza tra le piattaforme sincronizzando automaticamente i commenti e le modifiche di stato tra i ticket Jira e i casi Google SecOps utilizzando job di sincronizzazione dedicati.

  • Arricchimento degli incidenti: allega prove, log e screenshot direttamente ai problemi di Jira utilizzando l'azione Carica allegato per fornire un contesto completo ai responsabili della correzione.

  • Gestione dinamica delle attività: aggiorna, assegna o collega i problemi Jira correlati direttamente dal playbook di Google SecOps per automatizzare le procedure operative standard (SOP).

Prima di iniziare

Prima di configurare l'integrazione di Jira nella piattaforma Google SecOps, verifica di disporre di quanto segue:

  • Compatibilità del prodotto: accesso a un'istanza Jira Cloud o a un ambiente Jira Data Center (on-prem).

  • Metodo di autenticazione: scegli un metodo di autenticazione.

    • Autenticazione di base (Jira Cloud): richiede un nome utente (indirizzo email) e un token API Atlassian.
    • Autenticazione del service account (Jira Cloud): richiede un token del service account e il tuo ID Cloud.
    • Autenticazione standard (Jira Data Center): richiede un nome utente e una password validi.

  • URL di base dell'API: il formato dell'URL di base dell'API dipende dal metodo di autenticazione.

    • Standard/Basic: l'URL di base dell'istanza Jira (ad esempio, https://yourdomain.atlassian.net).
    • Service account: l'URL proxy API Atlassian, che deve includere il tuo ID cloud (ad esempio https://api.atlassian.com/ex/jira/{cloud_id}).

Configura l'autenticazione per Jira Cloud

Per connetterti a Jira Cloud utilizzando un token API, segui le istruzioni riportate nella documentazione di Atlassian per generare un token.

Configura l'autenticazione per i service account

Per utilizzare l'autenticazione basata su token (token di connessione) per Jira Cloud:

  1. Per ulteriori dettagli sulla creazione di un account di servizio utilizzando la console di amministrazione Atlassian, consulta Informazioni sui service account.

  2. Recupera il tuo ID Cloud andando su: https://<your_tenant>.atlassian.net/_edge/tenant_info (dove <your_tenant> è il nome della tua istanza Atlassian specifica).

  3. Durante la configurazione dell'integrazione, lascia vuoto il campo Nome utente per attivare l'autenticazione con token di connessione.

Parametri di integrazione

L'integrazione di Jira richiede i seguenti parametri:

Parametro Descrizione
Api Root

Obbligatorio.

L'URL di base dell'istanza Jira.
Username

Facoltativo.

Il nome utente (indirizzo email) utilizzato per connettersi a Jira.

Il requisito per questo parametro dipende dal metodo di autenticazione scelto:

  • Se fornito, il sistema utilizza l'autenticazione di base.
  • Se il campo viene lasciato vuoto, il sistema utilizza l'autenticazione con token di connessione per impostazione predefinita di sistema (obbligatoria per i service account).

Per saperne di più sui metodi di autenticazione, consulta Prima di iniziare.
Api Token

Obbligatorio.

La credenziale di autenticazione utilizzata per connettersi a Jira.

Questo campo accetta token API, token di account di servizio o password standard (per Data Center).
Verify SSL

Facoltativo.

Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server Jira.

Per istruzioni su come configurare un'integrazione in Google SecOps, consulta Configura le integrazioni.

Se necessario, puoi apportare modifiche in un secondo momento. Dopo aver configurato un'istanza di integrazione, puoi utilizzarla nei playbook. Per saperne di più su come configurare e supportare più istanze, consulta Supporto di più istanze.

Azioni

Per saperne di più sulle azioni, consulta Rispondi alle azioni in attesa dalla scrivania di lavoro ed Esegui un'azione manuale nel tuo caso.

Aggiungi commento

Utilizza l'azione Aggiungi commento per scrivere e aggiungere un commento a un problema Jira esistente.

Questo è un modo efficace per documentare i risultati, fornire aggiornamenti e collaborare con i membri del team direttamente da Google SecOps.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Aggiungi commento richiede i seguenti parametri:

Parametro Descrizione
Issue Key

Obbligatorio.

L'identificatore univoco del problema Jira (ad esempio, PROJ-123).
Comment

Obbligatorio.

Il testo da aggiungere al problema di Jira.

Output azione

L'azione Aggiungi commento fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Aggiungi commento:

Nome del risultato dello script Valore
comment_id L'ID univoco del commento appena creato in Jira.

Assegna problema

Utilizza l'azione Assegna problema per assegnare un problema di Jira a un utente specifico.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Assegna problema richiede i seguenti parametri:

Parametro Descrizione
Issue Key

Obbligatorio.

L'identificatore univoco del problema Jira (ad esempio, PROJ-123).
Assignee

Obbligatorio.

Il nome o l'indirizzo email dell'utente a cui assegnare il problema.
Jira Username

Facoltativo.

Il nome utente Jira della persona che avvia l'azione di assegnazione.

Output azione

L'azione Assegna problema fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Assegna problema:

Nome del risultato dello script Valore
success true o false

Crea un problema di avviso

Utilizza l'azione Crea problema di avviso per creare un nuovo ticket in Jira per un avviso specifico.

Questa azione viene utilizzata principalmente all'interno dei playbook per l'escalation degli incidenti di sicurezza ai team IT o di ingegneria per ulteriori indagini o azioni correttive.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Crea problema di avviso richiede i seguenti parametri:

Parametro Descrizione
Project Key

Obbligatorio.

La chiave abbreviata univoca del progetto Jira in cui viene creato il problema (ad esempio SEC).
Summary

Obbligatorio.

Un breve titolo o un riepilogo del problema.
Issue Type

Obbligatorio.

Il nome del tipo di problema (ad esempio Task, Bug o Incident).

Output azione

L'azione Crea problema di avviso fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando l'azione crea correttamente un problema:

{
   "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"
}
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Crea problema di avviso:

Nome del risultato dello script Valore
issue_key La chiave abbreviata univoca del problema Jira appena creato (ad esempio, SEC-456).

Crea un problema

Utilizza l'azione Crea problema per creare un nuovo ticket in un progetto Jira.

Questa azione offre ampie opzioni di personalizzazione, tra cui la possibilità di specificare componenti, etichette e campi personalizzati utilizzando JSON, il che la rende adatta a workflow di creazione di ticket complessi.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Crea problema richiede i seguenti parametri:

Parametro Descrizione
Project Key

Obbligatorio.

La chiave abbreviata univoca del progetto Jira in cui viene creato il problema (ad esempio SEC).
Summary

Obbligatorio.

Un breve titolo o un riepilogo del problema.
Description

Facoltativo.

Una descrizione dettagliata del problema.
Issue Type

Obbligatorio.

Il nome del tipo di problema (ad esempio Task, Bug o Incident).
Jira Username

Facoltativo.

Il nome utente Jira della persona che avvia l'azione.
Assignee

Facoltativo.

L'identificatore dell'utente a cui è assegnato il problema.
Components

Facoltativo.

Un elenco separato da virgole di componenti Jira da associare al problema.
Labels

Facoltativo.

Un elenco di etichette separate da virgole da aggiungere al problema.
Custom Fields

Facoltativo.

Un oggetto JSON contenente campi e valori aggiuntivi da impostare durante la creazione (ad esempio, {"customfield_10001": "Value"}).

I valori forniti in questo parametro hanno la priorità e sovrascrivono altre mappature dei campi in caso di conflitto.

Output azione

L'azione Crea problema fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Crea problema:

{
   "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
   }
}
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Crea problema:

Nome del risultato dello script Valore
issue_key La chiave abbreviata univoca del problema Jira appena creato (ad esempio, SEC-789).

Elimina problema

Utilizza l'azione Elimina problema per rimuovere definitivamente un problema da Jira.

Questa azione viene in genere utilizzata per eliminare i ticket duplicati o rimuovere i dati di test generati durante lo sviluppo del playbook.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Elimina problema richiede i seguenti parametri:

Parametro Descrizione
Issue Key

Obbligatorio.

La chiave abbreviata univoca del problema Jira da eliminare (ad esempio, SEC-123).

Output azione

L'azione Elimina problema fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elimina problema:

Nome del risultato dello script Valore
success true o false

Scarica allegati

Utilizza l'azione Scarica allegati per recuperare tutti i file allegati a un problema Jira specifico. Se un allegato è un file .eml, l'azione scarica anche tutti i file contenuti nell'email.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Scarica allegati richiede i seguenti parametri:

Parametro Descrizione
Issue Key

Obbligatorio.

La chiave abbreviata univoca del problema Jira (ad esempio, SEC-123).
Download Path

Facoltativo.

Il percorso locale o interno della cartella in cui l'azione salva gli allegati scaricati.

Il formato richiesto dipende dal tipo di deployment:

  • Deployment SaaS: il percorso è interno alla piattaforma ospitata, ad esempio /attachments/.
  • Deployment dell'agente remoto: il percorso deve essere un percorso di directory assoluto e valido sulla macchina locale in cui è installato l'agente remoto. Ad esempio, C:\temp\attachments per Windows o /var/tmp/attachments/ per Linux.
Download Attachments to the Case Wall

Facoltativo.

Se selezionata, l'azione scarica gli allegati del problema Jira direttamente nella bacheca della richiesta Google SecOps corrente.

Esiste un limite di dimensioni per gli allegati aggiunti alla bacheca casi. Il caricamento di file di grandi dimensioni potrebbe non riuscire.

Disattivato per impostazione predefinita.

Output azione

L'azione Scarica allegati fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Scarica allegati:

[
  {
    "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"
    }
  }
]
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Scarica allegati:

Nome del risultato dello script Valore
is_success true o false

Ottieni problemi

Utilizza l'azione Recupera problemi per recuperare i dettagli completi di uno o più problemi di Jira.

Questa azione è utile per arricchire i casi di Google SecOps con i metadati dei ticket attuali (come stato, assegnatario e priorità).

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Get Issues richiede i seguenti parametri:

Parametro Descrizione
Issue Keys

Obbligatorio.

Un elenco separato da virgole di chiavi dei problemi Jira da recuperare (ad esempio, SEC-123, SEC-456).

Output azione

L'azione Get Issues fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Recupera problemi:

{
  "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": []
    }
  ]
}
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Get Issues:

Nome del risultato dello script Valore
issues_details_list Un elenco contenente i metadati completi dei problemi Jira richiesti.

Utilizza l'azione Collega problemi per stabilire una relazione tra più problemi di Jira.

Questa azione viene utilizzata principalmente all'interno dei playbook per collegare incidenti di sicurezza correlati o per monitorare le dipendenze tra i ticket di indagine.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Collega problemi richiede i seguenti parametri:

Parametro Descrizione
Inward Issue ID

Obbligatorio.

Un elenco separato da virgole di ID dei problemi in entrata.

Ad esempio, se Relation Type è impostato su Blocks, questo problema mostra la relazione is blocked by nell'interfaccia utente di Jira.
Outward Issue IDs

Obbligatorio.

La chiave abbreviata del problema Jira in uscita.

Ad esempio, se Relation Type è impostato su Blocks, questo problema mostra la relazione blocks nell'interfaccia utente di Jira.
Relation Type

Obbligatorio.

Il tipo di link da creare tra i problemi.

Puoi trovare un elenco dei tipi di relazione disponibili eseguendo l'azione Elenca tipi di relazione.

Il valore predefinito è Blocks.

Output azione

L'azione Collega problemi fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Messaggi di output

L'azione Collega problemi può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

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

Action wasn't able to find the following destination issues in Jira: ISSUE_IDS.

 L'azione è riuscita
Error executing action "Link Issues". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Collega problemi:

Nome del risultato dello script Valore
success true o false

Elenca problemi

Utilizza l'azione Elenca problemi per cercare e recuperare un elenco di chiavi dei problemi di Jira in base a criteri di filtro specifici.

Questa azione è utile per identificare i ticket esistenti che corrispondono al contesto di un avviso per evitare duplicazioni o per eseguire aggiornamenti in blocco all'interno di un playbook.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Elenca problemi fornisce i seguenti parametri di filtro facoltativi. Se non vengono forniti parametri, l'azione restituisce tutti i problemi accessibili all'utente dell'integrazione.

Parametro Descrizione
Project Names

Facoltativo.

Un elenco separato da virgole di nomi di progetti in cui eseguire la ricerca.
Summary

Facoltativo.

Se fornito, l'azione filtra i problemi in base al riepilogo o al titolo specifico.
Description

Facoltativo.

Se fornita, l'azione filtra i problemi in base al testo contenuto nella descrizione.
Issue Types

Facoltativo.

Un elenco separato da virgole di tipi di problemi (ad esempio, Bug,Task).

Il valore predefinito è Bug.
Priorities

Facoltativo.

Un elenco separato da virgole di livelli di priorità in base ai quali filtrare (ad esempio, High,Medium).
Created From

Facoltativo.

Se specificato, l'azione filtra i problemi creati a partire da questa data (nel formato YYYY/MM/DD).
Updated From

Facoltativo.

Se specificata, l'azione filtra i problemi aggiornati a partire da questa data (nel formato YYYY/MM/DD).
Assignees

Facoltativo.

Un elenco separato da virgole di identificatori degli assegnatari in base ai quali filtrare.
Reporter

Facoltativo.

Un elenco separato da virgole di identificatori di segnalatori in base ai quali filtrare.
Statuses

Facoltativo.

Un elenco separato da virgole di stati dei problemi in base ai quali filtrare (ad esempio, Open,In Progress).
Created Before

Facoltativo.

La data di creazione più recente in base alla quale applicare il filtro. Formato: YYYY/MM/DD o offset relativo (ad esempio, -24h, -7d). Se non viene fornito, il filtro non verrà utilizzato.
Custom JQL

Facoltativo.

Query JQL personalizzata. Se fornito, tutti gli altri filtri verranno ignorati.

Output azione

L'azione Elenca problemi fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca problemi:

[ 
  "PR-123", 
  "PR-124",
  "SEC-789"
]
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca problemi:

Nome del risultato dello script Valore
issues Un elenco contenente le chiavi abbreviate univoche dei problemi Jira trovati.

Elenco dei tipi di relazione

Utilizza l'azione Elenca tipi di relazione per recuperare un elenco di tutti i tipi di relazione di collegamento disponibili configurati nella tua istanza Jira.

Questa azione è utile per convalidare i valori di input validi per l'azione Collega problemi.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Elenca tipi di relazione richiede i seguenti parametri:

Parametro Descrizione
Filter Key

Facoltativo.

Il campo utilizzato per filtrare i tipi di relazione.

Se la logica del filtro è impostata su Equal o Contains, devi selezionare un campo diverso da Select One per evitare un errore di esecuzione.

I valori possibili sono:

  • Name
  • Inward
  • Outward

Il valore predefinito è Select One.
Filter Logic

Facoltativo.

L'operatore logico applicato al filtro.

I valori possibili sono:

  • Not Specified
  • Equal
  • Contains

Il valore predefinito è Not Specified.
Filter Value

Facoltativo.

Il valore di stringa specifico utilizzato per il filtro in base ai valori Filter Key e Filter Logic selezionati.

Se non viene fornito alcun valore, il filtro non viene applicato anche se vengono selezionate una chiave e una logica.
Max Records To Return

Facoltativo.

Il numero massimo di record da restituire nei risultati.

Il valore predefinito è 50.

Output azione

L'azione Elenca tipi di relazioni fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Tabella della bacheca casi

L'azione Elenca tipi di relazione fornisce la seguente tabella:

Nome tabella: Available Relation

Colonne della tabella:

  • Nome
  • Inward
  • Outward
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca tipi di relazione:

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

L'azione List Relation Types può restituire i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Successfully found relation types for the provided criteria in Jira.

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

 L'azione è andata a buon fine.
Error executing action "List Relation types". Reason: ERROR_REASON

L'azione non è andata a buon fine.

Controlla la connessione al server, i parametri di input o le credenziali.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Elenca tipi di relazione:

Nome del risultato dello script Valore
is_success true o false

Dindin

Utilizza l'azione Ping per testare la connettività a Jira.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

Nessuno.

Output azione

L'azione Ping fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Ping:

Nome del risultato dello script Valore
success true o false

Aggiorna problema

Descrizione

Aggiorna un problema. Per la nuova API Jira, l'azione tenta di trovare una corrispondenza per l'assegnatario per assegnare un problema in base all'indirizzo email dell'utente, quindi tenta con il campo displayName.

Parametri

Parametro Tipo Valore predefinito Obbligatorio Descrizione
Chiave del problema Stringa N/D Sì La chiave del problema da aggiornare.
Stato Stringa N/D No Specifica il nome della transizione pertinente per eseguire la transizione di questo problema al nuovo stato desiderato.
Riepilogo Stringa N/D No Il nuovo riepilogo del problema.
Descrizione Stringa N/D No La nuova descrizione del problema.
Tipo di problema Stringa N/D No Il nuovo tipo di problema.
Assegnatario Stringa N/D No Il nuovo assegnatario del problema.
Nome utente Jira Stringa N/D No Il nome utente Jira di chi ha avviato l'azione.
Componenti Stringa N/D No

Il campo dei componenti del problema.

Questo parametro accetta più valori sotto forma di stringa separata da virgole.
Campi personalizzati JSON ND No

Specifica un oggetto JSON contenente tutti i campi e i valori utilizzati durante la creazione del problema.

Nota: questo parametro ha la priorità e tutti i campi vengono sovrascritti con il valore fornito per questo parametro.

Esempio: {"field":"value"}
Etichette Stringa N/D No

Il campo dei componenti del problema.

Questo parametro accetta più valori sotto forma di stringa separata da virgole.

Esegui il

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
Operazione riuscita Vero/Falso Success:False
Risultato JSON
{
   "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
}

Carica allegato

Descrizione

Aggiungi un allegato a un problema.

Parametri

Parametro Tipo Valore predefinito Obbligatorio Descrizione
Chiave del problema Stringa N/D Sì Percorsi file.
Percorsi file Stringa N/D Sì

I percorsi assoluti dei file da caricare, separati da virgole.

Il formato richiesto dipende dal tipo di deployment:

  • Deployment SaaS: il percorso è interno alla piattaforma ospitata, ad esempio /attachments/.
  • Deployment dell'agente remoto: il percorso deve essere un percorso di directory assoluto e valido sulla macchina locale in cui è installato l'agente remoto. Ad esempio, C:\temp\attachments per Windows o /var/tmp/attachments/ per Linux.

Esegui il

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore Esempio
is_success Vero/Falso is_success:False
Risultato JSON
N/A

Cerca utenti

Cerca utenti in Jira.

Entità

Questa azione non viene eseguita sulle entità.

Input azione

Per configurare l'azione, utilizza i seguenti parametri:

Parametri
User Email Addresses Optional

Elenco separato da virgole di indirizzi email per i quali restituire gli utenti.
User Names Optional

Elenco separato da virgole di nomi utente per cui restituire gli utenti.
Project Optional

Nome del progetto in cui cercare gli indirizzi email. Se fornito, viene restituito solo Project Assignable Users.

Output azione

Tipo di output dell'azione
Allegato della bacheca richieste N/D
Link alla bacheca casi N/D
Tabella della bacheca casi N/D
Tabella di arricchimento N/D
Risultato JSON Disponibile
Risultato dello script Disponibile
Risultato dello script
Nome del risultato dello script Valore
is_success Vero/Falso
Risultato JSON
[
 {
   "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"
   }
 }
]
Bacheca casi

L'azione fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

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

 Azione riuscita.
Error executing action "Search Users". Reason: ERROR_REASON

Azione non riuscita.

Controlla la connessione al server, i parametri di input o le credenziali.

Configurazione della mappatura dei motivi di chiusura

Il parametro Closed Reason Mapping richiede una struttura JSON. Puoi mappare valori statici o passare nomi di campi Jira dinamici (ad esempio resolution, customfield_10010). Se un motivo dinamico estratto non è valido o manca, il job utilizza automaticamente la mappatura Fallback specificata.

Esempio di configurazione JSON:

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

Connettori

Connettore Jira

Descrizione

Recuperare i problemi da Jira a Google SecOps.

Configura il connettore Jira in Google SecOps

Per istruzioni dettagliate su come configurare un connettore in Google SecOps, consulta Configurazione del connettore.

Parametri del connettore

Utilizza i seguenti parametri per configurare il connettore:

Parametro Descrizione
DeviceProductField

Obbligatorio.

Il nome del campo utilizzato per determinare il prodotto del dispositivo.

Il valore predefinito è device_product.
EventClassId

Facoltativo.

Il nome del campo utilizzato per determinare il nome evento (sottotipo).

Il valore predefinito è name.
PythonProcessTimeout

Obbligatorio.

Il limite di timeout (in secondi) per il processo Python che esegue lo script corrente.

Il valore predefinito è 60.
API Root

Obbligatorio.

La radice dell'API dell'istanza Jira.

Il valore predefinito è https://{jira_address}.
Username

Facoltativo.

Il nome utente (indirizzo email) utilizzato per connettersi a Jira.

Il requisito per questo parametro dipende dal metodo di autenticazione scelto:

  • Se fornito, il sistema utilizza l'autenticazione di base.
  • Se il campo viene lasciato vuoto, il sistema utilizza l'autenticazione con token di connessione (obbligatoria per i service account).

Per saperne di più sui metodi di autenticazione, consulta Prima di iniziare.
API Token

Obbligatorio.

La credenziale di autenticazione utilizzata per connettersi a Jira.
Days Backwards

Facoltativo.

Numero massimo di giorni precedenti da cui estrarre gli avvisi.

Il valore predefinito è 5.
Max Tickets Per Cycle

Facoltativo.

Numero massimo di ticket da recuperare ed elaborare in un ciclo del connettore.

Il valore predefinito è 10.
Project Names

Facoltativo.

Nomi dei progetti separati da una virgola.
Issue Statuses

Facoltativo.

Stati dei problemi separati da una virgola.
Assignees

Facoltativo.

Nomi completi degli utenti separati da una virgola.
Issue Types

Facoltativo.

Tipi di problemi separati da una virgola.
Issue Priorities

Facoltativo.

Priorità dei problemi separate da una virgola.
Issue Components

Facoltativo.

Componenti del problema separati da una virgola.
Proxy Server Address

Facoltativo.

L'indirizzo del server proxy da utilizzare.
Proxy Username

Facoltativo.

Il nome utente del proxy con cui eseguire l'autenticazione.
Proxy Password

Facoltativo.

La password del proxy con cui eseguire l'autenticazione.
Environment Field Name

Facoltativo.

Descrive il nome del campo in cui è memorizzato il nome dell'ambiente. Se il campo dell'ambiente non viene trovato, l'ambiente è quello predefinito.

Il valore predefinito è "".
Environment Regex Pattern

Facoltativo.

Un pattern regex da eseguire sul valore trovato nel campo "Nome campo ambiente". Utilizzato per consentire all'utente di manipolare il campo dell'ambiente utilizzando la logica delle espressioni regolari.

Il valore predefinito è .*.
Use Jira Project as Environment

Facoltativo.

Utilizza il progetto Jira come ambiente o utilizza il nome del campo Ambiente come ambiente.
Verify SSL

Obbligatorio.

Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server Jira.

Abilitato per impostazione predefinita.

Regole del connettore

Supporto dei proxy

Il connettore supporta il proxy.

Elenco dinamico e lista bloccata

Il connettore supporta regole di lista consentita e lista bloccata dinamiche solo per etichette specifiche all'interno di Jira.

Job

Job di chiusura della sincronizzazione

Descrizione

Chiudere i ticket in Jira se gli avvisi o i casi Google SecOps corrispondenti sono stati chiusi e sincronizzare lo stato di chiusura e i campi personalizzati da Jira a Google SecOps.

Parametri

Parametro Descrizione
API Root

Obbligatorio.

URL di base dell'API dell'istanza Jira.

Il valore predefinito è https://{jira_address}.
Username

Facoltativo.

Il nome utente (indirizzo email) utilizzato per connettersi a Jira.

Il requisito per questo parametro dipende dal metodo di autenticazione scelto:

  • Se fornito, il sistema utilizza l'autenticazione di base.
  • Se il campo viene lasciato vuoto, il sistema utilizza l'autenticazione con token di connessione (obbligatoria per i service account).
API Token

Obbligatorio.

La credenziale di autenticazione utilizzata per connettersi a Jira.
Project Names

Obbligatorio.

Nomi dei progetti Jira separati da una virgola che il job deve monitorare.

Il valore predefinito è project names separated by a comma.
Environment

Facoltativo.

Il nome dell'ambiente.
Days Backwards

Obbligatorio.

Numero massimo di giorni per sincronizzare lo stato dei ticket in ordine inverso.

Il valore predefinito è 1.
Job Scope

Obbligatorio.

Ambito della sincronizzazione dei job. Opzioni:

  • Case: sincronizza i problemi Jira a livello di richiesta. Assicurati che il contesto contenga JIRA_ISSUE_KEY.
  • Alert: sincronizza i problemi Jira a livello di avviso. Per le richieste create dal connettore, la chiave del ticket Jira viene estratta automaticamente. Per i casi simulati, imposta manualmente la chiave di contesto su JIRA_ISSUE_KEY.

Il valore predefinito è Alert.
Supported Closed Statuses

Obbligatorio.

Elenco separato da virgole degli stati di chiusura di Jira trattati come chiusi in Google SecOps (ad esempio, Done, Closed).

  • Da SecOps a Jira: il job utilizza il primo valore dell'elenco (ad esempio, Done) come stato di risoluzione quando chiude il ticket Jira.
  • Da Jira a SecOps: lo stato di chiusura del ticket Jira deve essere presente in questo elenco affinché la sincronizzazione avvenga.

Il valore predefinito è Done.
Closed Reason Mapping

Obbligatorio.

Dizionario JSON che mappa gli stati di chiusura di Jira ai motivi di chiusura e alle cause principali di Google SecOps. Supporta la mappatura ai campi personalizzati e richiede una chiave Fallback obbligatoria. Per i dettagli e gli esempi di configurazione, consulta Motivo della chiusura e mappatura dei campi personalizzati.
Custom Fields Mapping

Facoltativo.

Oggetto JSON che definisce le mappature tra i nomi visualizzati dei campi personalizzati di Google SecOps e i nomi dei campi personalizzati di Jira per la sincronizzazione dei dati da Jira a Google SecOps. Per i dettagli e gli esempi di configurazione, consulta Mappatura dei campi personalizzati e del motivo della chiusura.

Motivo della chiusura e mappatura dei campi personalizzati

Utilizza i dettagli e gli esempi riportati di seguito per configurare le mappature personalizzate per i motivi di chiusura e i campi personalizzati.

Mappatura dei motivi di chiusura

Definisce il modo in cui gli stati di chiusura di Jira vengono mappati ai motivi di chiusura e alle cause principali delle richieste o degli avvisi di Google SecOps.

  • Esempio di mappatura JSON standard:

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

    Se un ticket Jira viene chiuso con lo stato Done, la richiesta o l'avviso di Google SecOps viene chiuso con il motivo Malicious e la causa principale Other. Se il ticket viene chiuso con uno stato non mappato esplicitamente (ad esempio Closed), il sistema utilizza per impostazione predefinita le impostazioni Fallback.

  • Esempio di mappatura dei campi personalizzati:

    Se in Jira hai campi personalizzati denominati Jira reason e Jira rootcause, configura la mappatura JSON come segue:

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

    Requisiti:

    • Il valore estratto dal campo personalizzato Jira reason deve essere risolto in una delle seguenti stringhe esatte: Malicious, Maintenance, Inconclusive o Not malicious. In caso contrario, il sistema ripristina i valori Fallback.
    • Per l'ambito del job Case, i valori della causa principale devono essere configurati nelle impostazioni di amministrazione. Per l'ambito del job Alert, non è richiesta alcuna configurazione da parte dell'amministratore e viene accettato qualsiasi valore fornito nel campo personalizzato.

Mappatura dei campi personalizzati

Questa mappatura serve esclusivamente a sincronizzare i valori dei campi personalizzati da Jira a Google SecOps. Specifica le coppie chiave-valore in cui la chiave è il nome visualizzato del campo personalizzato di Google SecOps e il valore è il nome del campo personalizzato di Jira:

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

In questo esempio, il valore del campo Jira Jira ticket id viene sincronizzato direttamente con il campo Google SecOps SOAR Custom field.

Job di sincronizzazione dei commenti

Descrizione

Sincronizza i commenti tra la richiesta di Google SecOps e il ticket Jira corrispondente. La sincronizzazione è bidirezionale, ovvero da Google SecOps a Jira e da Jira a Google SecOps.

Quando il job crea un commento, applica il prefisso. Se un utente di Google SecOps commenta nel caso Google SecOps, il job crea e sincronizza il commento dell'utente nel ticket Jira corrispondente utilizzando il parametro Chronicle Comment Prefix.

Questa funzionalità è stata aggiunta per due scopi:

  1. Visibilità.
  2. Impedire che i commenti aggiunti dal job vengano sincronizzati di nuovo con l'altro lato, causando un loop.

Parametri

Parametro Descrizione
API Root

Obbligatorio.

URL di base dell'API dell'istanza Jira.

Il valore predefinito è https://{jira_address}.
Username

Facoltativo.

Il nome utente (indirizzo email) utilizzato per connettersi a Jira.

Il requisito per questo parametro dipende dal metodo di autenticazione scelto:

  • Se fornito, il sistema utilizza l'autenticazione di base.
  • Se il campo viene lasciato vuoto, il sistema utilizza l'autenticazione con token di connessione (obbligatoria per i service account).
API Token

Obbligatorio.

La credenziale di autenticazione utilizzata per connettersi a Jira.
Project Names

Obbligatorio.

Nomi dei progetti Jira separati da una virgola che il job deve monitorare.

Il valore predefinito è project names separated by comma.
Environment

Facoltativo.

Il nome dell'ambiente.
Siemplify Comment Prefix

Obbligatorio.

Prefisso aggiunto dal job di sincronizzazione ai commenti creati per i ticket Jira.

Il valore predefinito è Google SecOps:.
Jira Comment Prefix

Obbligatorio.

Prefisso aggiunto dal job di sincronizzazione ai commenti della richiesta di avviso di Google SecOps.

Il valore predefinito è Jira Comment Sync Job:.

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.