Integra Microsoft Graph Mail con Google SecOps

Microsoft Graph Mail   |  Microsoft Graph Mail Delegated

Questo documento spiega come integrare Microsoft Graph Mail con Google Security Operations (Google SecOps).

Prima di iniziare

Prima di configurare l'integrazione di Microsoft Graph Mail:

1. Crea l'applicazione Microsoft Entra.

2. Configura le autorizzazioni API per la tua applicazione.

3. Crea un client secret.

Crea l'applicazione Microsoft Entra

Per creare l'app Microsoft Entra, completa i seguenti passaggi:

1. Accedi al portale Azure come amministratore utenti o amministratore delle password.

2. Seleziona Microsoft Entra ID.

3. Vai a Registrazioni app > Nuova registrazione.

4. Inserisci il nome dell'applicazione.

5. Fai clic su Register (Registrati).

   Questo documento fornisce un esempio che utilizza una configurazione single-tenant. Poiché questa integrazione utilizza il flusso delle credenziali client OAuth 2.0, non si verifica l'accesso interattivo dell'utente. Pertanto, non è necessario un Redirect URI.

6. Salva i valori di ID applicazione (client) e ID directory (tenant) per configurare i parametri di integrazione.

Configura le autorizzazioni API

Per configurare le autorizzazioni API per l'integrazione, completa i seguenti passaggi:

