Gmail

Questo documento fornisce indicazioni su come integrare Gmail con Google Security Operations SOAR.

Versione integrazione: 1.0

Prima di iniziare

Per utilizzare l'integrazione, devi disporre di un account di servizio Google Cloud . Puoi utilizzare unaccount di serviziot esistente o crearne uno nuovo. Inoltre, l'API Gmail deve essere abilitata nell'organizzazione Google Cloud .

Crea un account di servizio

Per indicazioni sulla creazione di un account di servizio, vedi Creare service account.

Se utilizzi un account di servizio per l'autenticazione a Google Cloud, puoi creare una chiave dell'account di servizio in JSON e fornire i contenuti del file JSON scaricato durante la configurazione dei parametri di integrazione.

Per motivi di sicurezza, ti consigliamo di utilizzare un indirizzo email dell'identità del workload anziché una chiave del account di servizio. Per saperne di più sulle identità dei workload, consulta Identità per i workload.

Delega l'autorità a livello di dominio al tuo service account

  1. Nella Console di amministrazione Google del tuo dominio, vai a Menu principale > Sicurezza > Accesso e controllo dei dati > Controlli API.
  2. Nel riquadro Delega a livello di dominio, seleziona Gestisci delega a livello di dominio.
  3. Fai clic su Aggiungi nuovo.
  4. Nel campo ID client, inserisci l'ID client ottenuto dai passaggi precedenti per la creazione dell'account di servizio.

  5. Nel campo Ambiti OAuth, inserisci il seguente elenco di ambiti delimitato da virgole necessari per l'integrazione:

        "https://mail.google.com/",
    "https://www.googleapis.com/auth/cloud-platform",
    "https://www.googleapis.com/auth/admin.directory.user",
    "https://www.googleapis.com/auth/admin.directory.group.member",
    "https://www.googleapis.com/auth/admin.directory.customer.readonly",
    "https://www.googleapis.com/auth/admin.directory.domain.readonly",
    "https://www.googleapis.com/auth/admin.directory.group",
    "https://www.googleapis.com/auth/admin.directory.orgunit",
    "https://www.googleapis.com/auth/admin.directory.user.alias",
    "https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly",
    "https://www.googleapis.com/auth/apps.groups.settings"

  6. Fai clic su Autorizza.

Integrare Gmail con Google SecOps SOAR

L'integrazione di Gmail richiede i seguenti parametri:

Parametro Descrizione
Service Account JSON File Content Optional

Il contenuto del file JSON della chiave dell'account di servizio. Puoi configurare questo parametro o il parametro Workload Identity Email.

Per configurare questo parametro, fornisci l'intero contenuto del file JSON della chiave dell'account di servizio che hai scaricato durante la creazione di un account di servizio.
Default Mailbox Obbligatorio

Una casella di posta predefinita da utilizzare nell'integrazione.
Workload Identity Email Optional

L'indirizzo email client della tua identità del carico di lavoro.

Puoi configurare questo parametro o il parametro Service Account JSON File Content.

Per simulare l'identità dei service account con l'indirizzo email dell'identità del carico di lavoro, concedi il ruolo Service Account Token Creator al tuo account di servizio. Per maggiori dettagli sulle identità dei workload e su come utilizzarle, consulta Identità per i workload.
Verify SSL Optional

Se selezionata, l'integrazione verifica che il certificato SSL per la connessione a Gmail sia valido.

Questo parametro è selezionato per impostazione predefinita.

Per istruzioni sulla configurazione di un'integrazione in Google SecOps, consulta Configurare le integrazioni.

Se necessario, potrai apportare modifiche in un secondo momento. Dopo aver configurato un'istanza di integrazione, puoi utilizzarla nei playbook. Per saperne di più sulla configurazione e sul supporto di più istanze, consulta Supporto di più istanze.

Azioni

Per maggiori informazioni sulle azioni, vedi Rispondere alle azioni in attesa dalla tua postazione di lavoro ed Eseguire un'azione manuale.

Aggiungere un'etichetta email

Utilizza l'azione Aggiungi etichetta email per aggiungere un'etichetta all'email specificata.

Questa azione è asincrona. Modifica il timeout dell'azione nell'ambiente di sviluppo integrato (IDE) di Google SecOps di conseguenza.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Aggiungi etichetta email richiede i seguenti parametri:

Parametro Descrizione
Mailbox Obbligatorio

Una casella di posta in cui attendere una risposta, ad esempio user@example.com.

Per impostazione predefinita, l'azione utilizza la casella di posta predefinita che hai configurato per l'integrazione. Questo parametro accetta più valori come elenco separato da virgole.
Internet Message ID Optional

L'ID messaggio internet di un'email da cercare.

Questo parametro accetta più valori come stringa separata da virgole.

Se fornisci l'ID messaggio internet, l'azione ignora i parametri Subject Filter, Sender Filter e Time Frame (minutes).
Labels Filter Optional

Una condizione di filtro che specifica le etichette email da cercare.

Questo parametro accetta più valori come una stringa separata da virgole.

Il valore predefinito è Inbox.

Puoi cercare email con etichette specifiche, ad esempio label1, label2. Per cercare le email che non hanno l'etichetta specifica, utilizza il seguente formato: -label1. Puoi configurare questo parametro per cercare email con e senza etichette specifiche in una sola stringa, ad esempio label1, -label2, label3.
Subject Filter Optional

Una condizione di filtro che specifica l'oggetto dell'email da cercare.

Questo filtro utilizza la logica contains e richiede di specificare gli elementi di ricerca con parole intere. Questo filtro non supporta le corrispondenze parziali.
Sender Filter Optional

Una condizione di filtro che specifica il mittente email da cercare.

Questo filtro utilizza la logica equals.
Time Frame (minutes) Optional

Una condizione di filtro che specifica l'intervallo di tempo in minuti in cui cercare le email.

Il valore predefinito è 60 minuti.
Email Status Optional

Lo stato dell'email da cercare.

I valori possibili sono:

  • Only Unread Messages
  • Only Read Messages
  • Both Read & Unread Messages

Il valore predefinito è Both Read & Unread Messages.
Label Obbligatorio

Un'etichetta per aggiornare l'email.

Questo parametro accetta più valori come elenco separato da virgole.

Se l'etichetta non esiste in una casella postale, l'azione la crea.

Output dell'azione

L'azione Aggiungi etichetta email fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca richieste 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

Il seguente esempio descrive l'output del risultato JSON ricevuto quando si utilizza l'azione Aggiungi etichetta email:

[
   {
       "Entity": "email@example.com",
       "EntityResult": [
           {
               "id": "ID",
               "thread_id": "THREAD_ID",
               "label_ids": [
                   "CATEGORY_PERSONAL",
                   "INBOX"
               ],
               "snippet": "SNIPPET",
               "history_id": "10576",
               "internal_date": 1728217410000,
               "message_id": "<CAAfJ0RiApRCW7jbTMQdjia+cnzrsWR4UNbB4x94srTZHaEG+Vw@example.com>",
               "subject": "SUBJECT",
               "from": "example@example.com",
               "headers": {
                   "delivered-to": "email@example.com",
                   "received": [
                       "by 2002:a096512 named unknown by gmailapi.google.com with HTTPREST; Sun, 6 Oct 2024 12:23:30 +0000"
                   ],
                   "x-google-smtp-source": "AGHT+IEq/FCBnUtDRgoabTbX8/z1dIKeKteo3Ic5+sbufKyI22pP1gK1soG9jSmV7dMEQXlIVdRf",
                   "x-received": [
                       "by 2002:a05:620a:0:b0:374:ce15:9995 with SMTP id ffacd0b85a97d-37d0e78253cmr6681102f8f.34.1728217410309; Sun, 06 Oct 2024 05:23:30 -0700 (PDT)"
                   ],
                   "arc-seal": "i=1; aLC/Hhaf3TqCPqGGiSfvDT7bxtQp1lz         c9xg==",
                   "arc-message-signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605;        h=to:subject:message-id:datG+AhKivQ7tcf2K8m9B/lexnQw/puC+acDzdYkIqU6         o4ne1qpcJKc32l6V0+ggtGSuHFvp6ySOZkhLJqei9RXBd6HPV3Yj5nVexbhlFuH29w3E         KpGg==;        dara=google.com",
                   "arc-authentication-results": "i=1; mx.google.com;       dkim=pass header.i=@labilfrom=example@example.com;       dara=pass header.i=@example.com",
               },
               "mimetype": "text/plain",
               "text_bodies": [
                   "text\r\n"
               ],
               "html_bodies": [],
               "file_attachments": [],
               "date": "Sun, 6 Oct 2024 12:23:30 +0000",
               "to": "email@example.com",
               "cc": null,
               "bcc": null,
               "in-reply-to": null,
               "reply-to": null
           }
       ]
   }
]
Messaggi di output

L'azione Aggiungi etichetta email fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Successfully updated labels for emails in the following mailboxes: MAILBOX_LIST

No emails were found based on the provided search criteria in the following mailboxes: MAILBOX_LIST

The following mailboxes were not found: MAILBOX_LIST. Check the spelling.

Update is pending for emails in the following mailboxes: MAILBOX_LIST

 L'azione è riuscita.
Error executing action "Add Email Label". Reason: ERROR_REASON

L'azione non è riuscita.

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

La seguente tabella descrive i valori per l'output del risultato dello script quando utilizzi l'azione Aggiungi etichetta email:

Nome del risultato dello script Valore
is_success True o False

Eliminare le email

Utilizza l'azione Elimina email per eliminare una o più email dalla casella di posta in base ai criteri di ricerca forniti. Per impostazione predefinita, questa azione sposta le email nel cestino. Puoi configurare l'azione in modo da eliminare definitivamente le email anziché spostarle nel cestino.

L'azione Elimina email è asincrona. Modifica il timeout dell'azione nell'IDE di Google SecOps di conseguenza.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Elimina email richiede i seguenti parametri:

Parametro Descrizione
Mailbox Obbligatorio

Una casella di posta in cui attendere una risposta, ad esempio user@example.com.

Per impostazione predefinita, l'azione utilizza la casella di posta predefinita che hai configurato per l'integrazione. Questo parametro accetta più valori come stringa separata da virgole.
Labels Filter Optional

Una condizione di filtro che specifica le etichette email da cercare.

Questo parametro accetta più valori come una stringa separata da virgole.

Il valore predefinito è Inbox.

Puoi cercare email con etichette specifiche, ad esempio label1, label2. Per cercare le email che non hanno l'etichetta specifica, utilizza il seguente formato: -label1. Puoi configurare questo parametro per cercare email con e senza etichette specifiche in una sola stringa, ad esempio label1, -label2, label3.
Internet Message ID Optional

L'ID messaggio internet di un'email da cercare.

Questo parametro accetta più valori come stringa separata da virgole.

Se fornisci l'ID messaggio internet, l'azione ignora i parametri Subject Filter, Sender Filter, Labels Filter e Time Frame (minutes).
Subject Filter Optional

Una condizione di filtro che specifica l'oggetto dell'email da cercare.

Questo filtro utilizza la logica contains e richiede di specificare gli elementi di ricerca con parole intere. Questo filtro non supporta le corrispondenze parziali.
Sender Filter Optional

Una condizione di filtro che specifica il mittente email da cercare.

Questo filtro utilizza la logica equals.
Time Frame (minutes) Optional

Una condizione di filtro che specifica l'intervallo di tempo in minuti in cui cercare le email.

Il valore predefinito è 60 minuti.
Email Status Optional

Lo stato dell'email da cercare.

I valori possibili sono:

  • Only Unread Messages
  • Only Read Messages
  • Both Read & Unread Messages

Il valore predefinito è Both Read & Unread Messages.
Move to Trash Optional

Se selezionata, l'azione sposta le email nel cestino e non esegue ricerche nelle email con l'etichetta Cestino, a meno che non configuri il parametro Labels Filter in modo da includere la seguente etichetta: Trash. Se non è selezionata, l'azione esegue una ricerca nell'intera casella di posta ed elimina le email per sempre.

Questa opzione è selezionata per impostazione predefinita.

Output dell'azione

L'azione Elimina email fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca richieste 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

Il seguente esempio descrive l'output del risultato JSON ricevuto quando si utilizza l'azione Elimina email:

{
"mailbox1": [DELETED_MESSAGE_ID_LIST],
"mailbox2": [DELETED_MESSAGE_ID_LIST]
}
Messaggi di output

L'azione Elimina email fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Successfully deleted emails in the following mailboxes: MAILBOX_LIST

No emails to delete based on the provided search criteria in the following mailboxes: MAILBOX_LIST

The following mailboxes were not found: MAILBOX_LIST. Check the spelling.

The action didn't find any emails based on the specified search criteria.

Pending deletion of emails in the following mailboxes: MAILBOX_LIST

 L'azione è riuscita.
Error executing action "Delete Email". Reason: ERROR_REASON

L'azione non è riuscita.

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

La seguente tabella descrive i valori dell'output del risultato dello script quando utilizzi l'azione Elimina email:

Nome del risultato dello script Valore
is_success True o False

Inoltra email

Utilizza l'azione Inoltra email per inoltrare le email, incluse quelle con i thread precedenti.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Inoltra email richiede i seguenti parametri:

Parametro Descrizione
Mailbox Obbligatorio