1. Nel portale Azure, vai ad API Permissions (Autorizzazioni API) > Add a permission (Aggiungi un'autorizzazione).

2. Seleziona Microsoft Graph > Autorizzazioni applicazione.

3. Nella sezione Seleziona autorizzazioni, seleziona le seguenti autorizzazioni obbligatorie:

   • Mail.Read
   • Mail.ReadWrite
   • Mail.Send
   • User.Read
   • Directory.Read.All
   Nota: questa integrazione supporta le caselle postali condivise. Per impostazione predefinita, la concessione delle autorizzazioni dell'applicazione consente all'integrazione di leggere le caselle postali nell'intero tenant. Per limitare l'accesso solo a caselle postali condivise specifiche, configura un criterio di accesso alle applicazioni Microsoft.

4. Fai clic su Aggiungi autorizzazioni.

5. Fai clic su Concedi il consenso amministratore per ORGANIZATION_NAME.

   Quando viene visualizzata la finestra di dialogo Conferma consenso amministratore, fai clic su Sì.

Limita l'accesso alle applicazioni a caselle di posta specifiche

Per impostazione predefinita, le applicazioni con autorizzazioni Mail.ReadWrite o Mail.Send hanno accesso a tutte le caselle postali della tua organizzazione. Per limitare l'accesso dell'applicazione solo a caselle postali specifiche, configura i criteri di accesso alle applicazioni in Microsoft Exchange Online.

Per configurare i criteri di accesso alle applicazioni, completa i seguenti passaggi:

1. Connettiti a Exchange Online PowerShell:

   1. Apri PowerShell come amministratore.

   2. Installa il modulo di gestione di Exchange Online (se non è già installato):

      Install-Module -Name ExchangeOnlineManagement
      

   3. Connettiti a Exchange Online:

      Connect-ExchangeOnline
      

2. Identifica l'ID applicazione e le caselle postali di destinazione:

   1. Ottieni l'ID client (ID applicazione) dell'applicazione Microsoft Graph Mail da Azure AD.

   2. Identifica gli indirizzi email delle caselle postali a cui vuoi che l'applicazione acceda. Per semplificare la gestione, crea un gruppo di sicurezza abilitato alla posta in Azure AD e aggiungi queste caselle postali come membri.

3. Crea una policy di accesso all'applicazione:

   1. Utilizza il cmdlet New-ApplicationAccessPolicy per creare una policy che limita l'accesso alle caselle postali selezionate.

   2. (Facoltativo) Limita l'accesso a un gruppo di sicurezza specifico di caselle postali:

      1. Sostituisci <Your_Application_ID> con l'ID client della tua applicazione.

      2. Sostituisci <Security_Group_Email_Address> con l'indirizzo email del gruppo di sicurezza contenente le caselle postali consentite.

      New-ApplicationAccessPolicy -AppId "<Your_Application_ID>" -PolicyScopeGroupId "<Security_Group_Email_Address>" -AccessRight RestrictAccess -Description "SOAR Graph Mail Access Policy"
      

4. Verifica l'efficacia della policy utilizzando il cmdlet Test-ApplicationAccessPolicy:

      Test-ApplicationAccessPolicy -AppId "<Your_Application_ID>" -Identity "[e-mail]"
   

   Questo comando indica se l'applicazione ha accesso alla casella di posta specificata in base ai criteri applicati.

Nota:

• Per creare queste policy sono necessarie le autorizzazioni OrganizationManagement o Security Administrator in Exchange Online.

• In genere, le modifiche ai criteri diventano effettive entro 30 minuti.

• Dopo l'applicazione della policy, l'applicazione può accedere solo alle caselle postali consentite. I tentativi di accesso di altri utenti restituiranno un errore Access Denied.

Crea un client secret

Per creare un client secret, completa i seguenti passaggi:

1. Vai a Certificati e secret > Nuovo client secret.

2. Fornisci una descrizione per un client secret e imposta la relativa scadenza.

3. Fai clic su Aggiungi.

4. Salva il valore del client secret (non l'ID secret) per utilizzarlo come valore parametro ID secret quando configuri l'integrazione. Il valore del client secret viene visualizzato una sola volta.

Importante: se modifichi le autorizzazioni dell'applicazione di Microsoft Graph dopo aver configurato questa integrazione, rigenera il client secret, se necessario, e aggiorna la configurazione dell'integrazione. Le credenziali esistenti non riceveranno automaticamente le autorizzazioni appena concesse.

Parametri di integrazione

L'integrazione di Microsoft Graph Mail richiede i seguenti parametri:

Parametro	Descrizione
Azure AD Endpoint	Obbligatorio. L'endpoint Microsoft Entra ID da utilizzare nell'integrazione. Il valore può variare a seconda dei tipi di tenant. Il valore predefinito è https://login.microsoftonline.com.
Microsoft Graph Endpoint	Obbligatorio. L'endpoint Microsoft Graph da utilizzare nell'integrazione. Il valore può variare a seconda dei tipi di tenant. Il valore predefinito è https://graph.microsoft.com.
Client ID	Obbligatorio. L'ID applicazione client di Microsoft Entra da utilizzare nell'integrazione.
Secret ID	Obbligatorio. Il valore del client secret dell'applicazione Microsoft Entra da utilizzare nell'integrazione.
Tenant	Obbligatorio. Il valore di Microsoft Entra ID (ID tenant).
Default Mailbox	Obbligatorio. La casella di posta da utilizzare nell'integrazione.
Mail Field Source	Facoltativo. Se selezionata, l'integrazione recupera l'indirizzo della casella di posta dall'attributo mail dei dettagli utente. Se non viene selezionata, l'integrazione recupera l'indirizzo della casella di posta dal campo userPrincipalName. Non selezionato per impostazione predefinita.
Verify SSL	Obbligatorio. Se selezionata, l'integrazione convalida il certificato SSL quando si connette al server Microsoft Graph. Abilitato per impostazione predefinita.
Base64 Encoded Private Key	Facoltativo. La chiave privata codificata in Base64 utilizzata per decrittografare le email criptate con S/MIME. Se viene fornito un valore, devi specificare anche Base64 Encoded Certificate.
Base64 Encoded Certificate	Facoltativo. Il certificato con codifica Base64 utilizzato per decriptare le email criptate con S/MIME. Se viene fornito un valore, devi specificare anche Base64 Encoded Private Key.
Base64 Encoded CA certificate	Facoltativo. Il certificato CA attendibile con codifica Base64 per la verifica della firma. Se non viene fornito alcun valore, la verifica della firma per le email firmate in entrata non va a buon fine, a meno che non sia abilitato Bypass S/MIME Signature Verification.

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 Supportare più istanze.

Azioni

Per ulteriori informazioni sulle azioni, vedi Rispondere alle azioni in attesa dalla tua scrivania e Eseguire un'azione manuale.

Blocca dominio

Utilizza l'azione Blocca dominio per bloccare domini email specifici aggiungendoli a una regola di messaggistica nella casella di posta di destinazione. Se la regola non esiste, viene creata.

Questa azione è asincrona. Regola il timeout dell'azione nell'ambiente di sviluppo integrato (IDE) di Google SecOps in base alle esigenze.

Input azione

L'azione Blocca dominio richiede i seguenti parametri:

Parametro	Descrizione
Domains	Facoltativo. Elenco separato da virgole dei domini mittente da bloccare (ad esempio, example.com). I domini inseriti manualmente in questo campo e i domini estratti dinamicamente dalle entità funzionano insieme e verranno aggiunti alle condizioni della regola.
Mailboxes	Obbligatorio. Il valore predefinito è Default Mailbox. Le caselle postali a cui verrà aggiunta la regola per i messaggi. Può essere un elenco separato da virgole di nomi principali utente.
Rule Name	Obbligatorio. Il valore predefinito è Google SecOps - Blocked Domains. Nome della regola del messaggio a cui aggiungere questi domini. Se la regola esiste, verrà aggiornata.
Action	Obbligatorio. Il valore predefinito è Select One. Azione da intraprendere per questi domini. Valori possibili: Select One, Move To Junk, Delete. Move To Junk li sposterà nella cartella Posta indesiderata, mentre Delete li indirizzerà a Elementi eliminati. Select One conserva l'azione esistente se la regola esiste.
How many mailboxes to process in a single batch	Facoltativo. Il valore predefinito è 20. Specifica il numero di caselle postali che l'azione deve elaborare in un singolo batch.

Output azione

L'azione Blocca dominio fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Blocca dominio:

{
    "status": "Success",
    "mailbox": "[e-mail]",
    "blocked_domain": "malicious-domain.com"
}

Messaggi di output

L'azione Blocca dominio fornisce i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully blocked domain DOMAIN for mailbox MAILBOX.	Azione riuscita.
Failed to block domain DOMAIN for mailbox MAILBOX. Reason: ERROR_REASON	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 Blocca dominio:

Nome del risultato dello script	Valore
is_success	True o False

Blocca mittente

Utilizza l'azione Blocca mittente per bloccare i mittenti email specificati aggiungendoli a una regola di messaggistica nella casella di posta di destinazione. Se la regola non esiste, verrà creata.

Questa azione è asincrona. Regola il timeout dell'azione nell'ambiente di sviluppo integrato (IDE) di Google SecOps in base alle esigenze.

Input azione

L'azione Blocca mittente richiede i seguenti parametri:

Parametro	Descrizione
Senders	Facoltativo. Elenco separato da virgole degli indirizzi email del mittente da bloccare. I mittenti inseriti manualmente in questo campo e i mittenti estratti dinamicamente dalle entità funzionano insieme e verranno entrambi aggiunti alle condizioni della regola.
Mailboxes	Obbligatorio. Il valore predefinito è Default Mailbox. Le caselle postali a cui verrà aggiunta la regola per i messaggi. Può essere un elenco separato da virgole di nomi principali utente.
Rule Name	Obbligatorio. Il valore predefinito è Google SecOps - Blocked Senders. Nome della regola di messaggistica a cui aggiungere questi mittenti. Se la regola esiste, verrà aggiornata.
Action	Obbligatorio. Il valore predefinito è Select One. Azione da intraprendere per questi mittenti. Valori possibili: Select One, Move To Junk, Delete. Move To Junk li sposterà nella cartella Posta indesiderata, mentre Delete li indirizzerà a Elementi eliminati. Select One conserva l'azione esistente se la regola esiste.
How many mailboxes to process in a single batch	Facoltativo. Il valore predefinito è 20. Specifica il numero di caselle postali che l'azione deve elaborare in un singolo batch.

Output azione

L'azione Blocca mittente fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Blocca mittente:

[
  {
    "Entity": "[e-mail]",
    "EntityResult": {
      "successful_mailboxes": [
        "[e-mail]"
      ],
      "failed_mailboxes": []
    }
  }
]

Messaggi di output

L'azione Blocca mittente fornisce i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully blocked sender SENDER for mailbox MAILBOX.	Azione riuscita.
Failed to block sender SENDER for mailbox MAILBOX. Reason: ERROR_REASON	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 dei risultati dello script quando si utilizza l'azione Blocca mittente:

Nome del risultato dello script	Valore
is_success	True o False

Eliminare le email

Puoi utilizzare l'azione Elimina email per eliminare una o più email da una casella di posta. Questa azione elimina le email in base ai tuoi criteri di ricerca. Con le autorizzazioni appropriate, l'azione Elimina email può spostare le email in caselle di posta diverse.

Questa azione è asincrona. Regola il timeout dell'azione nell'ambiente di sviluppo integrato (IDE) di Google SecOps in base alle esigenze.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Elimina email richiede i seguenti parametri:

Parametro	Descrizione
Delete In Mailbox	Obbligatorio. La casella di posta predefinita in cui eseguire l'operazione di eliminazione. Se le autorizzazioni lo consentono, l'azione può cercare anche in altre caselle postali. Questo parametro accetta più valori come stringa separata da virgole.
Folder Name	Obbligatorio. Una cartella della casella di posta in cui cercare l'email. Per specificare una sottocartella, utilizza la barra (/) /, ad esempio Inbox/Subfolder.
Mail IDs	Facoltativo Una condizione di filtro per cercare email con ID email specifici. Questo parametro accetta un elenco separato da virgole di ID email da cercare. Se viene fornito questo parametro, la ricerca ignora i parametri Subject Filter e Sender Filter.
Subject Filter	Facoltativo Una condizione di filtro che specifica l'oggetto dell'email da cercare.
Sender Filter	Facoltativo Una condizione di filtro che specifica il mittente delle email richieste.
Timeframe (Minutes)	Facoltativo Una condizione di filtro che specifica l'intervallo di tempo in minuti in cui cercare le email.
Only Unread	Facoltativo Se selezionata, l'azione cerca solo le email non lette. Non selezionato per impostazione predefinita.
How many mailboxes to process in a single batch	Facoltativo Il numero di caselle postali da elaborare in un singolo batch (singola connessione al server di posta). Il valore predefinito è 25.

Output azione

La tabella seguente descrive i tipi di output associati all'azione Elimina email:

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

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_NAME: DELETED_EMAILS_NUMBER Mailbox MAILBOX was not found.	Azione riuscita.
Action was not able to find any emails based on the specified search criteria. Action failed to delete any emails because the provided mailbox folder name was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER Failed to find any of the provided mailboxes: MAILBOX_LIST Failed to execute action, the error is: ERROR_REASON	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 Elimina email:

Nome del risultato dello script	Valore
is_success	True o False

Eliminare le regole di Posta in arrivo

Utilizza l'azione Elimina regole della posta in arrivo per eliminare una regola specificata per i messaggi della posta in arrivo per le caselle postali indicate. Questa azione è asincrona. Regola il timeout dell'azione nell'ambiente di sviluppo integrato (IDE) di Google SecOps in base alle esigenze.

Input azione

L'azione Elimina regole della posta in arrivo richiede i seguenti parametri:

Parametro	Descrizione
Mailboxes	Obbligatorio. Il valore predefinito è Default Mailbox. Le caselle di posta da cui verrà eliminata la regola per i messaggi. Può essere un elenco separato da virgole di nomi UPN principali degli utenti.
Rule Name	Obbligatorio. Il nome esatto della regola per i messaggi della posta in arrivo da eliminare.
How many mailboxes to process in a single batch	Facoltativo. Il valore predefinito è 25. Specifica il numero di caselle postali che l'azione deve elaborare in un singolo batch. Se non viene fornito alcun valore, verrà utilizzato il valore predefinito 25.

Output azione

L'azione Elimina regole della posta in arrivo fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Elimina regole della posta in arrivo:

{
    "deleted_rule": [
        "New test cases"
    ],
    "successful_mailboxes": [
        "[e-mail]"
    ],
    "failed_mailboxes": [
        "[e-mail]",
        "[e-mail]"
    ]
}

Messaggi di output

L'azione Elimina regole della posta in arrivo fornisce i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully deleted inbox rule RULE_NAME from mailbox MAILBOX.	Azione riuscita.
Failed to delete inbox rule RULE_NAME from mailbox MAILBOX. Reason: ERROR_REASON	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 Elimina regole di Posta in arrivo:

Nome del risultato dello script	Valore
is_success	True o False

Scarica allegati dalle email

Utilizza l'azione Scarica allegati dalle email per scaricare gli allegati dalle email in base ai criteri forniti.

Questa azione non viene eseguita sulle entità Google SecOps.

Questa azione è asincrona. Se necessario, modifica il valore di timeout dello script nell'IDE Google SecOps.

L'azione sostituisce il carattere di sottolineatura \` forward slash or/backslash characters in the names of the downloaded attachments with the_`

Input azione

L'azione Scarica allegati dalle email richiede i seguenti parametri:

Parametro	Descrizione
Search In Mailbox	Obbligatorio. La casella di posta predefinita in cui viene eseguita l'operazione di ricerca. Se le autorizzazioni lo consentono, l'azione può cercare anche in altre caselle postali. Questo parametro accetta più valori come stringa separata da virgole.
Folder Name	Obbligatorio. Una cartella della casella di posta in cui eseguire la ricerca. Per specificare una sottocartella, utilizza la barra (/) /, ad esempio Inbox/Subfolder.
Download Destination	Obbligatorio. Un tipo di spazio di archiviazione per salvare gli allegati scaricati. Per impostazione predefinita, l'azione tenta di salvare l'allegato nel bucket Cloud Storage. Il salvataggio di un allegato nel file system locale è un'opzione di riserva. I valori possibili sono GCP Bucket e Local File System. Il valore predefinito è GCP Bucket.
Download Path	Obbligatorio. Un percorso per scaricare gli allegati. Quando salvi gli allegati nel bucket Cloud Storage o in un file system locale, l'azione prevede che tu specifichi il percorso di download nel formato simile a Unix, ad esempio /tmp/test.
Mail IDs	Facoltativo Una condizione di filtro per cercare email con ID email specifici. Questo parametro accetta un elenco separato da virgole di ID email da cercare. Se viene fornito questo parametro, la ricerca ignora i parametri Subject Filter e Sender Filter.
Subject Filter	Facoltativo Una condizione di filtro che specifica l'oggetto dell'email da cercare. Questo filtro utilizza la logica contains.
Sender Filter	Facoltativo Una condizione di filtro che specifica il mittente delle email richieste. Questo filtro utilizza la logica equals.
Download Attachments From EML	Facoltativo Se selezionata, l'azione scarica gli allegati dai file EML. Non selezionato per impostazione predefinita.
Download attachments to unique path?	Facoltativo Se selezionata, l'azione scarica gli allegati nel percorso univoco fornito nel campo del parametro Download Path per evitare di sovrascrivere gli allegati scaricati in precedenza. Non selezionata per impostazione predefinita.
How many mailboxes to process in a single batch	Facoltativo Il numero di caselle postali da elaborare in un singolo batch (singola connessione al server di posta). Il valore predefinito è 25.

Output azione

L'azione Scarica allegati dalle email fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Scarica allegati dall'email:

[
    {
        "attachment_name": "name1.png",
        "downloaded_path": "file_path/name1.png"
    },
    {
        "attachment_name": "name2.png",
        "downloaded_path": "file_path/name2.png"
    }
]

Messaggi di output

L'azione Scarica allegati dalle email fornisce i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Downloaded NUMBER_OF_ATTACHMENTS attachments. Files: PATHS. Failed to find emails in MAILBOX with the following mail ids: EMAIL_IDS. In the mailboxes listed below, emails were found, but there were no attachments to download. Affected mailboxes: MAILBOXES. Mail IDs without attachments to download: LIST_OF_EMAIL_IDS attachments.	Azione riuscita.
Failed to find any emails using the provided criteria! Failed to find any of the provided mailboxes: MAILBOXES Action failed to run because the provided mailbox folder name FOLDER_NAME was not found in the mailbox MAILBOX. Error executing action. Reason: ERROR_REASON	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 Scarica allegati dall'email:

Nome del risultato dello script	Valore
is_success	True o False

Estrai i dati dal file EML allegato

Utilizza l'azione Estrai dati dall'EML allegato per recuperare i dati dagli allegati EML delle email e restituirli nei risultati dell'azione. Questa azione supporta i formati file .eml, .msg e .ics.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Estrai dati dall'EML allegato richiede i seguenti parametri:

Parametro	Descrizione
Search In Mailbox	Obbligatorio. La casella di posta predefinita in cui viene eseguita l'operazione di ricerca. Se le autorizzazioni lo consentono, l'azione può cercare anche in altre caselle postali. Questo parametro accetta più valori come stringa separata da virgole.
Folder Name	Facoltativo Una cartella della casella di posta in cui eseguire la ricerca. Per specificare una sottocartella, utilizza la barra (/) /, ad esempio Inbox/Subfolder.
Mail IDs	Obbligatorio. Una condizione di filtro per cercare email con ID email specifici. Questo parametro accetta un elenco separato da virgole di ID email da cercare.
Regex Map JSON	Facoltativo Una definizione JSON contenente espressioni regolari da applicare al file email allegato e generare valori chiave aggiuntivi nel risultato JSON dell'azione. L'esempio di questo valore parametro è il seguente: {ips: \\b\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\b}

Output azione

L'azione Estrai dati dall'EML allegato fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 descrive l'output del risultato JSON ricevuto quando si utilizza l'azione Estrai dati dall'EML allegato:

[
    {
        "type": "EML",
        "subject": "examplesubject",
        "from": "[e-mail]",
        "to": "[e-mail],[e-mail]",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>example-html</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.eml"
    },
    {
        "type": "MSG",
        "subject": "examplesubject",
        "from": "[e-mail]",
        "to": "[e-mail],[e-mail]",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>examplehtml</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.msg"
    },
    {
        "type": "ICS",
        "subject": "examplesubject",
        "from": "[e-mail]",
        "to": "[e-mail],[e-mail]",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>example-html</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.ics"
    }
]

Messaggi di output

L'azione Estrai dati dall'EML allegato fornisce i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Extracted data from ATTACHMENT_NAMES attached email files. Files: PATHS Failed to find emails in MAILBOX with the following mail ids: MAIL_ID_LIST	Azione riuscita.
Failed to find any emails using the provided criteria! Failed to find any of the provided mailboxes: MAILBOX_LIST Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX Failed to execute action, the error is: ERROR_REASON	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 Estrai dati dall'EML allegato:

Nome del risultato dello script	Valore
is_success	True o False

Inoltra email

Utilizza l'azione Inoltra email per inoltrare le email che includono thread precedenti. Con le autorizzazioni appropriate, questa azione può inviare email da una casella di posta diversa da quella specificata nella configurazione dell'integrazione.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Inoltra email richiede i seguenti parametri:

Parametro	Descrizione
Send From	Obbligatorio. Un indirizzo email facoltativo da cui inviare un'email, se le autorizzazioni lo consentono. Per impostazione predefinita, l'email viene inviata dalla casella di posta predefinita specificata nella configurazione dell'integrazione.
Folder Name	Facoltativo Una cartella della casella di posta in cui cercare le email. Per specificare una sottocartella, utilizza la barra (/) /, ad esempio Inbox/Subfolder.
Mail ID	Obbligatorio. L'ID dell'email da inoltrare.
Subject	Obbligatorio. L'oggetto dell'email.
Send to	Obbligatorio. Un elenco separato da virgole di indirizzi email per i destinatari dell'email, ad esempio [e-mail], [e-mail].
CC	Facoltativo Un elenco separato da virgole di indirizzi email per il campo Cc dell'email. Il formato è lo stesso del parametro Send to.
BCC	Facoltativo Un elenco di indirizzi email separati da virgole per il campo Ccn dell'email. Il formato è lo stesso del parametro Send to.
Attachments Paths	Facoltativo Un elenco separato da virgole dei percorsi degli allegati di file archiviati sul server, ad esempio /FILE_DIRECTORY/file.pdf, /FILE_DIRECTORY/image.jpg.
Mail content	Obbligatorio. Il corpo dell'email.

Output azione

La tabella seguente descrive i tipi di output associati all'azione Inoltra email:

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

Messaggi di output

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

Messaggio di output	Descrizione del messaggio
Email with message ID MAIL_ID was forwarded successfully.	Azione riuscita.
Error executing action "Forward Email" because the provided mail id EMAIL_ID was not found. Action failed to delete any emails because the provided mailbox folder name was not found in the mailbox(es): MAILBOX: MAILBOX_FOLDER Action failed to run because specified attachments were not found: ATTACHMENTS_LIST Failed to execute action, the error is: ERROR_REASON	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 Inoltra email:

Nome del risultato dello script	Valore
is_success	True o False

Recupera l'account della casella di posta dalle impostazioni della struttura

Utilizza l'azione Recupera l'account della casella di posta dalle impostazioni della struttura per recuperare le impostazioni di risposta automatica per l'entità Google SecOps User fornita.

L'azione Recupera l'account della casella di posta dalle impostazioni della struttura utilizza la versione beta dell'API Microsoft Graph.

Questa azione viene eseguita sull'entità Google SecOps User.

Input azione

Nessuno.

Output azione

L'azione Recupera l'account della casella di posta dalle impostazioni della struttura fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 l'account della casella di posta dalle impostazioni della struttura:

{
   "@odata.context": "https://graph.microsoft.com/beta/$metadata#communications/presences/$entity",
   "id": "ID",
   "availability": "Offline",
   "activity": "Offline",
   "statusMessage": null,
   "outOfOfficeSettings": {
       "message": "\n\nOut Of Facility111\n",
       "isOutOfOffice": true
   }
}

Messaggi di output

L'azione Recupera l'account della casella di posta dalle impostazioni della struttura può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully returned OOF settings for ENTITY_ID. Failed to find the following usernames in Office 365 service: USERNAME_LIST.	L'azione è riuscita.
Error executing action "Add Identity Protection Detection Comment". Reason: ERROR_REASON Action wasn't able to find OOF settings for ENTITY_ID.	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando utilizzi l'azione Recupera l'account della casella di posta dalle impostazioni della struttura:

Nome del risultato dello script	Valore
is_success	True o False

Regole per gli elenchi

Utilizza l'azione Elenca regole per elencare tutte le regole dei messaggi per una casella di posta specifica utilizzando l'API Microsoft Graph.

Input azione

L'azione Elenca regole richiede i seguenti parametri:

Parametro	Descrizione
Mailboxes	Obbligatorio. Il valore predefinito è Default Mailbox. Caselle postali per cui elencare le regole. Può essere un elenco separato da virgole di nomi principali utente.
Rule Name	Facoltativo. Filtra per nome visualizzato della regola.
Limit	Facoltativo. Il valore predefinito è 20. Limita il numero di regole da restituire per casella postale.

Output azione

L'azione Elenca regole fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 regole fornisce i dettagli di esecuzione nella tabella della bacheca del caso.

Risultato JSON

L'esempio seguente descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Elenca regole:

[
  {
    "mailbox": "[e-mail]",
    "rules": [
      {
        "id": "AAMkAD...",
        "displayName": "Google SecOps - Blocked Senders",
        "sequence": 1,
        "isEnabled": true
      }
    ]
  }
]

Messaggi di output

L'azione Elenca regole fornisce i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully fetched NUMBER_OF_RULES rules for mailbox MAILBOX.	Azione riuscita.
Failed to fetch rules for mailbox MAILBOX. Reason: ERROR_REASON	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 si utilizza l'azione Elenca regole:

Nome del risultato dello script	Valore
is_success	True o False

Contrassegna un'email come posta indesiderata

Utilizza l'azione Contrassegna email come posta indesiderata per contrassegnare le email come posta indesiderata in una casella di posta specificata. Questa azione aggiunge il mittente dell'email all'elenco dei mittenti bloccati e sposta il messaggio nella cartella Posta indesiderata.

L'azione Contrassegna email come posta indesiderata utilizza la versione beta dell'API Microsoft Graph.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Contrassegna email come posta indesiderata richiede i seguenti parametri:

Parametro	Descrizione
Search In Mailbox	Obbligatorio. Una casella di posta in cui cercare l'email. Per impostazione predefinita, l'azione tenta di cercare l'email nella casella di posta predefinita che hai specificato nella configurazione dell'integrazione. Per eseguire una ricerca in altre caselle postali, configura le autorizzazioni appropriate per l'azione. Questo parametro accetta più valori come stringa separata da virgole.
Folder Name	Obbligatorio. Una cartella della casella di posta in cui cercare le email. Per specificare una sottocartella, utilizza la barra (/) /, ad esempio Inbox/Subfolder. Il valore predefinito è Inbox.
Mail IDs	Obbligatorio. Gli ID o i valori internetMessageId delle email da contrassegnare come spam. Questo parametro accetta più valori come stringa separata da virgole.

Output azione

L'azione Contrassegna email come posta indesiderata fornisce i seguenti output:

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

Messaggi di output

L'azione Contrassegna email come posta indesiderata può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully marked the email as junk. Failed to find email with ID ID in MAILBOX. Mailbox MAILBOX was not found.	L'azione è riuscita.
Error executing action "Mark Email as Junk". Reason: ERROR_REASON Failed to find any emails based on provided parameters! Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX.	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La seguente tabella elenca il valore dell'output del risultato dello script quando utilizzi l'azione Contrassegna email come posta indesiderata:

Nome del risultato dello script	Valore
is_success	True o False

Contrassegna un'email come non indesiderata

Utilizza l'azione Contrassegna email come non indesiderata per contrassegnare le email come non indesiderate in una casella di posta specifica. Questa azione rimuove il mittente dall'elenco dei mittenti bloccati e sposta il messaggio nella cartella Posta in arrivo.

L'azione Contrassegna email come non indesiderata utilizza la versione beta dell'API Microsoft Graph.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Contrassegna email come non indesiderata richiede i seguenti parametri:

Parametro	Descrizione
Search In Mailbox	Obbligatorio. Una casella di posta in cui cercare un'email. Per impostazione predefinita, l'azione tenta di cercare l'email nella casella di posta predefinita che hai specificato nella configurazione dell'integrazione. Per eseguire una ricerca in altre caselle postali, configura le autorizzazioni appropriate per l'azione. Questo parametro accetta più valori come stringa separata da virgole.
Folder Name	Obbligatorio. Una cartella della casella di posta in cui cercare le email. Per specificare una sottocartella, utilizza la barra (/) /, ad esempio Inbox/Subfolder.
Mail IDs	Obbligatorio. Gli ID o i valori internetMessageId delle email da contrassegnare come spam. Questo parametro accetta più valori come stringa separata da virgole.

Output azione

L'azione Contrassegna un'email come non indesiderata fornisce i seguenti output:

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

Messaggi di output

L'azione Contrassegna email come non indesiderata può restituire i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully marked the email as not junk. Failed to find email with ID ID in MAILBOX. Mailbox MAILBOX was not found.	L'azione è riuscita.
Error executing action "Mark Email as Not Junk". Reason: ERROR_REASON Failed to find any emails based on provided parameters! Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX.	L'azione non è riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Risultato dello script

La seguente tabella elenca il valore dell'output del risultato dello script quando utilizzi l'azione Contrassegna email come non indesiderata:

Nome del risultato dello script	Valore
is_success	True o False

Sposta email nella cartella

Utilizza l'azione Sposta email nella cartella per spostare una o più email dalla cartella email di origine all'altra cartella della casella di posta. Con le autorizzazioni appropriate, questa azione può spostare le email in altre caselle postali diverse da quella fornita nella configurazione dell'integrazione.

Questa azione è asincrona. Regola il timeout dell'azione nell'ambiente di sviluppo integrato (IDE) di Google SecOps in base alle esigenze.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

Per configurare l'azione Sposta email nella cartella, utilizza i seguenti parametri:

Parametro	Descrizione
Move In Mailbox	Obbligatorio. La casella postale predefinita in cui viene eseguita l'operazione di spostamento. Se le autorizzazioni lo consentono, l'azione può cercare anche in altre caselle postali. Questo parametro accetta più valori come stringa separata da virgole.
Source Folder Name	Obbligatorio. Una cartella di origine da cui spostare l'email. Per specificare una sottocartella, utilizza la barra (/) /, ad esempio Inbox/Subfolder.
Destination Folder Name	Obbligatorio. Una cartella di destinazione in cui spostare l'email. Fornisci il valore parametro nel seguente formato: Inbox/folder_name/subfolder_name. Questo parametro non distingue tra maiuscole e minuscole.
Mail IDs	Facoltativo Una condizione di filtro per cercare email con ID email specifici. Questo parametro accetta un elenco separato da virgole di ID email da cercare. Se viene fornito questo parametro, la ricerca ignora i parametri Subject Filter e Sender Filter.
Subject Filter	Facoltativo Una condizione di filtro che specifica l'oggetto dell'email da cercare. Questo filtro utilizza la logica contains.
Sender Filter	Facoltativo Una condizione di filtro che specifica il mittente delle email richieste. Questo filtro utilizza la logica equals.
Timeframe (Minutes)	Facoltativo Una condizione di filtro che specifica l'intervallo di tempo, in minuti, in cui cercare le email.
Only Unread	Facoltativo Se selezionata, l'azione cerca solo le email non lette. Non selezionato per impostazione predefinita.
How many mailboxes to process in a single batch	Facoltativo Il numero di caselle postali da elaborare in un singolo batch (singola connessione al server di posta). Il valore predefinito è 25.

Output azione

La tabella seguente descrive i tipi di output associati all'azione Sposta email nella cartella:

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

Messaggi di output

L'azione Sposta email nella cartella fornisce i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully moved emails in the following mailboxes: MAILBOX: MOVED_EMAILS_NUMBER Mailbox MAILBOX was not found.	Azione riuscita.
Action was not able to find any emails based on the specified search criteria. Action failed to move any emails because the provided source folder was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER Action failed to move any emails because the provided destination folder was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER Failed to find any of the provided mailboxes: MAILBOX_LIST Failed to execute action, the error is: ERROR_REASON	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 Sposta email nella cartella:

Nome del risultato dello script	Valore
is_success	True o False

Dindin

Utilizza l'azione Ping per testare la connettività al servizio di posta Microsoft Graph.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

Nessuno.

Output azione

La tabella seguente descrive i tipi di output associati all'azione Ping:

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

Messaggi di output

L'azione Ping fornisce i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully connected to the Microsoft Graph mail service with the provided connection parameters!	Azione riuscita.
Failed to connect to the Microsoft Graph mail service! Error is ERROR_REASON	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 Ping:

Nome del risultato dello script	Valore
is_success	True o False

Rimuovi blocco dominio

Utilizza l'azione Rimuovi blocco dominio per rimuovere i domini email specificati da una regola di messaggistica nella casella di posta di destinazione. Se la regola diventa vuota, verrà eliminata.

Questa azione è asincrona. Regola il timeout dell'azione nell'ambiente di sviluppo integrato (IDE) di Google SecOps in base alle esigenze.

Input azione

L'azione Rimuovi blocco dominio richiede i seguenti parametri:

Parametro	Descrizione
Domains	Facoltativo. Elenco separato da virgole dei domini mittente da rimuovere (ad esempio, example.com). I domini inseriti manualmente in questo campo e i domini estratti dinamicamente dalle entità funzionano insieme e verranno entrambi rimossi dalle condizioni della regola.
Mailboxes	Obbligatorio. Il valore predefinito è Default Mailbox. Le caselle postali in cui esiste la regola per i messaggi. Può essere un elenco separato da virgole di nomi principali utente.
Rule Name	Obbligatorio. Il valore predefinito è Google SecOps - Blocked Domains. Nome della regola di messaggistica da cui rimuovere questi domini.
How many mailboxes to process in a single batch	Facoltativo. Il valore predefinito è 20. Specifica il numero di caselle postali che l'azione deve elaborare in un singolo batch.

Output azione

L'azione Rimuovi blocco dominio fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Rimuovi dominio bloccato:

[
  {
    "Entity": "example.com",
    "EntityResult": {
      "successful_mailboxes": [
        "[e-mail]"
      ],
      "failed_mailboxes": []
    }
  }
]

Messaggi di output

L'azione Rimuovi blocco dominio fornisce i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully removed domain DOMAIN from the blocked senders list for mailbox MAILBOX.	Azione riuscita.
Failed to remove domain DOMAIN from the blocked senders list for mailbox MAILBOX. Reason: ERROR_REASON	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 Rimuovi dominio bloccato:

Nome del risultato dello script	Valore
is_success	True o False

Rimuovi blocco mittente

Utilizza l'azione Rimuovi mittente bloccato per rimuovere i mittenti email specificati da una regola di messaggistica nella casella di posta di destinazione. Se la regola diventa vuota, verrà eliminata.

Questa azione è asincrona. Regola il timeout dell'azione nell'ambiente di sviluppo integrato (IDE) di Google SecOps in base alle esigenze.

Input azione

L'azione Rimuovi mittente bloccato richiede i seguenti parametri:

Parametro	Descrizione
Senders	Facoltativo. Elenco separato da virgole di indirizzi email del mittente da rimuovere. I mittenti inseriti manualmente in questo campo e i mittenti estratti dinamicamente dalle entità funzionano insieme e verranno rimossi entrambi dalle condizioni della regola.
Mailboxes	Obbligatorio. Il valore predefinito è Default Mailbox. Le caselle postali in cui esiste la regola per i messaggi. Può essere un elenco separato da virgole di nomi principali utente.
Rule Name	Obbligatorio. Il valore predefinito è Google SecOps - Blocked Senders. Il nome della regola di messaggistica da cui rimuovere questi mittenti.
How many mailboxes to process in a single batch	Facoltativo. Il valore predefinito è 20. Specifica il numero di caselle postali che l'azione deve elaborare in un singolo batch.

Output azione

L'azione Rimuovi mittente bloccato fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Rimuovi mittente bloccato:

[
  {
    "Entity": "[e-mail]",
    "EntityResult": {
      "successful_mailboxes": [
        "[e-mail]"
      ],
      "failed_mailboxes": []
    }
  }
]

Messaggi di output

L'azione Rimuovi mittente bloccato fornisce i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Successfully removed sender SENDER from the blocked senders list for mailbox MAILBOX.	Azione riuscita.
Failed to remove sender SENDER from the blocked senders list for mailbox MAILBOX. Reason: ERROR_REASON	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 Rimuovi mittente bloccato:

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 bacheca delle richieste di Google SecOps. Con le autorizzazioni appropriate, questa azione può salvare le email da caselle postali diverse da quella fornita nella configurazione dell'integrazione.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

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

Parametro	Descrizione
Search In Mailbox	Obbligatorio. La casella di posta predefinita in cui viene eseguita l'operazione di ricerca. Se le autorizzazioni lo consentono, l'azione può cercare anche in altre caselle postali.
Folder Name	Facoltativo Una cartella della casella di posta in cui cercare le email. Per specificare una sottocartella, utilizza la barra (/) /, ad esempio Inbox/Subfolder.
Mail ID	Obbligatorio. Un elenco separato da virgole di ID email da cercare. Se hai utilizzato l'azione Invia email per inviare email, imposta il valore parametro sul segnaposto {SendEmail.JSONResult|id} o {SendEmail.JSONResult|internetMessageId}.
Save Only Email Attachments	Facoltativo Se selezionata, l'azione salva solo gli allegati dell'email specificata. Non selezionato per impostazione predefinita.
Attachment To Save	Facoltativo Se è selezionato il parametro Save Only Email Attachments, l'azione salva solo gli allegati specificati da questo parametro. Questo parametro accetta più valori come stringa separata da virgole.
Base64 Encode	Facoltativo Se selezionata, l'azione codifica il file email nel formato base64. Non selezionato per impostazione predefinita.

Output azione

La tabella seguente descrive i tipi di output associati all'azione Salva email nella richiesta:

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

Allegato della bacheca casi

I seguenti allegati sono associati all'azione Salva email nella richiesta:

• EMAIL_SUBJECT.eml, se l'azione salva l'email.

• Se l'azione salva l'allegato, il nome dell'allegato contiene un'estensione del file, se presente.

Risultato JSON

L'esempio seguente descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Salva email nella richiesta:

{
    "id": "ID",
    "createdDateTime": "2024-02-16T14:10:34Z",
    "eml_info": "example_info",
    "lastModifiedDateTime": "2024-02-16T14:10:41Z",
    "changeKey": "cxsdjjh",
    "categories": [],
    "receivedDateTime": "2024-02-16T14:10:35Z",
    "sentDateTime": "2024-02-16T14:09:36Z",
    "hasAttachments": true,
    "internetMessageId": "INTERNET_MESSAGE_ID",
    "subject": "all attachments",
    "bodyPreview": "all the attachments",
    "importance": "normal",
    "parentFolderId": "PARENT_FOLDER_ID",
    "conversationId": "CONVERSATION_ID",
    "conversationIndex": "example-index",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://example.com/",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "html",
        "content": "<html><head>example-html</head></html>"
    },
    "sender": {
        "emailAddress": {
            "name": "NAME",
            "address": "[e-mail]"
        }
    },
    "from": {
        "emailAddress": {
            "name": "NAME",
            "address": "[e-mail]"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "NAME",
                "address": "[e-mail]"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "flag": {
        "flagStatus": "notFlagged"
    }
}

Messaggi di output

In una bacheca casi, l'azione Salva email nel caso fornisce i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Email successfully saved! Successfully saved the following attachments: ATTACHMENTS_LIST The following attachments were not found in email with mail id: EMAIL_ID: ATTACHMENTS_LIST	Azione riuscita.
Mailbox MAILBOX_NAME was not found. Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX_NAME Failed to execute action, the error is: ERROR_REASON	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 Salva email nella richiesta:

Nome del risultato dello script	Valore
is_success	True o False

Cerca email

Utilizza l'azione Cerca email per eseguire una ricerca di email nella casella di posta predefinita in base ai criteri di ricerca forniti. Con le autorizzazioni appropriate, questa azione può eseguire una ricerca in altre caselle postali.

Questa azione è asincrona. Modifica il timeout dell'azione nell'IDE Google SecOps in base alle esigenze.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Cerca email richiede i seguenti parametri:

Parametro	Descrizione
Search In Mailbox	Obbligatorio La casella di posta predefinita in cui viene eseguita l'operazione di ricerca. Se le autorizzazioni lo consentono, l'azione può cercare anche in altre caselle postali. Questo parametro accetta più valori come stringa separata da virgole. Per ricerche complesse in un numero significativo di caselle postali, utilizza l'integrazione di Exchange Extension Pack.
Folder Name	Optional Una cartella della casella di posta in cui cercare le email. Per specificare una sottocartella, utilizza la barra (/) / (ad esempio, Inbox/Subfolder). Il valore predefinito è Inbox.
Subject Filter	Optional Una condizione di filtro che specifica l'oggetto dell'email da cercare. Questo filtro utilizza la logica contains.
Sender Filter	Optional Una condizione di filtro che specifica il mittente delle email richieste. Questo filtro utilizza la logica equals.
Recipient Filter	Optional Una condizione di filtro che specifica il destinatario delle email richieste.
Timeframe (minutes)	Optional Una condizione di filtro che specifica il periodo in minuti per la ricerca delle email.
Start Time	Optional Specifica l'ora di inizio della ricerca delle email nel formato ISO 8601. Questo parametro ha la priorità su Timeframe (minutes).
End Time	Optional Specifica l'ora di fine della ricerca delle email nel formato ISO 8601. Se non viene fornito e Start Time è valido, questo parametro utilizza l'ora corrente.
Body Regex Filter	Optional Specifica un pattern di espressione regolare per eseguire la ricerca nel corpo dell'email.
Message IDs	Optional Un elenco separato da virgole di ID messaggio da cercare. Nota: questo filtro ha la priorità sugli altri filtri.
Max Emails To Return	Optional Il numero di email da restituire per l'azione. Se non imposti un valore, viene utilizzato il valore predefinito dell'API. Il valore predefinito è 10.
Only Unread	Optional Se selezionata, l'azione cerca solo le email non lette. Non selezionato per impostazione predefinita.
Select All Fields For Return	Optional Se selezionata, l'azione restituisce tutti i campi disponibili per l'email ottenuta. Non selezionato per impostazione predefinita.
How many mailboxes to process in a single batch	Optional Il numero di caselle postali da elaborare in un singolo batch (singola connessione al server di posta). Il valore predefinito è 25.
Search in all mailboxes	Optional Se selezionata, l'azione esegue la ricerca in tutte le caselle postali accessibili. Non selezionato per impostazione predefinita.
Limit the Amount of Information Returned in the JSON Result	Optional Se selezionata, la quantità di informazioni restituite dall'azione è limitata solo ai campi email chiave. Non selezionato per impostazione predefinita.
Disable the Action JSON Result	Optional Se selezionata, l'azione non restituisce un risultato JSON. Non selezionato per impostazione predefinita.

Output azione

L'azione Cerca email fornisce i seguenti output:

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

Tabella della bacheca casi

L'azione Cerca email può generare la seguente tabella:

Titolo della tabella: Matching Mails

Colonne:

• ID posta
• Oggetto
• Mittente
• Destinatari
• Data di ricezione

Risultato dello script

La seguente tabella elenca il valore dell'output del risultato dello script quando utilizzi l'azione Cerca email:

Nome del risultato dello script	Valore
is_success	true o false

Messaggi di output dell'azione

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

Messaggio di output	Descrizione del messaggio
Successfully found emails in the following mailboxes: MAILBOX: FOUND_EMAILS_NUMBER Mailbox MAILBOX was not found. Action was not able to find any emails based on the specified search criteria.	Azione riuscita.
Failed to find any of the provided mailboxes: MAILBOX_LIST Failed to execute action, the error is: ERROR_REASON	Azione non riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Invia email

Utilizza l'azione Invia email per inviare email da una casella di posta specifica a un elenco arbitrario di destinatari.

Questa azione può inviare email in formato testo normale o HTML. Con le autorizzazioni appropriate, l'azione può inviare email da una casella diversa da quella specificata nella configurazione dell'integrazione.

Questa azione non viene eseguita sulle entità Google SecOps.

Riferimento rapido alla configurazione S/MIME

Utilizza il seguente riferimento per determinare quali parametri S/MIME configurare in base al livello di sicurezza dell'email in uscita:

Tipo di email desiderato	Base64 Encoded Certificate	Base64 Encoded Private Key	Base64 Encoded Recipient Certificate
Email standard (senza S/MIME)	Lascia vuoto	Lascia vuoto	Lascia vuoto
Con firma digitale	Obbligatorio	Obbligatorio	Lascia vuoto
Criptato	Lascia vuoto	Lascia vuoto	Obbligatorio
Firmato e criptato	Obbligatorio	Obbligatorio	Obbligatorio

Convertire i file del certificato in Base64

Per codificare i file del certificato e della chiave privata in stringhe base64 a riga singola per i parametri di azione, esegui i seguenti comandi:

Linux e macOS:

base64 -w 0 sender_cert.crt
base64 -w 0 sender_key.key

Windows PowerShell:

[Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\path\to\certificate.crt"))
[Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\path\to\private_key.key"))

Input azione

L'azione Invia email richiede i seguenti parametri:

Parametro	Descrizione
Send From	Obbligatorio. Un indirizzo email facoltativo da cui inviare email, se le autorizzazioni lo consentono. Per impostazione predefinita, l'azione invia email dalla casella di posta predefinita specificata nella configurazione dell'integrazione.
Subject	Obbligatorio. L'oggetto dell'email.
Send to	Obbligatorio. Un elenco separato da virgole di indirizzi email per i destinatari dell'email, ad esempio [e-mail], [e-mail].
CC	Facoltativo Un elenco separato da virgole di indirizzi email per il campo Cc dell'email. Il formato è lo stesso del parametro Send to.
BCC	Facoltativo Un elenco di indirizzi email separati da virgole per il campo Ccn dell'email. Il formato è lo stesso del parametro Send to.
Attachments Paths	Facoltativo Un elenco separato da virgole dei percorsi degli allegati di file archiviati sul server, ad esempio /FILE_DIRECTORY/file.pdf, /FILE_DIRECTORY/image.jpg.
Attachments Location	Obbligatorio. Una posizione in cui sono archiviati gli allegati. Per impostazione predefinita, l'azione tenta di caricare gli allegati dal bucket Cloud Storage. I valori possibili sono GCP Bucket o Local File System. Il valore predefinito è GCP Bucket.
Mail Content Type	Facoltativo Il tipo di contenuti dell'email. I valori possibili sono: Text HTML Il valore predefinito è Text.
Mail Content	Obbligatorio. Il corpo dell'email.
Reply-To Recipients	Facoltativo Un elenco separato da virgole di destinatari da utilizzare nell'intestazione Rispondi a. Utilizza l'intestazione Reply-To per reindirizzare le email di risposta all'indirizzo email specificato anziché all'indirizzo del mittente nel campo Da.
Base64 Encoded Certificate	Facoltativo Il certificato pubblico X.509 codificato in Base64 (.cer, .crt, .pem) del mittente (formato a riga singola). Utilizzato per la firma digitale S/MIME. Se fornito, devi indicare anche Base64 Encoded Private Key.
Base64 Encoded Private Key	Facoltativo La chiave privata codificata in Base64 (.key, .pem) del mittente (formato a riga singola). Utilizzato per la firma digitale S/MIME. Obbligatorio se viene fornito Base64 Encoded Certificate.
Base64 Encoded Recipient Certificate	Facoltativo Il certificato pubblico con codifica Base64 (.cer, .crt, .pem) del destinatario (formato a riga singola). Utilizzato per la crittografia delle email.

Output azione

La tabella seguente descrive i tipi di output associati all'azione Invia email:

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

Messaggi di output

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

Messaggio di output	Descrizione del messaggio
Email was sent successfully.	Azione riuscita.
Action failed to run because specified attachments were not found: ATTACHMENTS_LIST Failed to execute action, the error is: ERROR_REASON	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 Invia email:

Nome del risultato dello script	Valore
is_success	True o False

Invia email HTML

Utilizza l'azione Invia email HTML per inviare email che utilizzi il modello HTML di Google SecOps da una casella di posta specifica a un elenco arbitrario di destinatari. Con le autorizzazioni appropriate, l'azione può inviare email da una casella di posta diversa da quella predefinita.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Invia email HTML richiede i seguenti parametri:

Parametro	Descrizione
Send From	Obbligatorio. Un indirizzo email facoltativo da cui inviare email, se le autorizzazioni lo consentono. Per impostazione predefinita, l'azione invia email dalla casella di posta predefinita specificata nella configurazione dell'integrazione.
Subject	Obbligatorio. L'oggetto dell'email.
Send to	Obbligatorio. Un elenco separato da virgole di indirizzi email per i destinatari dell'email, ad esempio [e-mail], [e-mail].
CC	Facoltativo Un elenco separato da virgole di indirizzi email per il campo Cc dell'email. Il formato è lo stesso del parametro Send to.
BCC	Facoltativo Un elenco di indirizzi email separati da virgole per il campo Ccn dell'email. Il formato è lo stesso del parametro Send to.
Attachments Paths	Facoltativo Un percorso completo per l'allegato da fornire, ad esempio /FILE_DIRECTORY/file.pdf, /FILE_DIRECTORY/image.jpg. Puoi fornire più valori in una stringa separata da virgole.
Email HTML Template	Obbligatorio. Il tipo di modello HTML da utilizzare. I valori possibili sono Email HTML Template e Dynamically generated list of available templates. Il valore predefinito è Email HTML Template.
Mail Content	Obbligatorio. Il corpo dell'email.
Reply-To Recipients	Facoltativo Un elenco separato da virgole di destinatari da utilizzare nell'intestazione Rispondi a. Utilizza l'intestazione Reply-To per reindirizzare le email di risposta all'indirizzo email specifico anziché all'indirizzo del mittente indicato nel campo Da.
Attachment Location	Obbligatorio. Una posizione in cui sono archiviati gli allegati. Per impostazione predefinita, l'azione tenta di caricare gli allegati dal bucket Cloud Storage. I valori possibili sono GCP Bucket o Local File System. Il valore predefinito è GCP Bucket.

Output azione

L'azione Invia email HTML fornisce i seguenti output:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Invia email HTML:

{
    "createdDateTime": "2024-01-30T16:50:27Z",
    "lastModifiedDateTime": "2024-01-30T16:50:27Z",
    "changeKey": "example-key",
    "categories": [],
    "receivedDateTime": "2024-01-30T16:50:27Z",
    "sentDateTime": "2024-01-30T16:50:27Z",
    "hasAttachments": false,
    "internetMessageId": "outlook.com",
    "subject": "Testing",
    "bodyPreview": "example",
    "importance": "normal",
    "parentFolderId": "ID",
    "conversationId": "ID",
    "conversationIndex": "INDEX",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://example.com",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "html",
        "content": "content"
    },
    "sender": {
        "emailAddress": {
            "name": "NAME",
            "address": "[e-mail]"
        }
    },
    "from": {
        "emailAddress": {
            "name": "NAME",
            "address": "[e-mail]"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "NAME",
                "address": "[e-mail]"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "uniqueBody": {
        "contentType": "html",
        "content": "content"
    },
    "flag": {
        "flagStatus": "notFlagged"
    },
    "id": "ID"
}

Messaggi di output

In una bacheca dei casi, l'azione Invia email HTML fornisce i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Email was sent successfully.	Azione riuscita.
Action failed to run because the HTML template was not specified. Action failed to run because the following specified attachments were not found: ATTACHMENT_LIST Failed to execute action, the error is: ERROR_REASON	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 Invia email HTML:

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 di email. Con le autorizzazioni appropriate, l'azione può inviare email da una casella diversa da quella specificata nella configurazione dell'integrazione.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

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

Parametro	Descrizione
Send From	Obbligatorio. Un indirizzo email facoltativo da cui inviare email, se le autorizzazioni lo consentono. Per impostazione predefinita, l'azione invia email dalla casella di posta predefinita specificata nella configurazione dell'integrazione.
Mail ID	Obbligatorio. L'ID email da cercare.
Folder Name	Facoltativo Una cartella della casella di posta in cui cercare le email. Per specificare una sottocartella, utilizza la barra (/) /, ad esempio Inbox/Subfolder. Il valore predefinito è Inbox.
Attachments Paths	Facoltativo Un elenco separato da virgole dei percorsi degli allegati di file archiviati sul server, ad esempio /FILE_DIRECTORY/file.pdf, /FILE_DIRECTORY/image.jpg.
Mail Content	Obbligatorio. Il corpo dell'email.
Reply All	Facoltativo Se selezionata, l'azione invia una risposta a tutti i destinatari correlati all'email originale. Non selezionato per impostazione predefinita. Questo parametro ha la priorità sul parametro Reply To.
Reply To	Facoltativo Un elenco separato da virgole di email 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 dell'email originale. Se la casella di controllo Reply All è selezionata, l'azione ignora questo parametro.
Attachments Location	Obbligatorio. Una posizione in cui sono archiviati gli allegati. Per impostazione predefinita, l'azione tenta di caricare gli allegati dal bucket Cloud Storage. I valori possibili sono GCP Bucket o Local File System. Il valore predefinito è GCP Bucket.
Message Timezone	Facoltativo. Il fuso orario utilizzato per la data di invio dell'email originale nell'intestazione della risposta (ad esempio UTC, America/New_York o Europe/London). Se il valore fornito non è valido, viene utilizzato il valore predefinito. Il valore predefinito è UTC.

Output azione

La tabella seguente descrive i tipi di output associati all'azione Invia risposta al thread:

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 si utilizza l'azione Invia risposta al thread:

  {
    "id": "yyyy",
    "createdDateTime": "2024-02-02T10:57:18Z",
    "lastModifiedDateTime": "2024-02-02T10:57:23Z",
    "changeKey": "dsf+oAAQLaPjk",
    "categories": [],
    "receivedDateTime": "2024-02-02T10:57:20Z",
    "sentDateTime": "2024-02-02T10:57:19Z",
    "hasAttachments": true,
    "internetMessageId": "sdfhsjdfhjsdjfd",
    "subject": "RE: reply checking",
    "bodyPreview": "Reply check kr",
    "importance": "normal",
    "parentFolderId": "id",
    "conversationId": "id",
    "conversationIndex": "sdghfjfke",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://www.example.com/about",
    "inferenceClassification": "focused",
    "body": {
      "contentType": "text",
      "content": "Reply check kr"
    },
    "sender": {
      "emailAddress": {
        "name": "aff",
        "address": "[e-mail]"
      }
    },
    "from": {
      "emailAddress": {
        "name": "fasf",
        "address": "[e-mail]"
      }
    },
    "toRecipients": [
      {
        "emailAddress": {
          "name": "wf",
          "address": "[e-mail]"
        }
      }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "uniqueBody": {
      "contentType": "html",
      "content": "Reply check"
    },
    "flag": {
      "flagStatus": "notFlagged"
    }
  }

Messaggi di output

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

Messaggio di output	Descrizione del messaggio
Successfully sent reply to the mail with ID: EMAIL_ID	Azione riuscita.
Error executing action "Send Thread Reply". Reason: if you want to send a reply only to your own email address, you need to work with "Reply To" parameter.	Azione non riuscita. Controlla il valore del parametro Reply To.
Error executing action "Send Thread Reply" because the provided mail id EMAIL_ID was not found. Action failed to run because specified attachments were not found: ATTACHMENTS_LIST Failed to execute action, the error is: ERROR_REASON	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 Invia risposta al thread:

Nome del risultato dello script	Valore
is_success	True o False

Invia email di voto

Utilizza l'azione Invia email di voto per inviare email con le opzioni di risposta predefinite. Questa azione utilizza i modelli HTML di Google SecOps per formattare l'email. Con le autorizzazioni appropriate, l'azione Invia email di voto può inviare email da una casella di posta diversa da quella predefinita.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Invia email di voto richiede i seguenti parametri:

Parametro	Descrizione
Send From	Obbligatorio. Un indirizzo email facoltativo da cui inviare email, se le autorizzazioni lo consentono. Per impostazione predefinita, l'azione invia email dalla casella di posta predefinita specificata nella configurazione dell'integrazione.
Subject	Obbligatorio. L'oggetto dell'email.
Send to	Obbligatorio. Un elenco separato da virgole di indirizzi email per i destinatari dell'email, ad esempio [e-mail], [e-mail].
CC	Facoltativo Un elenco separato da virgole di indirizzi email per il campo Cc dell'email. Il formato è lo stesso del parametro Send to.
BCC	Facoltativo Un elenco di indirizzi email separati da virgole per il campo Ccn dell'email. Il formato è lo stesso del parametro Send to.
Attachments Paths	Facoltativo Un percorso completo per l'allegato da fornire, ad esempio /FILE_DIRECTORY/file.pdf, /FILE_DIRECTORY/image.jpg. Puoi fornire più valori in una stringa separata da virgole.
Email HTML Template	Obbligatorio. Il tipo di modello HTML da utilizzare. I valori possibili sono Email HTML Template e Dynamically generated list of available templates. Il valore predefinito è Email HTML Template.
Reply-To Recipients	Facoltativo Un elenco separato da virgole di destinatari da utilizzare nell'intestazione Rispondi a. Utilizza l'intestazione Reply-To per reindirizzare le email di risposta all'indirizzo email specificato anziché all'indirizzo del mittente indicato nel campo Da.
Structure of voting options	Obbligatorio. La struttura del voto da inviare ai destinatari. I valori possibili sono Yes/No o Approve/Reject. Il valore predefinito è Yes/No.
Attachment Location	Obbligatorio. Una posizione in cui sono archiviati gli allegati. Per impostazione predefinita, l'azione tenta di caricare l'allegato dal bucket Cloud Storage. I valori possibili sono GCP Bucket o Local File System. Il valore predefinito è GCP Bucket.

Output azione

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

Tipo di output dell'azione	Disponibilità
Allegato della bacheca casi	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 descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Invia email di voto:

{
    "createdDateTime": "2024-01-30T16:50:27Z",
    "lastModifiedDateTime": "2024-01-30T16:50:27Z",
    "changeKey": "KEY",
    "categories": [],
    "receivedDateTime": "2024-01-30T16:50:27Z",
    "sentDateTime": "2024-01-30T16:50:27Z",
    "hasAttachments": false,
    "internetMessageId": "<example-message-ID>",
    "subject": "Testing",
    "bodyPreview": "example",
    "importance": "normal",
    "parentFolderId": "FOLDER_ID",
    "conversationId": "CONVERSATION_ID",
    "conversationIndex": "CONVERSATION_INDEX",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://www.example.com/about",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "html",
        "content": "content"
    },
    "sender": {
        "emailAddress": {
            "name": "NAME",
            "address": "[e-mail]"
        }
    },
    "from": {
        "emailAddress": {
            "name": "NAME",
            "address": "[e-mail]"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "NAME",
                "address": "[e-mail]"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "uniqueBody": {
        "contentType": "html",
        "content": "content"
    },
    "flag": {
        "flagStatus": "notFlagged"
    },
    "id": "ID"
}

Messaggi di output

In una bacheca casi, l'azione Invia email di voto fornisce i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Email was sent successfully.	Azione riuscita.
Action failed to run because the HTML template was not specified. Action failed to run because the following specified attachments were not found: ATTACHMENT_LIST Failed to execute action, the error is: ERROR_REASON	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 Invia email di voto:

Nome del risultato dello script	Valore
is_success	True o False

Attendi email dall'utente

Utilizza l'azione Attendi email dall'utente 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 Google SecOps in base alle esigenze. Se imposti il timeout su 0 o lo lasci vuoto, viene utilizzato il timeout predefinito configurato nelle impostazioni dell'ambiente.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Attendi email dall'utente richiede i seguenti parametri:

Parametro	Descrizione
Mail ID	Obbligatorio L'ID o internetMessageId dell'email che l'azione attenderà. Se hai utilizzato l'azione Invia email per inviare email, imposta il valore parametro sul segnaposto {SendEmail.JSONResult|id} o {SendEmail.JSONResult|internetMessageId}.
Mail Date	Optional Invia il timestamp dell'email che l'azione attende. Se il messaggio è stato inviato utilizzando l'azione Invia email, seleziona il campo {SendEmail.JSONResult|sentDateTime} o {SendEmail.JSONResult|createdDateTime} come segnaposto.
Mail Recipients	Optional Elenco separato da virgole degli indirizzi email dei destinatari la cui risposta è attesa dall'azione. Se il messaggio è stato inviato utilizzando l'azione Invia email, seleziona il campo {SendEmail.JSONResult|toRecipients} come segnaposto.
How long to wait for recipient reply (minutes)	Optional Tempo di attesa in minuti della risposta dell'utente prima di contrassegnarla come scaduta. Il valore predefinito è 10080.
Wait for All Recipients to Reply?	Optional Se selezionata, l'azione attende le risposte di tutti i destinatari fino al raggiungimento del timeout o all'invio della prima risposta. Non selezionato per impostazione predefinita.
Wait Stage Exclude pattern	Optional Un'espressione regolare per escludere risposte specifiche dalla fase di attesa. Questo parametro funziona sia con l'oggetto che con il corpo dell'email. Ad esempio, se configuri l'espressione regolare Out of Office.*, l'azione non considera i messaggi di risposta automatica come risposte del destinatario e attende una risposta effettiva dell'utente.
Folder to Check for Reply	Optional Una cartella email della casella di posta in cui cercare le risposte in arrivo dei destinatari. La ricerca viene eseguita nella casella di posta da cui è stata inviata l'email contenente una domanda. Supporta le sottocartelle nidificate utilizzando la barra / (ad esempio, Inbox/Subfolder). Questo parametro è sensibile alle maiuscole. Il valore predefinito è Inbox.
Fetch Response Attachments	Optional Se selezionata e la risposta del destinatario contiene allegati, l'azione recupera la risposta e la aggiunge come allegato al risultato dell'azione. Non selezionato per impostazione predefinita.
Limit the Amount of Information Returned in the JSON Result	Optional Se selezionata, la quantità di informazioni restituite dall'azione è limitata solo ai campi email chiave. Selezionata per impostazione predefinita.
Disable the Action JSON Result	Optional Se selezionata, l'azione non restituisce un risultato JSON. Non selezionato per impostazione predefinita.

Output azione

L'azione Attendi email dall'utente fornisce i seguenti output:

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

Allegato della bacheca casi

Il seguente allegato della bacheca casi è associato all'azione Attendi email dall'utente:

Tipo: entità

Contenuto dell'allegato: titolo, nome file (estensioni incluse, se presenti), fileContent.

• Titolo: Allegato della risposta RECIPIENT_EMAIL.
• Nome file: ATTACHMENT_FILENAME + FILE_EXTENSION
• fileContent: CONTENT_OF_THE_ATTACHED_FILE

Tabella della bacheca casi

L'azione Attendi email dall'utente può generare la seguente tabella:

Titolo della tabella: Email corrispondenti

Colonne:

• ID posta
• Data di ricezione
• Mittente
• Destinatari
• Oggetto

Risultato dello script

La seguente tabella elenca il valore dell'output del risultato dello script quando utilizzi l'azione Attendi email dall'utente:

Nome del risultato dello script	Valore
is_success	true o false

Messaggi di output dell'azione

L'azione Attendi email dall'utente fornisce i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Found the user EMAIL_RECIPIENT reply: USER_REPLY Timeout getting reply from user: EMAIL_RECIPIENT.	Azione riuscita.
Action failed to receive any replies until timeout. Failed to execute action, the error is: ERROR_REASON	Azione non riuscita. Controlla la connessione al server, i parametri di input o le credenziali.

Attendi risultati email di voto

Utilizza l'azione Attendi risultati email di voto per attendere la risposta dell'utente in base all'email di voto inviata utilizzando l'azione Invia email di voto.

Questa azione è asincrona. Regola il timeout dell'azione nell'IDE Google SecOps in base alle esigenze.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Attendi risultati email di voto richiede i seguenti parametri:

Parametro	Descrizione
Vote Mail Sent From	Obbligatorio. La casella di posta da cui l'azione Invia email di voto ha inviato un'email. Il valore predefinito è la casella di posta specificata nella configurazione dell'integrazione. Se vuoi, puoi impostare un valore diverso per questo parametro se l'email di voto viene inviata da una casella di posta diversa.
Mail ID	Obbligatorio. L'ID dell'email. Se l'email viene inviata utilizzando l'azione Send Vote Email, imposta il valore parametro sul segnaposto SendVoteEmail.JSONResult|id o SendEmail.JSONResult|internetMessageId. Per restituire gli ID email, puoi utilizzare l'azione Cerca email.
Wait for All Recipients To Reply?	Facoltativo Se selezionata, l'azione attende le risposte di tutti i destinatari fino a quando non raggiunge il timeout o procede con la prima risposta. Abilitato per impostazione predefinita.
Wait Stage Exclude Pattern	Facoltativo Un'espressione regolare per escludere risposte specifiche dalla fase di attesa. Questo parametro funziona con il corpo dell'email. Esempio: l'azione non considera i messaggi automatici di assenza dall'ufficio come risposte del destinatario, ma attende una risposta effettiva dell'utente.
Folder To Check For Reply	Facoltativo Una cartella email della casella di posta in cui cercare la risposta dell'utente. La ricerca viene eseguita nella casella di posta da cui è stata inviata l'email contenente una domanda. Questo parametro accetta un elenco separato da virgole di cartelle in cui controllare la risposta dell'utente in più cartelle. Questo parametro è sensibile alle maiuscole. Il valore predefinito è Inbox.
Folder To Check For Sent Mail	Facoltativo Una cartella della casella di posta in cui cercare la posta inviata. È una casella di posta da cui hai inviato l'email con una domanda. Questo parametro accetta un elenco di cartelle separate da virgole per controllare la risposta dell'utente in più cartelle. Questo parametro è sensibile alle maiuscole. Per specificare una sottocartella, utilizza la barra /, ad esempio Inbox/Subfolder. Il valore predefinito è Sent Items.
Fetch Response Attachments	Facoltativo Se selezionata e la risposta del destinatario contiene allegati, l'azione recupera la risposta e la aggiunge come allegato alla bacheca della richiesta. Non selezionato per impostazione predefinita.

Output azione

L'azione Attendi risultati email di voto fornisce i seguenti output:

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

Allegato della bacheca casi

Il seguente allegato della bacheca casi è associato all'azione Attendi risultati email di voto:

Tipo: entità

Contenuto dell'allegato: titolo, nome file (estensioni incluse, se presenti), fileContent.

• Titolo: RECIPIENT_EMAIL allegato della risposta.
• Nome file: ATTACHMENT_FILENAME + FILE_EXTENSION
• fileContent: CONTENT_OF_THE_ATTACHED_FILE

Tabella della bacheca casi

In una bacheca richieste, l'azione Attendi risultati email genera la seguente tabella:

Titolo della tabella: Matching Mails

Colonne:

• ID posta
• Data di ricezione
• Mittente
• Destinatari
• Oggetto

Risultato JSON

L'esempio seguente descrive l'output del risultato JSON ricevuto quando utilizzi l'azione Wait For Vote Email Results:

{
    "Responses": [
        {
            "recipient": "[e-mail]",
            "vote": "Approve"
        }
    ]
}

Messaggi di output

L'azione Attendi risultati email di voto fornisce i seguenti messaggi di output:

Messaggio di output	Descrizione del messaggio
Found the user EMAIL_RECIPIENT reply: USER_REPLY. Exceeded timeout to get a reply from user: EMAIL_RECIPIENT.	Azione riuscita.
Action failed to receive any replies until timeout. Failed to execute action, the error is: ERROR_REASON	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 dei risultati dello script quando utilizzi l'azione Attendi risultati email di voto:

Nome del risultato dello script	Valore
is_success	True o False

Connettori

Per scoprire di più sulla configurazione dei connettori in Google SecOps, consulta Importare i dati (connettori).

Nota:per evitare la perdita di dati, i connettori utilizzano l'appiattimento degli eventi. Se un avviso non elaborato contiene un elenco di entità (ad esempio più indirizzi email, nomi host o indirizzi IP), i connettori le trasformano automaticamente in eventi unici e separati.

Ad esempio, un singolo avviso non elaborato contenente tre indirizzi email diversi viene importato come tre eventi separati, ognuno contenente un indirizzo email distinto.

Questo processo garantisce che ogni entità venga indicizzata correttamente come asset unico, rendendola completamente ricercabile e utilizzabile nei playbook.

Connettore Microsoft Graph Mail

Utilizza il connettore di posta di Microsoft Graph per recuperare le email dal servizio di posta di Microsoft Graph.

Utilizza l'elenco dinamico per filtrare i valori specificati dal corpo e dall'oggetto dell'email utilizzando le espressioni regolari. Per impostazione predefinita, il connettore utilizza un'espressione regolare per filtrare gli URL dall'email.

Input del connettore

Il connettore delegato di Microsoft Graph Mail 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. Il nome del prodotto influisce principalmente sulla mappatura. Per semplificare e migliorare il processo di mapping per il connettore, il valore predefinito device_product viene risolto in un valore di riserva a cui viene fatto riferimento dal codice. Qualsiasi input non valido per questo parametro viene risolto in un valore di riserva per impostazione predefinita.
Event Field Name	Obbligatorio. Il nome del campo utilizzato per determinare il nome dell'evento (sottotipo). Il valore predefinito è event_name.
Environment Field Name	Facoltativo Il nome del campo in cui è memorizzato il nome dell'ambiente. Se il campo dell'ambiente non viene trovato, l'ambiente viene impostato su "".
Environment Regex Pattern	Facoltativo Un pattern di espressione regolare da eseguire sul valore trovato nel campo Environment Field Name. Questo parametro 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	Facoltativo Un'espressione regolare per escludere email specifiche dall'importazione, ad esempio spam o notizie. Questo parametro funziona sia con l'oggetto che con il corpo dell'email.
PythonProcessTimeout	Obbligatorio. Il limite di timeout, in secondi, per il processo Python che esegue lo script corrente. Il valore predefinito è 300.
Azure AD Endpoint	Obbligatorio. L'endpoint Microsoft Entra da utilizzare nell'integrazione. Il valore predefinito è https://login.microsoftonline.com.
Microsoft Graph Endpoint	Obbligatorio. L'endpoint Microsoft Graph da utilizzare nell'integrazione. Il valore predefinito è https://graph.microsoft.com.
Mail Address	Obbligatorio. Un indirizzo email da utilizzare per il connettore.
Client ID	Obbligatorio. Un ID applicazione (client) dell'applicazione Microsoft Entra.
Secret ID	Obbligatorio. Il valore del client secret dell'applicazione Microsoft Entra.
Tenant (Directory) ID	Obbligatorio. Il valore di Microsoft Entra ID (ID tenant).
Folder to check for emails	Obbligatorio. Una cartella email in cui cercare le email. Questo parametro accetta un elenco di cartelle separate da virgole in cui cercare la risposta dell'utente in più cartelle. Per specificare una sottocartella, utilizza la barra /, ad esempio Inbox/Subfolder. Questo parametro è sensibile alle maiuscole. Il valore predefinito è Inbox.
Offset Time In Hours	Obbligatorio. Il numero di ore prima della prima iterazione del connettore per recuperare le email. Questo parametro si applica all'iterazione iniziale del connettore dopo averlo abilitato per la prima volta. Il connettore può utilizzare questo parametro come valore di riserva quando il timestamp dell'ultima iterazione del connettore scade. Il valore predefinito è 24.
Max Emails Per Cycle	Obbligatorio. Il numero di email da recuperare per ogni iterazione del connettore. Il valore predefinito è 10.
Unread Emails Only	Facoltativo Se selezionato, il connettore crea richieste solo dalle email non lette. Non selezionato per impostazione predefinita.
Mark Emails as Read	Facoltativo Se selezionato, il connettore contrassegna le email come lette dopo l'importazione. Non selezionato per impostazione predefinita.
Disable Overflow	Facoltativo Se selezionato, il connettore ignora il meccanismo di overflow di Google SecOps. Non selezionato per impostazione predefinita.
Verify SSL	Obbligatorio. Se selezionata, l'integrazione convalida il certificato SSL quando si connette a Microsoft Graph. Abilitato per impostazione predefinita.
Original Received Mail Prefix	Facoltativo 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.
Attached Mail File Prefix	Facoltativo 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.
Create a Separate Google Secops Alert per Attached Mail File	Facoltativo 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 Google SecOps per creare entità da file email allegati. Non selezionato per impostazione predefinita.
Attach Original EML	Facoltativo Se selezionato, il connettore allega l'email originale alle informazioni della richiesta come file EML. Non selezionato per impostazione predefinita.
Headers to add to events	Facoltativo Una stringa separata da virgole di intestazioni email da aggiungere agli eventi Google SecOps, ad esempio DKIM-Siganture, Received o From. Puoi configurare una corrispondenza esatta per le intestazioni o impostare il valore parametro come espressione regolare. Il connettore filtra i valori configurati dall'elenco internetMessageHeaders e li aggiunge all'evento Google SecOps. Per impedire al connettore di aggiungere intestazioni all'evento, imposta ilvalore parametroo come segue: None. Per impostazione predefinita, il connettore aggiunge tutte le intestazioni disponibili.
Case Name Template	Facoltativo Un nome della richiesta personalizzato. Quando configuri questo parametro, il connettore aggiunge una nuova chiave chiamata custom_case_name all'evento Google SecOps SOAR. 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.
Alert Name Template	Facoltativo Un nome di 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.
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 per l'autenticazione.
Mail Field Source	Facoltativo Se selezionata, l'integrazione recupera l'indirizzo della casella di posta dall'attributo mail dei dettagli utente. Se non viene selezionata, l'integrazione recupera l'indirizzo della casella di posta dal campo userPrincipalName. Non selezionato per impostazione predefinita.
Extract URLs from HTML Email Part	Facoltativo Se selezionato, il connettore estrae gli URL dal corpo HTML dell'email. Ciò consente al connettore di estrarre URL complessi, ma non estrae gli URL dalla parte di testo normale dell'email. Gli URL estratti sono disponibili nel campo evento urls_from_html_part. Abilitato per impostazione predefinita.
Event Fields to Exclude	Facoltativo Un elenco separato da virgole di campi evento da escludere dalla creazione dell'evento (ad esempio field1,field2).
Exclude Attachments	Facoltativo Se selezionato, il connettore non acquisisce gli allegati email né li aggiunge ai casi.
Bypass S/MIME Signature Verification	Facoltativo Se selezionato, il connettore acquisisce le email firmate con S/MIME senza richiedere un certificato CA con codifica Base64 per la verifica della firma. Il corpo del messaggio, le intestazioni e gli allegati vengono estratti direttamente.
Base64 Encoded Private Key	Facoltativo La chiave privata con codifica Base64 utilizzata per decriptare le email in arrivo criptate con S/MIME. Se fornito, devi indicare anche Base64 Encoded Certificate.
Base64 Encoded Certificate	Facoltativo Il certificato con codifica Base64 utilizzato per decrittografare le email in arrivo criptate con S/MIME. Se fornito, devi indicare anche Base64 Encoded Private Key.
Base64 Encoded CA certificate	Facoltativo Il certificato CA attendibile con codifica Base64 per la verifica delle firme digitali delle email S/MIME in arrivo. Se non viene fornito alcun certificato CA, la verifica della firma per le email firmate in arrivo non va a buon fine, a meno che non sia attivato Bypass S/MIME Signature Verification.

Regole del connettore

Il connettore supporta i proxy.

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