Una casella di posta da cui inviare un'email, ad esempio user@example.com.

Per impostazione predefinita, l'azione utilizza la casella di posta predefinita che hai configurato per l'integrazione.
Internet Message ID Obbligatorio

L'ID messaggio internet di un'email da cercare.
Send To Obbligatorio

Una stringa di indirizzi email separati da virgole per i destinatari dell'email, ad esempio user1@example.com, user2@example.com.

CC Optional

Una stringa di indirizzi email separati da virgole per i destinatari dell'email in copia conoscenza (CC), ad esempio user1@example.com, user2@example.com.
BCC Optional

Una stringa di indirizzi email separati da virgole per i destinatari di email in copia carbone nascosta (CCN), ad esempio user1@example.com, user2@example.com.
Subject Obbligatorio

Il nuovo oggetto di un'email da inoltrare.
Attachments Paths Optional

Stringa di percorsi separati da virgole per gli allegati dei file archiviati sul server Google SecOps.
Mail Content Obbligatorio

Il corpo dell'email.

Output dell'azione

L'azione Inoltra email fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca richieste 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

Il seguente esempio descrive l'output del risultato JSON ricevuto quando si utilizza l'azione Inoltra email:

{
   "id": "ID",
   "thread_id": "THREAD_ID",
   "label_ids": [
       "CATEGORY_PERSONAL",
       "INBOX"
   ],
   "snippet": "SNIPPET",
   "history_id": "10576",
   "internal_date": 1728217410000,
   "message_id": "<CAAfJ0RiApRCW7jbTMQdjia+cnzrsWR4UNbB4x94srTZHaEG+Vw@example.com>",
   "subject": "SUBJECT",
   "from": "example@example.com",
   "headers": {
       "delivered-to": "email@example.com",
       "received": [
           "by 2002:a096512 named unknown by gmailapi.google.com with HTTPREST; Sun, 6 Oct 2024 12:23:30 +0000"
       ],
       "x-google-smtp-source": "AGHT+IEq/FCBnUtDRgoabTbX8/z1dIKeKteo3Ic5+sbufKyI22pP1gK1soG9jSmV7dMEQXlIVdRf",
       "x-received": [
           "by 2002:a05:620a:0:b0:374:ce15:9995 with SMTP id ffacd0b85a97d-37d0e78253cmr6681102f8f.34.1728217410309; Sun, 06 Oct 2024 05:23:30 -0700 (PDT)"
       ],
       "arc-seal": "i=1; aLC/Hhaf3TqCPqGGiSfvDT7bxtQp1lz         c9xg==",
       "arc-message-signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605;        h=to:subject:message-id:datG+AhKivQ7tcf2K8m9B/lexnQw/puC+acDzdYkIqU6         o4ne1qpcJKc32l6V0+ggtGSuHFvp6ySOZkhLJqei9RXBd6HPV3Yj5nVexbhlFuH29w3E         KpGg==;        dara=google.com",
       "arc-authentication-results": "i=1; mx.google.com;       dkim=pass header.i=@labilfrom=example@example.com;       dara=pass header.i=@example.com",
   },
   "mimetype": "text/plain",
   "text_bodies": [
       "text\r\n"
   ],
   "html_bodies": [],
   "file_attachments": [],
   "date": "Sun, 6 Oct 2024 12:23:30 +0000",
   "to": "email@example.com",
   "cc": null,
   "bcc": null,
   "in-reply-to": null,
   "reply-to": null
}
Messaggi di output

L'azione Inoltra email fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully forwarded the MESSAGE_ID email. L'azione è riuscita.
Error executing action "Forward Email". Reason: ERROR_REASON

L'azione non è riuscita.

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

La seguente tabella descrive i valori dell'output del risultato dello script quando utilizzi l'azione Inoltra email:

Nome del risultato dello script Valore
is_success True o False

Dindin

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

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

Nessuno.

Output dell'azione

L'azione Ping fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca richieste 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
Messaggi di output

L'azione Ping fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully connected to the Google Gmail service with the provided connection parameters! L'azione è riuscita.
Failed to connect to the Google Gmail service! Error is ERROR_REASON

L'azione non è riuscita.

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

La seguente tabella descrive i valori per l'output del risultato dello script quando utilizzi l'azione Ping:

Nome del risultato dello script Valore
is_success True o False

Rimuovere l'etichetta email

Utilizza l'azione Rimuovi etichetta email per rimuovere un'etichetta dall'email specificata.

Questa azione è asincrona. Modifica il timeout dell'azione nell'IDE di Google SecOps di conseguenza.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Rimuovi etichetta email richiede i seguenti parametri:

Parametro Descrizione
Mailbox Obbligatorio

Una casella di posta in cui attendere una risposta, ad esempio user@example.com.

Per impostazione predefinita, l'azione utilizza la casella di posta predefinita che hai configurato per l'integrazione. Questo parametro accetta più valori come elenco separato da virgole.
Internet Message ID Optional

L'ID messaggio internet di un'email da cercare.

Questo parametro accetta più valori come stringa separata da virgole.

Se fornisci l'ID messaggio internet, l'azione ignora i parametri Subject Filter, Sender Filter e Time Frame (minutes).
Labels Filter Optional

Una condizione di filtro che specifica le etichette email da cercare.

Questo parametro accetta più valori come una stringa separata da virgole.

Il valore predefinito è Inbox.

Puoi cercare email con etichette specifiche, ad esempio label1, label2. Per cercare le email che non hanno l'etichetta specifica, utilizza il seguente formato: -label1. Puoi configurare questo parametro per cercare email con e senza etichette specifiche in una sola stringa, ad esempio label1, -label2, label3.
Subject Filter Optional

Una condizione di filtro che specifica l'oggetto dell'email da cercare.

Questo filtro utilizza la logica contains e richiede di specificare gli elementi di ricerca con parole intere. Questo filtro non supporta le corrispondenze parziali.
Sender Filter Optional

Una condizione di filtro che specifica il mittente email da cercare.

Questo filtro utilizza la logica equals.
Time Frame (minutes) Optional

Una condizione di filtro che specifica l'intervallo di tempo in minuti in cui cercare le email.

Il valore predefinito è 60 minuti.
Email Status Optional

Lo stato dell'email da cercare.

I valori possibili sono:

  • Only Unread Messages
  • Only Read Messages
  • Both Read & Unread Messages

Il valore predefinito è Both Read & Unread Messages.
Label Obbligatorio

Un'etichetta da rimuovere da un'email.

Questo parametro accetta più valori come elenco separato da virgole. Per rimuovere tutte le etichette dall'email, configura ilvalore parametroo come All.

Output dell'azione

L'azione Rimuovi etichetta email fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca richieste 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

Il seguente esempio descrive l'output del risultato JSON ricevuto quando si utilizza l'azione Rimuovi etichetta email:

[
   {
       "Entity": "email@example.com",
       "EntityResult": [
           {
               "id": "ID",
               "thread_id": "THREAD_ID",
               "label_ids": [
                   "CATEGORY_PERSONAL",
                   "INBOX"
               ],
               "snippet": "SNIPPET",
               "history_id": "10576",
               "internal_date": 1728217410000,
               "message_id": "<CAAfJ0RiApRCW7jbTMQdjia+cnzrsWR4UNbB4x94srTZHaEG+Vw@mail.gmail.com>",
               "subject": "SUBJECT",
               "from": "example@example.com",
               "headers": {
                   "delivered-to": "email@example.com",
                   "received": [
                       "by 2002:a096512 named unknown by gmailapi.google.com with HTTPREST; Sun, 6 Oct 2024 12:23:30 +0000"
                   ],
                   "x-google-smtp-source": "AGHT+IEq/FCBnUtDRgoabTbX8/z1dIKeKteo3Ic5+sbufKyI22pP1gK1soG9jSmV7dMEQXlIVdRf",
                   "x-received": [
                       "by 2002:a05:620a:0:b0:374:ce15:9995 with SMTP id ffacd0b85a97d-37d0e78253cmr6681102f8f.34.1728217410309; Sun, 06 Oct 2024 05:23:30 -0700 (PDT)"
                   ],
                   "arc-seal": "i=1; aLC/Hhaf3TqCPqGGiSfvDT7bxtQp1lz         c9xg==",
                   "arc-message-signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605;        h=to:subject:message-id:datG+AhKivQ7tcf2K8m9B/lexnQw/puC+acDzdYkIqU6         o4ne1qpcJKc32l6V0+ggtGSuHFvp6ySOZkhLJqei9RXBd6HPV3Yj5nVexbhlFuH29w3E         KpGg==;        dara=google.com",
                   "arc-authentication-results": "i=1; mx.google.com;       dkim=pass header.i=@labilfrom=example@example.com;       dara=pass header.i=@example.com",
               },
               "mimetype": "text/plain",
               "text_bodies": [
                   "text\r\n"
               ],
               "html_bodies": [],
               "file_attachments": [],
               "date": "Sun, 6 Oct 2024 12:23:30 +0000",
               "to": "email@example.com",
               "cc": null,
               "bcc": null,
               "in-reply-to": null,
               "reply-to": null
           }
       ]
   }
]
Messaggi di output

L'azione Rimuovi etichetta email fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Successfully updated labels for EMAIL_NUMBER emails in the MAILBOX_NAME mailbox.

The following labels don't exist in the MAILBOX_NAME mailbox: LABEL_LIST

None of the provided labels exists in the MAILBOX_NAME mailbox.

 L'azione è riuscita.
Error executing action "Remove Email Label". Reason: ERROR_REASON

L'azione non è riuscita.

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

La tabella seguente descrive i valori per l'output del risultato dello script quando si utilizza l'azione Rimuovi etichetta email:

Nome del risultato dello script Valore
is_success True o False

Salva email nella richiesta

Utilizza l'azione Salva email nella richiesta per salvare email o allegati email nella sezione Richiesta di azione in Google SecOps.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Salva email nella richiesta richiede i seguenti parametri:

Parametro Descrizione
Mailbox Obbligatorio

Una casella di posta in cui attendere una risposta, ad esempio user@example.com.

Per impostazione predefinita, l'azione utilizza la casella di posta predefinita che hai configurato per l'integrazione.
Internet Message ID Obbligatorio

L'ID messaggio internet di un'email da cercare.
Save Only Email Attachments Optional

Se selezionata, l'azione salva solo gli allegati dell'email specificata.

Non selezionato per impostazione predefinita.
Attachment To Save Optional

Se hai selezionato il parametro Save Only Email Attachments, l'azione salva solo gli allegati che specifichi in questo parametro.

Questo parametro accetta più valori come una stringa separata da virgole.
Base64 Encode Optional

Se selezionata, l'azione codifica il file email in un formato Base64.

Non selezionato per impostazione predefinita.

Output dell'azione

L'azione Salva email nella richiesta fornisce i seguenti output:

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

L'azione Salva email nella richiesta salva le email e gli allegati come prove della richiesta in Google SecOps.

La tabella seguente descrive i file salvati dall'azione:

File salvato Nome e formato
Email EMAIL_SUBJECT.eml
Email attachment ATTACHMENT_NAME. ATTACHMENT_EXTENSION
Risultato JSON

Il seguente esempio descrive l'output del risultato JSON ricevuto quando si utilizza l'azione Salva email nella richiesta:

{
   "id": "ID",
   "thread_id": "THREAD_ID",
   "label_ids": [
       "CATEGORY_PERSONAL",
       "INBOX"
   ],
   "snippet": "SNIPPET",
   "history_id": "10576",
   "internal_date": 1728217410000,
   "message_id": "<CAAfJ0RiApRCW7jbTMQdjia+cnzrsWR4UNbB4x94srTZHaEG+Vw@example.com>",
   "subject": "SUBJECT",
   "from": "example@example.com",
   "headers": {
       "delivered-to": "email@example.com",
       "received": [
           "by 2002:a096512 named unknown by gmailapi.google.com with HTTPREST; Sun, 6 Oct 2024 12:23:30 +0000"
       ],
       "x-google-smtp-source": "AGHT+IEq/FCBnUtDRgoabTbX8/z1dIKeKteo3Ic5+sbufKyI22pP1gK1soG9jSmV7dMEQXlIVdRf",
       "x-received": [
           "by 2002:a05:620a:0:b0:374:ce15:9995 with SMTP id ffacd0b85a97d-37d0e78253cmr6681102f8f.34.1728217410309; Sun, 06 Oct 2024 05:23:30 -0700 (PDT)"
       ],
       "arc-seal": "i=1; aLC/Hhaf3TqCPqGGiSfvDT7bxtQp1lz         c9xg==",
       "arc-message-signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605;        h=to:subject:message-id:datG+AhKivQ7tcf2K8m9B/lexnQw/puC+acDzdYkIqU6         o4ne1qpcJKc32l6V0+ggtGSuHFvp6ySOZkhLJqei9RXBd6HPV3Yj5nVexbhlFuH29w3E         KpGg==;        dara=google.com",
       "arc-authentication-results": "i=1; mx.google.com;       dkim=pass header.i=@labilfrom=example@example.com;       dara=pass header.i=@example.com",
   },
   "mimetype": "text/plain",
   "text_bodies": [
       "example\r\n"
   ],
   "html_bodies": [],
   "file_attachments": [],
   "date": "Sun, 6 Oct 2024 12:23:30 +0000",
   "to": "email@example.com",
   "cc": null,
   "bcc": null,
   "in-reply-to": null,
   "reply-to": null
}
Messaggi di output

L'azione Salva email nella richiesta fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Successfully saved the INTERNET_MESSAGE_ID email.

Successfully saved the following attachments from the INTERNET_MESSAGE_ID email: ATTACHMENT_NAMES

The following attachments were not found in the INTERNET_MESSAGE_ID email: ATTACHMENT_NAMES

 L'azione è riuscita.
Error executing action "Save Email To The Case". Reason: ERROR_REASON

L'azione non è riuscita.

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

La seguente tabella descrive i valori dell'output del risultato dello script quando si utilizza l'azione Salva email nella richiesta:

Nome del risultato dello script Valore
is_success True o False

Ricercare email

Utilizza l'azione Cerca email per eseguire la ricerca di email in una casella di posta specificata utilizzando i criteri di ricerca forniti.

Questa azione è asincrona. Modifica il timeout dell'azione nell'IDE di Google SecOps di conseguenza.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Cerca email richiede i seguenti parametri:

Parametro Descrizione
Mailbox Obbligatorio

Una casella di posta in cui attendere una risposta, ad esempio user@example.com.

Per impostazione predefinita, l'azione utilizza la casella di posta predefinita che hai configurato per l'integrazione. Questo parametro accetta più valori come elenco separato da virgole.
Labels Filter Optional

Una condizione di filtro che specifica le etichette email da cercare.

Questo parametro accetta più valori come una stringa separata da virgole.

Il valore predefinito è Inbox.

Puoi cercare email con etichette specifiche, ad esempio label1, label2. Per cercare le email che non hanno l'etichetta specifica, utilizza il seguente formato: -label1. Puoi configurare questo parametro per cercare email con e senza etichette specifiche in una sola stringa, ad esempio label1, -label2, label3.
Internet Message ID Optional

L'ID messaggio internet di un'email da cercare.

Questo parametro accetta più valori come stringa separata da virgole.

Se fornisci l'ID messaggio internet, l'azione ignora i parametri Subject Filter, Sender Filter, Labels Filter, Recipient Filter, Time Frame (minutes) e Email Status.
Subject Filter Optional

Una condizione di filtro che specifica l'oggetto dell'email da cercare.
Sender Filter Optional

Una condizione di filtro che specifica il mittente email da cercare.
Recipient Filter Optional

Una condizione di filtro che specifica il destinatario email da cercare.
Time Frame (minutes) Optional

Una condizione di filtro che specifica l'intervallo di tempo in minuti in cui cercare le email.

Il valore predefinito è 60 minuti.
Email Status Optional

Lo stato dell'email da cercare.

I valori possibili sono:

  • Only Unread Messages
  • Only Read Messages
  • Both Read & Unread Messages

Il valore predefinito è Both Read & Unread Messages.
Headers To Return Optional

Un elenco separato da virgole di intestazioni da restituire nell'output dell'azione.

L'azione restituisce sempre le seguenti intestazioni: date, from, to, cc, bcc, in-reply-to, reply-to, message-id, e subject.

Se non fornisci alcun valore, l'azione restituisce tutte le intestazioni.

Questo parametro non distingue tra maiuscole e minuscole.
Return Email Body Optional

Se selezionata, l'azione restituisce il contenuto completo del corpo di un'email nell'output dell'azione. Se non è selezionata, le informazioni sui nomi degli allegati nell'email non sono disponibili.

Non selezionato per impostazione predefinita.
Max Emails To Return Optional

Il numero massimo di email da restituire per l'azione.

Il valore predefinito è 50.

Output dell'azione

L'azione Cerca email fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca richieste 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 Cerca email fornisce la seguente tabella:

Titolo della tabella: Found Mails

Colonne:

  • Message_id
  • Data di ricezione
  • Mittente
  • Destinatari
  • Oggetto
  • Snippet del corpo dell'email
  • Nomi degli allegati
  • (Facoltativo) Trovato nella casella di posta
Risultato JSON

L'esempio seguente descrive l'output del risultato JSON ricevuto quando si utilizza l'azione Cerca email:

[
   {
       "Entity": "email@example.com",
       "EntityResult": [
           {
               "id": "ID",
               "thread_id": "THREAD_ID",
               "label_ids": [
                   "CATEGORY_PERSONAL",
                   "INBOX"
               ],
               "snippet": "SNIPPET",
               "history_id": "10576",
               "internal_date": 1728217410000,
               "message_id": "<CAAfJ0RiApRCW7jbTMQdjia+cnzrsWR4UNbB4x94srTZHaEG+Vw@example.com>",
               "subject": "SUBJECT",
               "from": "example@example.com",
               "headers": {
                   "delivered-to": "email@example.com",
                   "received": [
                       "by 2002:a096512 named unknown by gmailapi.google.com with HTTPREST; Sun, 6 Oct 2024 12:23:30 +0000"
                   ],
                   "x-google-smtp-source": "AGHT+IEq/FCBnUtDRgoabTbX8/z1dIKeKteo3Ic5+sbufKyI22pP1gK1soG9jSmV7dMEQXlIVdRf",
                   "x-received": [
                       "by 2002:a05:620a:0:b0:374:ce15:9995 with SMTP id ffacd0b85a97d-37d0e78253cmr6681102f8f.34.1728217410309; Sun, 06 Oct 2024 05:23:30 -0700 (PDT)"
                   ],
                   "arc-seal": "i=1; aLC/Hhaf3TqCPqGGiSfvDT7bxtQp1lz         c9xg==",
                   "arc-message-signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605;        h=to:subject:message-id:datG+AhKivQ7tcf2K8m9B/lexnQw/puC+acDzdYkIqU6         o4ne1qpcJKc32l6V0+ggtGSuHFvp6ySOZkhLJqei9RXBd6HPV3Yj5nVexbhlFuH29w3E         KpGg==;        dara=google.com",
                   "arc-authentication-results": "i=1; mx.google.com;       dkim=pass header.i=@labilfrom=example@example.com;       dara=pass header.i=@example.com",
               },
               "mimetype": "text/plain",
               "text_bodies": [
                   "text\r\n"
               ],
               "html_bodies": [],
               "file_attachments": [],
               "date": "Sun, 6 Oct 2024 12:23:30 +0000",
               "to": "email@example.com",
               "cc": null,
               "bcc": null,
               "in-reply-to": null,
               "reply-to": null
           }
       ]
   }
]
Messaggi di output

L'azione Cerca email fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Successfully found emails in the following mailboxes: MAILBOX_LIST

No emails found in the following mailboxes: MAILBOX_LIST

Pending search for emails in the following mailboxes: MAILBOX_LIST

The following mailboxes were not found: MAILBOX_LIST. Please check the spelling.

The action was not able to find any emails based on the specified search criteria.

 L'azione è riuscita.
Error executing action "Search For Emails". Reason: ERROR_REASON

L'azione non è riuscita.

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

La tabella seguente descrive i valori dell'output del risultato dello script quando utilizzi l'azione Cerca email:

Nome del risultato dello script Valore
is_success True o False

Invia email

Utilizza l'azione Invia email per inviare un'email in base ai parametri forniti.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Invia email richiede i seguenti parametri:

Parametro Descrizione
Mailbox Obbligatorio

Una casella di posta da cui inviare un'email, ad esempio user@example.com.

Per impostazione predefinita, l'azione utilizza la casella di posta predefinita che hai configurato per l'integrazione.
Subject Obbligatorio

L'oggetto di un'email da inviare.
Send To Obbligatorio

Una stringa di indirizzi email separati da virgole per i destinatari dell'email, ad esempio user1@example.com, user2@example.com.

CC Optional

Una stringa di indirizzi email separati da virgole per i destinatari dell'email in copia conoscenza (CC), ad esempio user1@example.com, user2@example.com.
BCC Optional

Una stringa di indirizzi email separati da virgole per i destinatari dell'email in copia carbone nascosta (CCN), ad esempio user1@example.com, user2@example.com
Attachments Paths Optional

Stringa di percorsi separati da virgole per gli allegati dei file archiviati sul server Google SecOps.
Mail Content Obbligatorio

Il corpo dell'email.
Reply-To Recipients Optional

Un elenco separato da virgole di destinatari da utilizzare nell'intestazione Rispondi a.

Utilizza l'intestazione Rispondi a per reindirizzare le email di risposta all'indirizzo email specifico anziché all'indirizzo del mittente indicato nel campo Da.

Output dell'azione

L'azione Invia email fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca richieste 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 descrive l'output del risultato JSON ricevuto quando si utilizza l'azione Invia email:

{
   "id": "ID",
   "thread_id": "THREAD_ID",
   "label_ids": [
       "CATEGORY_PERSONAL",
       "INBOX"
   ],
   "snippet": "SNIPPET",
   "history_id": "10576",
   "internal_date": 1728217410000,
   "message_id": "<CAAfJ0RiApRCW7jbTMQdjia+cnzrsWR4UNbB4x94srTZHaEG+Vw@example.com>",
   "subject": "SUBJECT",
   "from": "example@example.com",
   "headers": {
       "delivered-to": "email@example.com",
       "received": [
           "by 2002:a096512 named unknown by gmailapi.google.com with HTTPREST; Sun, 6 Oct 2024 12:23:30 +0000"
       ],
       "x-google-smtp-source": "AGHT+IEq/FCBnUtDRgoabTbX8/z1dIKeKteo3Ic5+sbufKyI22pP1gK1soG9jSmV7dMEQXlIVdRf",
       "x-received": [
           "by 2002:a05:620a:0:b0:374:ce15:9995 with SMTP id ffacd0b85a97d-37d0e78253cmr6681102f8f.34.1728217410309; Sun, 06 Oct 2024 05:23:30 -0700 (PDT)"
       ],
       "arc-seal": "i=1; aLC/Hhaf3TqCPqGGiSfvDT7bxtQp1lz         c9xg==",
       "arc-message-signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605;        h=to:subject:message-id:datG+AhKivQ7tcf2K8m9B/lexnQw/puC+acDzdYkIqU6         o4ne1qpcJKc32l6V0+ggtGSuHFvp6ySOZkhLJqei9RXBd6HPV3Yj5nVexbhlFuH29w3E         KpGg==;        dara=google.com",
       "arc-authentication-results": "i=1; mx.google.com;       dkim=pass header.i=@labilfrom=example@example.com;       dara=pass header.i=@example.com",
   },
   "mimetype": "text/plain",
   "text_bodies": [
       "example\r\n"
   ],
   "html_bodies": [],
   "file_attachments": [],
   "date": "Sun, 6 Oct 2024 12:23:30 +0000",
   "to": "email@example.com",
   "cc": null,
   "bcc": null,
   "in-reply-to": null,
   "reply-to": null
}
Messaggi di output

L'azione Invia email fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Email was sent successfully. L'azione è riuscita.
Error executing action "Send Email". Reason: ERROR_REASON

L'azione non è riuscita.

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

La seguente tabella descrive i valori per l'output del risultato dello script quando si utilizza l'azione Invia email:

Nome del risultato dello script Valore
is_success True o False

Invia risposta al thread

Utilizza l'azione Invia risposta al thread per inviare un messaggio come risposta al thread dell'email.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Invia risposta al thread richiede i seguenti parametri:

Parametro Descrizione
Mailbox Obbligatorio

Una casella di posta in cui attendere una risposta, ad esempio user@example.com.

Per impostazione predefinita, l'azione utilizza la casella di posta predefinita che hai configurato per l'integrazione.
Internet Message ID Obbligatorio

L'ID messaggio internet di un'email da cercare.
Reply To Optional

Un elenco di indirizzi email separati da virgole a cui inviare la risposta.

Se non fornisci alcun valore e la casella di controllo Reply All è deselezionata, l'azione invia una risposta solo al mittente email originale. Se selezioni il parametro Reply All, l'azione lo ignora.
Reply All Optional

Se selezionata, l'azione invia una risposta a tutti i destinatari correlati all'email originale.

Questo parametro ha la priorità sul parametro Reply To.

Non selezionato per impostazione predefinita.
Attachments Paths Optional

Stringa di percorsi separati da virgole per gli allegati dei file archiviati sul server Google SecOps.
Mail Content Obbligatorio

Il corpo dell'email.

Output dell'azione

L'azione Invia risposta al thread fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca richieste 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

Il seguente esempio descrive l'output del risultato JSON ricevuto quando si utilizza l'azione Invia risposta al thread:

{
   "id": "ID",
   "thread_id": "THREAD_ID",
   "label_ids": [
       "CATEGORY_PERSONAL",
       "INBOX"
   ],
   "snippet": "SNIPPET",
   "history_id": "10576",
   "internal_date": 1728217410000,
   "message_id": "<CAAfJ0RiApRCW7jbTMQdjia+cnzrsWR4UNbB4x94srTZHaEG+Vw@example.com>",
   "subject": "SUBJECT",
   "from": "example@example.com",
   "headers": {
       "delivered-to": "email@example.com",
       "received": [
           "by 2002:a096512 named unknown by gmailapi.google.com with HTTPREST; Sun, 6 Oct 2024 12:23:30 +0000"
       ],
       "x-google-smtp-source": "AGHT+IEq/FCBnUtDRgoabTbX8/z1dIKeKteo3Ic5+sbufKyI22pP1gK1soG9jSmV7dMEQXlIVdRf",
       "x-received": [
           "by 2002:a05:620a:0:b0:374:ce15:9995 with SMTP id ffacd0b85a97d-37d0e78253cmr6681102f8f.34.1728217410309; Sun, 06 Oct 2024 05:23:30 -0700 (PDT)"
       ],
       "arc-seal": "i=1; aLC/Hhaf3TqCPqGGiSfvDT7bxtQp1lz         c9xg==",
       "arc-message-signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605;        h=to:subject:message-id:datG+AhKivQ7tcf2K8m9B/lexnQw/puC+acDzdYkIqU6         o4ne1qpcJKc32l6V0+ggtGSuHFvp6ySOZkhLJqei9RXBd6HPV3Yj5nVexbhlFuH29w3E         KpGg==;        dara=google.com",
       "arc-authentication-results": "i=1; mx.google.com;       dkim=pass header.i=@labilfrom=example@example.com;       dara=pass header.i=@example.com",
   },
   "mimetype": "text/plain",
   "text_bodies": [
       "text\r\n"
   ],
   "html_bodies": [],
   "file_attachments": [],
   "date": "Sun, 6 Oct 2024 12:23:30 +0000",
   "to": "email@example.com",
   "cc": null,
   "bcc": null,
   "in-reply-to": null,
   "reply-to": null
}
Messaggi di output

L'azione Invia risposta al thread fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully sent a thread reply to the INTERNET_MESSAGE_ID email. L'azione è riuscita.
Error executing action "Sent Thread Reply". Reason: ERROR_REASON

L'azione non è riuscita.

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

La seguente tabella descrive i valori per l'output del risultato dello script quando si utilizza l'azione Invia risposta al thread:

Nome del risultato dello script Valore
is_success True o False

Wait For Thread Reply

Utilizza l'azione Attendi risposta thread per attendere la risposta dell'utente in base a un'email inviata utilizzando l'azione Invia email.

Questa azione è asincrona. Modifica il timeout dell'azione nell'IDE di Google SecOps di conseguenza.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Attendi risposta thread richiede i seguenti parametri:

Parametro Descrizione
Mailbox Obbligatorio

Una casella di posta in cui attendere una risposta, ad esempio user@example.com.

Per impostazione predefinita, l'azione utilizza la casella di posta predefinita che hai configurato per l'integrazione. Questo parametro accetta più valori come elenco separato da virgole.
Internet Message ID Obbligatorio

L'ID messaggio internet di un'email per l'azione da attendere. Se il messaggio è stato inviato utilizzando l'azione Invia email, configura questo parametro utilizzando il segnaposto SendEmail.JSONResult|message_id.

Per recuperare un ID messaggio internet, utilizza l'azione Cerca email.
Wait for All Recipients to Reply Optional

Se selezionata, l'azione attende le risposte di tutti i destinatari fino al raggiungimento del timeout.

Non selezionato per impostazione predefinita.
Fetch Response Attachments Optional

Se selezionata e la risposta del destinatario contiene allegati, l'azione recupera gli allegati email e li aggiunge come allegato alla bacheca della richiesta in Google SecOps.

Non selezionato per impostazione predefinita.

Output dell'azione

L'azione Attendi risposta thread fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca casi Non disponibile
Link alla bacheca richieste 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

Il seguente esempio descrive l'output del risultato JSON ricevuto quando si utilizza l'azione Attendi risposta thread:

[
   {
       "Entity": "reply@example.com",
       "EntityResult": [
           {
               "id": "ID",
               "thread_id": "THREAD_ID",
               "label_ids": [
                   "CATEGORY_PERSONAL",
                   "INBOX"
               ],
               "snippet": "SNIPPET",
               "history_id": "10576",
               "internal_date": 1728217410000,
               "message_id": "<CAAfJ0RiApRCW7jbTMQdjia+cnzrsWR4UNbB4x94srTZHaEG+Vw@example.com>",
               "subject": "SUBJECT",
               "from": "example@example.com",
               "headers": {
                   "delivered-to": "reply@example.com",
                   "received": [
                       "by 2002:a096512 named unknown by gmailapi.google.com with HTTPREST; Sun, 6 Oct 2024 12:23:30 +0000"
                   ],
                   "x-google-smtp-source": "AGHT+IEq/FCBnUtDRgoabTbX8/z1dIKeKteo3Ic5+sbufKyI22pP1gK1soG9jSmV7dMEQXlIVdRf",
                   "x-received": [
                       "by 2002:a05:620a:0:b0:374:ce15:9995 with SMTP id ffacd0b85a97d-37d0e78253cmr6681102f8f.34.1728217410309; Sun, 06 Oct 2024 05:23:30 -0700 (PDT)"
                   ],
                   "arc-seal": "i=1; aLC/Hhaf3TqCPqGGiSfvDT7bxtQp1lz         c9xg==",
                   "arc-message-signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605;        h=to:subject:message-id:datG+AhKivQ7tcf2K8m9B/lexnQw/puC+acDzdYkIqU6         o4ne1qpcJKc32l6V0+ggtGSuHFvp6ySOZkhLJqei9RXBd6HPV3Yj5nVexbhlFuH29w3E         KpGg==;        dara=google.com",
                   "arc-authentication-results": "i=1; mx.google.com;       dkim=pass header.i=@labilfrom=example@example.com;       dara=pass header.i=@example.com",
               },
               "mimetype": "text/plain",
               "text_bodies": [
                   "text\r\n"
               ],
               "html_bodies": [],
               "file_attachments": [],
               "date": "Sun, 6 Oct 2024 12:23:30 +0000",
               "to": "reply@example.com",
               "cc": null,
               "bcc": null,
               "in-reply-to": null,
               "reply-to": null
           }
       ]
   }
]
Messaggi di output

L'azione Attendi risposta al thread fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio

Found replies from the following users: USERS

Waiting for replies from the following users: USERS

 L'azione è riuscita.
Error executing action "Wait For Thread Reply". Reason: ERROR_REASON

L'azione non è riuscita.

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

La seguente tabella descrive i valori per l'output del risultato dello script quando utilizzi l'azione Attendi risposta thread:

Nome del risultato dello script Valore
is_success True o False

Connettori

Per istruzioni dettagliate su come configurare un connettore in Google SecOps, consulta Importare i dati (connettori).

Connettore Gmail

Utilizza il connettore Gmail per recuperare le email di Gmail da una casella di posta specificata.

Il connettore Gmail non acquisisce le email con l'etichetta Pianificata per i seguenti motivi:

  • Il connettore acquisisce solo le email inviate. L'etichetta Programmato indica che le email sono solo programmate, non inviate.
  • Il connettore richiede i timestamp per recuperare le email. Le email programmate non hanno timestamp.

Input del connettore

Il connettore Gmail richiede i seguenti parametri:

Parametro Descrizione
Product Field Name Obbligatorio

Il nome del campo in cui è memorizzato il nome del prodotto.

Il valore predefinito è device_product.
Event Field Name Obbligatorio

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

Il valore predefinito è event_name.
Environment Field Name Optional

Il nome del campo in cui è memorizzato il nome dell'ambiente.

Se il campo ambiente non viene trovato, l'ambiente viene impostato su "".

Environment Regex Pattern Optional

Un pattern di espressione regolare da eseguire sul valore trovato nel campo Environment Field Name. Questo parametro ti consente di manipolare il campo dell'ambiente utilizzando la logica delle espressioni regolari.

Utilizza il valore predefinito .* per recuperare il valore Environment Field Name grezzo richiesto.

Se il pattern dell'espressione regolare è nullo o vuoto oppure il valore dell'ambiente è nullo, il risultato finale dell'ambiente è "".
Email Exclude Pattern Optional

Un'espressione regolare per escludere email specifiche dall'importazione, ad esempio spam o notizie.

Questo parametro funziona sia con l'oggetto sia con il corpo di un'email. Ad esempio, per escludere le email di risposta automatica dall'importazione, puoi configurare la seguente espressione regolare: (?i)(auto|no)(\s|-)?re(ply|sponse|sponder).
Script Timeout (Seconds) Obbligatorio

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

Il valore predefinito è 300 secondi.
Service Account JSON File Content Optional

Il contenuto del file JSON della chiave dell'account di servizio.

Puoi configurare questo parametro o il parametro Workload Identity Email.

Per configurare questo parametro, fornisci l'intero contenuto del file JSON della chiave dell'account di servizio che hai scaricato durante la creazione di un account di servizio.
Workload Identity Email Optional

L'indirizzo email client del tuo account di servizio.

Puoi configurare questo parametro o il parametro Service Account JSON File Content.

Per simulare l'identità dei service account con i carichi di lavoro, concedi il ruolo Service Account Token Creator al tuo account di servizio Google SecOps.
Disable Overflow Optional

Se selezionato, il connettore ignora il meccanismo di overflow di Google SecOps durante la creazione degli avvisi.

Non selezionato per impostazione predefinita.
Default Mailbox Obbligatorio

Un indirizzo email da utilizzare come casella di posta predefinita per l'integrazione, ad esempio user@example.com.
Labels Filter Optional

Le etichette delle email da importare in Google SecOps.

Il connettore supporta le etichette nidificate. Fornisci le etichette in un formato accettabile per Gmail, ad esempio Inbox-label1-label2.
Email Status Optional

Lo stato dell'email da cercare.

I valori possibili sono:

  • Both
  • Read
  • Unread
Il valore predefinito è Both.
Extract Headers Optional

Valori dell'intestazione da filtrare dall'elenco internetMessageHeaders e da aggiungere a un evento Google SecOps.

Per impostazione predefinita, il connettore aggiunge tutte le intestazioni all'evento. Per aggiungere solo intestazioni specifiche, inseriscile come elenco separato da virgole, ad esempio DKIM-Siganture, Received, From. Per impedire al connettore di aggiungere un'intestazione, inserisci il valore None.

Questo parametro non distingue tra maiuscole e minuscole.
Attached Mail File Prefix Optional

Un prefisso da aggiungere alle chiavi evento estratte (ad esempio to, from o subject) dal file email allegato ricevuto nella casella di posta monitorata.

Il valore predefinito è attach.
Original Received Mail Prefix Optional

Un prefisso da aggiungere alle chiavi evento estratte (ad esempio, to, from o subject) dall'email originale ricevuta nella casella di posta monitorata.

Il valore predefinito è orig.
Attach Original EML Optional

Se selezionato, il connettore allega l'email originale alle informazioni della richiesta come file EML (Elements Markup Language).

Non selezionato per impostazione predefinita.

Create Alert Per Attachment File Optional

Se selezionato, il connettore crea più avvisi, con un avviso per ogni file email allegato.

Questo comportamento è utile quando elabori email con più file email allegati e imposti la mappatura degli eventi di Google SecOps per creare entità da file email allegati.

Non selezionato per impostazione predefinita.
Max Emails Per Cycle Optional

Il numero massimo di email da recuperare per ogni iterazione del connettore.

Il numero massimo è 100. Il valore predefinito è 10.
Max Hours Backwards Optional

Numero di ore prima della prima iterazione del connettore da cui recuperare gli incidenti. Questo parametro si applica all'iterazione iniziale del connettore dopo l'attivazione del connettore per la prima volta o al valore di riserva per un timestamp del connettore scaduto.

Il valore predefinito è 24.
Case Name Template Optional

Un nome di richiesta personalizzato.

Quando configuri questo parametro, il connettore aggiunge una nuova chiave chiamata custom_case_name all'evento Google SecOps.

Puoi fornire i segnaposto nel seguente formato: [name of the field].

Esempio: Phishing - [event_mailbox].

Per i segnaposto, il connettore utilizza il primo evento Google SecOps. Il connettore gestisce solo le chiavi contenenti il valore stringa. Per configurare questo parametro, specifica i campi evento senza prefissi.
Alert Name Template Optional

Un nome avviso personalizzato.

Puoi fornire i segnaposto nel seguente formato: [name of the field].

Esempio: Phishing - [event_mailbox].

Per i segnaposto, il connettore utilizza il primo evento Google SecOps SOAR. Il connettore gestisce solo le chiavi contenenti il valore stringa. Se non fornisci alcun valore o un modello non valido, il connettore utilizza il nome dell'avviso predefinito. Per configurare questo parametro, specifica i campi evento senza prefissi.
Verify SSL Obbligatorio

Se selezionata, l'integrazione verifica che il certificato SSL per la connessione a Gmail sia valido. Questa opzione è selezionata per impostazione predefinita.
Proxy Server Address Optional

L'indirizzo del server proxy da utilizzare.
Proxy Username Optional

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

La password del proxy per l'autenticazione.

Regole del connettore

Gmail Connector supporta l'elenco dinamico.

Per filtrare valori specifici dal corpo e dall'oggetto dell'email, utilizza le espressioni regolari dell'elenco dinamico nel seguente formato: key: regex, ad esempio subject: (?<=Subject: ).*. Ad esempio, dopo aver trovato una corrispondenza per l'espressione regolare subject: (?<=Subject: ).*, il connettore crea un evento di avviso di Google SecOps e vi aggiunge una nuova chiave con il nome subject. Il nuovo valore della chiave corrisponde all'espressione regolare.

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