Exchange Extension Pack

Questo documento descrive come integrare Exchange Extension Pack con Google Security Operations.

Configura l'integrazione per l'utilizzo con Exchange

I passaggi di configurazione variano a seconda del server di posta per cui è configurata l'integrazione.

Di seguito sono riportate le istruzioni di configurazione per Microsoft 365 ed Exchange on-premise a partire dalla versione 2016. Le versioni precedenti non sono supportate.

Configura l'integrazione per l'utilizzo con Microsoft 365

Questa integrazione utilizza script PowerShell per eseguire le operazioni. Il pacchetto PowerShell deve essere installato sul server Google Security Operations o sull'agente remoto Google SecOps che utilizza l'integrazione di Exchange Extension Pack.

Ecco un esempio di come configurare PowerShell per CentOS7:

1. Installa il pacchetto PowerShell.

   > curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/microsoft.repo
   > sudo yum install -y powershell
   

2. Apri l'interprete PowerShell e installa i moduli Exchange Online PowerShell V3 e WSMan:

   > pwsh
   > Install-Module -Name ExchangeOnlineManagement -RequiredVersion 3.5.0 -Force -Scope AllUsers
   > Install-Module -Name PSWSMan
   > Install-WSMan
   > exit
   

3. Vai su https://github.com/jborean93/omi/releases per scaricare i file libmi.so e libpsrpclient.so per openssl 1.1. Scarica l'ultima release di glibc-1.1.tar.gz sull'host CentOS.

4. Estrai l'archivio tar scaricato:

   > tar -xzvf glibc-1.1.tar.gz
   

5. Sovrascrivi i file libmi.so e libpsrpclient.so esistenti nella directory /opt/microsoft/powershell/7.

Configura l'account

Aggiungi l'account che verrà utilizzato con l'integrazione al ruolo di amministratore Discover Management nell'Exchange Admin Center.

Assegna le autorizzazioni all'utente

Assegna all'utente il ruolo Amministratore dei dati di conformità.

Configura l'integrazione per l'utilizzo con Exchange on-premise

Le seguenti istruzioni sono applicabili a Exchange 2016, le versioni precedenti non sono supportate.

Questa integrazione utilizza script PowerShell per eseguire le operazioni. Il pacchetto PowerShell deve essere installato sul server Google SecOps o sull'agente remoto Google SecOps che utilizza l'integrazione di Exchange Extension Pack.

Ecco un esempio di come configurare PowerShell per CentOS7:

1. Installa il pacchetto PowerShell.

   > curl https://packages.microsoft.com/config/rhel/7/prod.repo | sudo tee /etc/yum.repos.d/microsoft.repo
   > sudo yum install -y powershell
   

2. Installa il pacchetto gssapi.

   Il pacchetto gssapi è necessario per l'autenticazione dal server Linux Google SecOps o dall'agente remoto al server Windows su cui è in esecuzione Exchange durante la sessione PowerShell.

   Esempio di installazione di gssapi per CentOS 7:

   > sudo yum install -y gssntlmssp
   

3. Attiva la comunicazione remota di PowerShell sul server Windows su cui è in esecuzione Exchange in base al documento Enable-PSRemoting disponibile nella documentazione di Microsoft.

4. Attiva l'autenticazione di base in Exchange.

   Questa integrazione utilizza l'autenticazione di base, che deve essere attivata esplicitamente nel server Exchange.

   

5. Configura l'account.

   L'account da utilizzare con l'integrazione deve essere aggiunto al ruolo di amministratore "Discover Management" nella console Exchange Admin Center (EAC). Per eseguire l'azione Regole del flusso di posta, devi aggiungere un ruolo Regole di trasporto all'utente pertinente:

   • Vai all'EAC e fai clic su permissions (autorizzazioni).
   • Seleziona Discovery Management e aprilo.

   

   • Nella sezione Ruoli, fai clic su Aggiungi e seleziona Regole di trasporto.

   

   • Fai clic su Aggiungi ->, poi su Ok e Salva.

   

   • Il ruolo viene aggiunto alla sezione Ruoli assegnati. La replica delle autorizzazioni potrebbe richiedere un po' di tempo.

   

Configura l'integrazione di Exchange Extension Pack in Google SecOps

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

Parametri di integrazione

Utilizza i seguenti parametri per configurare l'integrazione:

Nome visualizzato del parametro	Tipo	Valore predefinito	Is Mandatory	Descrizione
Indirizzo del server Exchange on-premise	Stringa	x.x.x.x	No	Indirizzo del server di posta (nome host o IP) a cui connettersi.
URI di conformità di Exchange Office365	Stringa	https://ps.compliance.protection.outlook.com/powershell-liveid/	No	URI PowerShell del Centro sicurezza e conformità di Microsoft 365 da utilizzare per eseguire le operazioni di conformità. Per saperne di più, consulta il documento Connettiti a PowerShell per la conformità della sicurezza.
URI PowerShell di Exchange Office365 Online	Stringa	https://outlook.office365.com/powershell-liveid	No	URI di Microsoft 365 Online PowerShell da utilizzare per eseguire le operazioni di gestione di Microsoft 365. Per saperne di più, consulta il documento Connettersi a PowerShell per la conformità della sicurezza.
Dominio	Stringa	example.com	No	Dominio con cui eseguire l'autenticazione sul server di posta.
Nome utente	Stringa	utente	No	Nome utente per l'autenticazione sul server di posta. Nel caso di Microsoft 365, fornisci un indirizzo email utente come nome utente.
Password	Password	N/D	No	Una password per l'autenticazione sul server di posta.
Exchange è on-prem?	Casella di controllo	Deselezionata	No	Specifica se il server di posta di destinazione è Exchange on-premise.
Is Office365 (Exchange Online)?	Casella di controllo	Deselezionata	No	Specifica se il server di posta di destinazione è Microsoft 365 (Exchange Online).

Nota: se necessario, puoi apportare modifiche in un secondo momento. Una volta configurate, le istanze possono essere utilizzate nei playbook. Per informazioni dettagliate sulla configurazione e sul supporto di più istanze, consulta Supporto di più istanze.

Azioni

Elimina ricerca di conformità

Descrizione

Elimina la ricerca di conformità e tutti i risultati di recupero o le attività di eliminazione delle email associati.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	Is Mandatory	Descrizione
Nome della ricerca di conformità	Stringa	N/D	Sì	Nome della ricerca di conformità da eliminare. Il nome non deve contenere caratteri speciali.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

N/A

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se l'azione ha esito positivo, la ricerca e le azioni di conformità vengono eliminate (is_success=true): "Azione eseguita correttamente e la ricerca di conformità e tutte le attività associate di recupero dei risultati o di eliminazione delle email sono state eliminate." L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook: Se la destinazione è Exchange on-premise o Microsoft 365, ma PowerShell non è installato sul server Google SecOps: "Failed to execute action because powershell is not installed on Google SecOps server! Consulta le istruzioni di configurazione su come installare PowerShell. Error is {0}".format(exception.stacktrace) Se la destinazione è Exchange on-premise, ma il pacchetto del sistema operativo gssntlmssp non è installato sul server Google SecOps: "Impossibile eseguire l'azione perché il pacchetto gssntlmssp non è installato sul server Google SecOps. Consulta le istruzioni di configurazione su come installare PowerShell. Error is {0}".format(exception.stacktrace) Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Impossibile eseguire l'azione. Error is {0}".format(exception.stacktrace)	Generale

Recupera i risultati di ricerca sulla conformità

Descrizione

Recupera i risultati della ricerca di conformità completata.

Nota: vengono visualizzati al massimo 200 elementi, ma la ricerca effettiva può avere più risultati di quelli mostrati.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	Is Mandatory	Descrizione
Nome della ricerca di conformità	Stringa	N/D	Sì	Nome della ricerca di conformità. Il nome non deve contenere caratteri speciali.
Numero massimo di email da restituire	Numero intero	N/D	No	Specifica il numero di email che l'azione può restituire.
Rimuovere la ricerca di conformità al termine dell'azione?	Casella di controllo	Selezionata	No	Specifica se l'azione deve rimuovere dal server Exchange l'azione di ricerca e le eventuali attività di recupero o eliminazione correlate una volta completata l'azione.
Creare una tabella di output della bacheca richieste?	Casella di controllo	Selezionata	No	Specifica se l'azione deve creare la tabella di output della bacheca richieste. Se il parametro "Numero massimo di email da restituire" è impostato su un numero maggiore, ti consigliamo di deselezionare questa opzione per aumentare le prestazioni dell'azione.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

[
  {
    "Location": "[e-mail]",
    "Sender": "James Bond",
    "Subject": "search test",
    "Type": "Email",
    "Size": "61772",
    "Received Time": "3/12/2021 9:43:59 AM",
    "Data Link": "data/All/FLDR5402c62d-7730-4c93-8f34-6bxxxxxxxxxx/BATCH0000/MSG192bc965-18c9-4c06-8834-2cxxxxxxxxxx.eml",
    "Name": "test"
  },
  {
    "Location": "[e-mail]",
    "Sender": "James Bond",
    "Subject": "search test 2",
    "Type": "Email",
    "Size": "60881",
    "Received Time": "3/12/2021 9:43:59 AM",
    "Data Link": "data/All/FLDR5402c62d-7730-4c93-8f34-6bxxxxxxxxxx/BATCH0000/MSG9eefda9c-b1b5-46f0-8a54-bdxxxxxxxxxx.eml",
    "Name": "test"
  }
]

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se l'azione viene eseguita correttamente e viene creata l'azione di conformità (is_success=true): "L'azione è stata eseguita correttamente ed è stata creata l'attività per recuperare i risultati di ricerca di conformità" Una volta completata l'azione: "Results for the Compliance Search {0} were successfully fetched".format(compliance search name) Se l'azione non è in grado di trovare la ricerca di conformità in base al nome fornito (is_success=false): "Action was not able to find compliance search {0}".format(compliance_search_name) Se l'azione non è andata a buon fine a causa di un altro errore non critico (is_success=false): "L'azione non è stata completata correttamente a causa di errori. Errors information: {0}".format(error.stacktrace) L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook: Se la destinazione è Exchange on-prem o Microsoft 365, ma PowerShell non è installato sul server Google SecOps: "Failed to execute action because powershell is not installed on Google SecOps server! Consulta le istruzioni di configurazione su come installare PowerShell. Error is {0}".format(exception.stacktrace) Se la destinazione è Exchange on-prem, ma il pacchetto del sistema operativo gssntlmssp non è installato sul server Google SecOps: "Failed to execute action because gssntlmssp package is not installed on Google SecOps server! Consulta le istruzioni di configurazione su come installare PowerShell. Error is {0}".format(exception.stacktrace) Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Impossibile eseguire l'azione. Error is {0}".format(exception.stacktrace)	Generale
Tabella	Titolo della tabella: Risultati delle azioni di ricerca per la conformità Colonne della tabella: Ora di ricezione Mittente Destinatario Oggetto	Generale

Dindin

Descrizione

Testa la connettività al server Exchange o Microsoft 365 con i parametri forniti nella pagina di configurazione dell'integrazione nella pagina Google SecOps Content Hub.

Parametri

N/D

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

N/A

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se l'operazione va a buon fine: "Connessione al server Exchange o Microsoft 365 eseguita con i parametri di connessione forniti." L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook: Se non è selezionata nessuna casella di controllo (Microsoft 365/Exchange on-prem): "Specifica il tipo di server di posta a cui connetterti: Exchange on-prem o Microsoft 365" Se entrambe le caselle di controllo sono selezionate (Microsoft 365/Exchange on-prem): "È supportato un solo tipo di server di posta alla volta. Specifica il tipo di server di posta a cui connetterti: Exchange on-premise o Microsoft 365" Se la destinazione è Exchange on-prem o Microsoft 365, ma PowerShell non è installato sul server Google SecOps: "Failed to execute action because powershell is not installed on Google SecOps server! Consulta le istruzioni di configurazione su come installare PowerShell. Error is {0}".format(exception.stacktrace) Se la destinazione è Exchange on-prem, ma il pacchetto del sistema operativo gssntlmssp non è installato sul server Google SecOps: "Failed to execute action because gssntlmssp package is not installed on Google SecOps server! Consulta le istruzioni di configurazione su come installare PowerShell. Error is {0}".format(exception.stacktrace) Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Impossibile eseguire l'azione. Error is {0}".format(exception.stacktrace)	Generale

Elimina i risultati di ricerca di conformità

Descrizione

Elimina definitivamente le email trovate dalla ricerca di conformità completata.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	Is Mandatory	Descrizione
Nome della ricerca di conformità	Stringa	N/D	Sì	Nome della ricerca di conformità. Il nome non deve contenere caratteri speciali.
Eseguire un'eliminazione definitiva delle email eliminate?	Casella di controllo	Deselezionata	No	Specifica se eseguire HardDelete. Questa opzione si applica solo a Microsoft 365 e contrassegna le email per la rimozione definitiva dalla casella di posta.
Rimuovere la ricerca di conformità al termine dell'azione?	Casella di controllo	Selezionata	No	Specifica se l'azione deve rimuovere dal server Exchange l'azione di ricerca e le eventuali attività di recupero o eliminazione correlate una volta completata l'azione.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

{
  "Item count": "5",
  "Purge Type": "SoftDelete"
}

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se l'azione ha esito positivo e viene creata l'azione di conformità (is_success=true): "L'azione è stata eseguita correttamente ed è stata creata l'attività per eliminare le email trovate con la ricerca di conformità" Una volta completata l'azione: "I risultati della ricerca di conformità {0} sono stati eliminati correttamente".format(compliance search name) Se l'azione non è in grado di trovare la ricerca di conformità in base al nome fornito (is_success=false): "Action was not able to find compliance search {0}".format(compliance_search_name) Se l'azione non restituisce risultati: "La ricerca di conformità {0} non ha restituito risultati . Aggiorna i risultati di ricerca o modifica la query di ricerca per la conformità ed esegui di nuovo la ricerca".format(compliance search name) L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook: Se la destinazione è Exchange on-premise o Microsoft 365, ma PowerShell non è installato sul server Google SecOps: "Failed to execute action because powershell is not installed on Google SecOps server! Consulta le istruzioni di configurazione su come installare PowerShell. Error is {0}".format(exception.stacktrace) Se la destinazione è Exchange on-premise, ma il pacchetto del sistema operativo gssntlmssp non è installato sul server Google SecOps: "Impossibile eseguire l'azione perché il pacchetto gssntlmssp non è installato sul server Google SecOps. Consulta le istruzioni di configurazione su come installare PowerShell. Error is {0}".format(exception.stacktrace) Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Impossibile eseguire l'azione. Error is {0}".format(exception.stacktrace)	Generale

Esegui ricerca di conformità

Descrizione

Esegui la ricerca di conformità di Exchange in base alle condizioni di ricerca fornite. Se la casella di controllo Recupera i risultati di ricerca di conformità è selezionata, l'azione restituisce i risultati di ricerca in modo simile all'azione Recupera i risultati di ricerca di conformità.

Exchange Compliance Search fornisce un meccanismo rapido per eseguire ricerche in più caselle di posta, particolarmente utile per le organizzazioni di grandi dimensioni con più di 1000 caselle di posta.

Nota: questa azione non funziona sulle entità Google SecOps.

Se la casella di controllo "Recuperare i risultati di ricerca di conformità?" è selezionata, viene visualizzato un massimo di 200 elementi, ma la ricerca effettiva può avere più risultati di quelli mostrati.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	Is Mandatory	Descrizione
Nome della ricerca di conformità	Stringa	N/D	Sì	Nome della ricerca di conformità. Il nome non deve contenere caratteri speciali.
Filtro per oggetto	Stringa	N/D	No	Condizione di filtro, specifica l'oggetto per la ricerca delle email.
Filtro mittente	Stringa	N/D	No	Condizione di filtro: specifica chi deve essere il mittente delle email necessarie.
Filtro destinatario	Stringa	N/D	No	Condizione di filtro: specifica chi deve essere il destinatario delle email necessarie.
Operatore	DDL	E	Sì	Operatore da utilizzare per creare la query dalle condizioni precedenti.
Intervallo di tempo (ore)	Stringa	N/D	No	Intervallo di tempo in ore per la ricerca delle email.
Posizione in cui cercare le email	Stringa	N/D	Sì	La posizione in cui cercare le email può essere una delle seguenti: Un elenco separato da virgole di caselle di posta Un gruppo di distribuzione o un gruppo di sicurezza abilitato alla posta Tutti: per tutte le caselle di posta dell'organizzazione
Recuperare i risultati di ricerca sulla conformità?	Casella di controllo	Deselezionata	No	Specifica se l'azione deve recuperare immediatamente i risultati di ricerca di conformità. Viene visualizzato un massimo di 200 elementi, ma la ricerca effettiva può avere più risultati di quelli mostrati.
Numero massimo di email da restituire	Numero intero	N/D	No	Specifica il numero di email che l'azione può restituire.
Creare una tabella di output della bacheca richieste?	Casella di controllo	Selezionata	No	Specifica se l'azione deve creare la tabella di output della bacheca richieste. Se il parametro "Numero massimo di email da restituire" è impostato su un numero maggiore, ti consigliamo di deselezionare questa opzione per aumentare le prestazioni dell'azione.
Query avanzata	Stringa	N/D	No	Anziché i filtri per oggetto, mittente o destinatario, fornisci una query su cui vuoi eseguire la ricerca di conformità. Per saperne di più, consulta i documenti Riferimento per la sintassi di Keyword Query Language (KQL) e Proprietà dei messaggi indicizzate dalla ricerca di Exchange.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

{
  "Name": "test",
  "RunBy": "James Bond",
  "JobEndTime": "2021-03-18T12:42:49.92",
  "Status": "Completed"
}

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Se l'azione viene eseguita correttamente e viene creata la conformità (is_success=true): "L'azione è stata eseguita correttamente ed è stata creata la ricerca di conformità" Una volta completata la ricerca: "Compliance Search {0} successfully completed".format(compliance search name) Se la casella di controllo per recuperare i risultati della ricerca di conformità è selezionata: "I risultati della ricerca di conformità {0} sono stati recuperati correttamente".format(nome della ricerca di conformità) Se la casella di controllo per recuperare i risultati della ricerca di conformità è selezionata, ma l'azione non restituisce alcun risultato: "La ricerca di conformità {0} non ha restituito alcun risultato . Aggiorna i risultati di ricerca o modifica la query di ricerca per la conformità ed esegui di nuovo la ricerca".format(compliance search name) L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook: Se la destinazione è Exchange on-prem o Microsoft 365, ma PowerShell non è installato sul server Google SecOps: "Failed to execute action because powershell is not installed on Google SecOps server! Consulta le istruzioni di configurazione su come installare PowerShell. Error is {0}".format(exception.stacktrace) Se la destinazione è Exchange on-prem, ma il pacchetto del sistema operativo gssntlmssp non è installato sul server Google SecOps: "Failed to execute action because gssntlmssp package is not installed on Google SecOps server! Consulta le istruzioni di configurazione su come installare PowerShell. Error is {0}".format(exception.stacktrace) Se viene segnalato un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server o altro: "Impossibile eseguire l'azione. Error is {0}".format(exception.stacktrace)	Generale

Aggiungi domini alle regole del flusso di posta di Exchange-Siemplify

Descrizione

L'azione riceve un elenco di domini come parametro e può creare una nuova regola, filtrando i domini dal tuo Exchange Server. Le azioni da intraprendere possono essere modificate nei parametri utilizzando i parametri delle regole.

Nota: per utilizzare questa azione, configura le autorizzazioni di gestione dell'organizzazione. Per saperne di più, consulta Autorizzazioni delle funzionalità in Exchange Online.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	Is Mandatory	Descrizione
Domini	Stringa	N/D	No	Specifica i domini che vuoi aggiungere alla regola in un elenco separato da virgole.
Regola per aggiungere domini a	DDL	Siemplify - Domains List - Permanently Delete	Sì	Specifica la regola a cui aggiungere i domini. Se la regola non esiste, l'azione la crea dove manca.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

{
  "success": [
    "test1.com",
    "test2.com"
  ],
  "already_available": [
    "test3.com"
  ],
  "invalid": [
    "invalid"
  ]
}

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve avere esito negativo e non deve interrompere l'esecuzione del playbook: Se l'operazione va a buon fine (le regole vengono aggiornate di conseguenza, gli input sono corretti): "Sono stati aggiunti i seguenti input alle regole corrispondenti: Domini: successfull_domains Regole aggiornate: Rules_updated_names_list Se almeno uno degli input non è corretto (indirizzo email non valido nel parametro, email non valida nel nome dell'entità): "Impossibile aggiungere i seguenti input alla regola:"+ Unsuccessful_email_addresses L'azione non deve riuscire e l'esecuzione del playbook deve essere interrotta: Se viene segnalato un errore: "Error performing "Add Domains to Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)	Generale

Aggiungi mittenti alle regole del flusso di posta di Exchange-Siemplify

Descrizione

L'azione riceve un elenco di indirizzi email come parametro o funziona sulle entità utente con espressioni regolari email (se i parametri non vengono forniti) e può creare una nuova regola, filtrando i mittenti dal tuo server Exchange. Le azioni possono essere modificate nei parametri utilizzando il parametro della regola.

Nota: per utilizzare questa azione, configura le autorizzazioni di gestione dell'organizzazione. Per maggiori informazioni, consulta il documento Feature permissions in Exchange Online disponibile nella documentazione del prodotto Microsoft.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	Is Mandatory	Descrizione
Indirizzi email	Stringa	N/D	No	Specifica gli indirizzi email che vuoi aggiungere alla regola in un elenco separato da virgole. Se non viene fornito alcun parametro, l'azione funziona con le entità User.
Regola a cui aggiungere i mittenti	DDL	Siemplify - Senders List - Permanently Delete	Sì	Specifica la regola a cui aggiungere il mittente. Se la regola non esiste, l'azione la crea dove manca.
Devo aggiungere anche il dominio dei mittenti alla regola Elenco di domini corrispondente?	Casella di controllo	Deselezionata	No	Specifica se l'azione deve estrarre automaticamente i domini degli indirizzi email forniti e aggiungerli anche alle regole di dominio corrispondenti (stessa azione della regola per i domini).

Esegui il

Questa azione funziona sull'entità User, se l'espressione regolare dell'email è valida per questa entità e se non vengono forniti parametri.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

{
  "success": [
    "[e-mail]",
    "[e-mail]"
  ],
  "already_available": [
    "[e-mail]"
  ],
  "invalid": [
    "invalid"
  ]
}

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve avere esito negativo e non deve interrompere l'esecuzione del playbook: Se l'operazione va a buon fine (le regole vengono aggiornate di conseguenza, gli input sono corretti): "Sono stati aggiunti i seguenti input alle regole corrispondenti: Indirizzi email:"+ Successful_email_addresses+ "Domini:"+ successfull_domains+ "Regole aggiornate:"+ rules_updated_names_list Se almeno uno degli input non è corretto (indirizzo email non valido nel parametro, email non valida nel nome dell'entità): "Impossibile aggiungere i seguenti input alla regola:"+ Unsuccessful_email_addresses L'azione non deve riuscire e l'esecuzione del playbook deve essere interrotta: Se viene segnalato un errore: "Error performing "Add Senders to Exchange-Siemplify Mail Flow Rule" action : {0}".format(exception.stacktrace)	Generale

Elimina le regole del flusso di posta di Exchange-Siemplify

Descrizione

L'azione riceve un nome di regola come parametro e la elimina.

Nota: per utilizzare questa azione, configura le autorizzazioni di gestione dell'organizzazione. Per saperne di più, consulta Autorizzazioni delle funzionalità in Exchange Online.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	Is Mandatory	Descrizione
Nome della regola da eliminare	DDL	Siemplify - Senders List - Permanently Delete Valori possibili: Siemplify - Senders List - Permanently Delete Siemplify - Domains List - Permanently Delete Tutte le regole del flusso di posta Exchange-Siemplify disponibili	Sì	Specifica il nome della regola che vuoi eliminare completamente.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

N/A

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve avere esito negativo e non deve interrompere l'esecuzione del playbook: Per le regole eliminate correttamente: "Successfully deleted the following rules :" succesful_rule_names Se le regole non vengono trovate in Exchange: "Impossibile eliminare le seguenti regole: "+unseccessful_rule_names+", poiché non sono state trovate in Exchange. Assicurati di aver scelto i nomi delle regole appropriati e riprova." Se non vengono trovate regole in Exchange: "Impossibile eliminare i nomi delle regole forniti, poiché non sono stati trovati in Exchange. Assicurati di aver scelto i nomi delle regole appropriati e riprova." L'azione non deve riuscire e l'esecuzione del playbook deve essere interrotta: Se viene segnalato un errore: "Error performing "Delete Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)	Generale

Elenco delle regole del flusso di posta di Exchange-Siemplify

Descrizione

L'azione riceve un nome di regola come parametro e lo elenca.

Nota: per utilizzare questa azione, configura le autorizzazioni di gestione dell'organizzazione. Per saperne di più, consulta Autorizzazioni delle funzionalità in Exchange Online.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	Is Mandatory	Descrizione
Nome regola da elencare	DDL	Siemplify - Senders List - Permanently Delete Valori possibili: Siemplify - Senders List - Permanently Delete Siemplify - Domains List - Permanently Delete Tutte le regole del flusso di posta Exchange-Siemplify disponibili	Sì	Specifica il nome della regola che vuoi elencare.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

[
  {
    "Priority": 0,
    "ManuallyModified": false,
    "Description": "If the message:\r\n\tIs received from '[e-mail]' or '[e-mail]'\r\nTake the following actions:\r\n\tDelete the message without notifying the recipient or sender\r\n",
    "Conditions": [
      "Microsoft.Exchange.MessagingPolicies.Rules.Tasks.FromPredicate"
    ],
    "Actions": [
      "Microsoft.Exchange.MessagingPolicies.Rules.Tasks.DeleteMessageAction"
    ],
    "State": "Enabled",
    "Mode": "Enforce",
    "FromAddressContainsWords": null,
    "Identity": "Siemplify - Senders List - Permanently Delete",
    "Name": "Siemplify - Senders List - Permanently Delete",
    "DistinguishedName": "CN=Siemplify - Senders List - Permanently Delete,CN=TransportVersioned,CN=Rules,CN=Transport Settings,CN=mwc,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=exlab,DC=local",
    "IsValid": true,
    "From": [
      "[e-mail]",
      "[e-mail]"
    ],
    "Guid": "xxxxx426-b665-41f9-82e0-0f1fd63xxxxx",
    "ImmutableId": "xxxxx426-b665-41f9-82e0-0f1fd63xxxxx",
    "WhenChanged": "/Date(1621952909000)/",
    "ExchangeVersion": "0.1 (8.0.535.0)",
    "OrganizationId": "",
    "ObjectState": "Unchanged"
  },
  {
    "Priority": 1,
    "ManuallyModified": false,
    "Description": "If the message:\r\n\tIncludes these words in the sender's address: 'example1.com' or 'example2.com'\r\nTake the following actions:\r\n\tDelete the message without notifying the recipient or sender\r\n",
    "Conditions": [
      "Microsoft.Exchange.MessagingPolicies.Rules.Tasks.FromAddressContainsPredicate"
    ],
    "Actions": [
      "Microsoft.Exchange.MessagingPolicies.Rules.Tasks.DeleteMessageAction"
    ],
    "State": "Enabled",
    "Mode": "Enforce",
    "FromAddressContainsWords": [
      "example1.com",
      "example2.com"
    ],
    "Identity": "Siemplify - Domains List - Permanently Delete",
    "Name": "Siemplify - Domains List - Permanently Delete",
    "DistinguishedName": "CN=Siemplify - Domains List - Permanently Delete,CN=TransportVersioned,CN=Rules,CN=Transport Settings,CN=mwc,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=exlab,DC=local",
    "IsValid": true,
    "From": null,
    "Guid": "xxxxx697-e143-41aa-8dee-b783a78xxxxx",
    "ImmutableId": "xxxxx697-e143-41aa-8dee-b783a78xxxxx",
    "WhenChanged": "/Date(1621952960000)/",
    "ExchangeVersion": "0.1 (8.0.535.0)",
    "OrganizationId": "",
    "ObjectState": "Unchanged"
  }
]

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve non riuscire né interrompere l'esecuzione di un playbook: Per le regole trovate correttamente: "Successfully listed the following rules :" succesful_rule_names In case rules are not found in Exchange: "Could not list the following rules: "+unseccessful_rule_names+", since they were not found in Exchange. Assicurati di aver scelto i nomi delle regole appropriati e riprova." Se non vengono trovate regole in Exchange: "Impossibile elencare i nomi delle regole forniti, poiché non sono stati trovati in Exchange. Assicurati di aver scelto i nomi delle regole appropriati e riprova." L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook: Se viene segnalato un errore: "Error performing "List Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)	Generale

Rimuovi i domini dalle regole del flusso di posta di Exchange-Siemplify

Descrizione

L'azione riceve un elenco di domini come parametro e può rimuovere i domini forniti dalle regole esistenti.

Nota: per utilizzare questa azione, configura le autorizzazioni di gestione dell'organizzazione. Per saperne di più, consulta Autorizzazioni delle funzionalità in Exchange Online.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	Is Mandatory	Descrizione
Domini	Stringa	N/D	No	Specifica i domini che vuoi rimuovere dalla regola in un elenco separato da virgole. Se non viene fornito alcun parametro, l'azione funziona con le entità.
Regola da cui rimuovere i domini	DDL	Siemplify - Domains List - Permanently Delete	Sì	Specifica la regola da cui rimuovere i domini. Se la regola non esiste, l'azione non ha alcun effetto.
Rimuovi i domini da tutte le regole disponibili	Casella di controllo	Deselezionata	No	Specifica se l'azione deve cercare i domini forniti in tutte le regole del flusso di posta di Google SecOps.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

{
  "success": [
    "test1.com",
    "test2.com"
  ],
  "didn't_exist": [
    "test3.com"
  ],
  "invalid": [
    "invalid"
  ]
}

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve avere esito negativo e non deve interrompere l'esecuzione del playbook: Se l'operazione va a buon fine (le regole vengono aggiornate di conseguenza, gli input sono corretti): "I seguenti input sono stati rimossi dalle regole corrispondenti:" Domini: successfull_domains Regole aggiornate: Rules_updated_names_list L'azione non deve riuscire e l'esecuzione del playbook deve essere interrotta: Se viene segnalato un errore: "Error performing "Remove Domains from Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)	Generale

Rimuovi i mittenti dalle regole del flusso di posta di Exchange-Siemplify

Descrizione

L'azione riceve un elenco di mittenti come parametro o agisce sulle entità utente (se i parametri non vengono forniti) e può rimuovere i mittenti forniti dalle regole esistenti.

Nota: per utilizzare questa azione, configura le autorizzazioni di gestione dell'organizzazione. Per saperne di più, consulta Autorizzazioni delle funzionalità in Exchange Online.

Parametri

Nome visualizzato del parametro	Tipo	Valore predefinito	Is Mandatory	Descrizione
Mittenti	Stringa	N/D	No	Specifica i mittenti che vuoi rimuovere dalla regola in un elenco separato da virgole. Se non viene fornito alcun parametro, l'azione funziona con le entità.
Regola per rimuovere i mittenti da	DDL	Siemplify Senders List - Permanently Delete	Sì	Specifica la regola da cui rimuovere i mittenti. Se la regola non esiste, l'azione non ha alcun effetto.
Vuoi rimuovere i domini dei mittenti anche dalla regola Elenco di domini corrispondente?	Casella di controllo	Deselezionata	No	Specifica se l'azione deve estrarre automaticamente i domini degli indirizzi email forniti e rimuoverli anche dalle regole di dominio corrispondenti (stessa azione della regola per i domini).

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script

Nome del risultato dello script	Opzioni del valore	Esempio
is_success	Vero/Falso	is_success:False

Risultato JSON

{
  "success": [
    "[e-mail]",
    "[e-mail]"
  ],
  "didn't_exist": [
    "[e-mail]"
  ],
  "invalid": [
    "invalid"
  ]
}

Bacheca casi

Tipo di risultato	Valore / Descrizione	Tipo
Messaggio di output*	L'azione non deve avere esito negativo e non deve interrompere l'esecuzione del playbook: Se l'operazione va a buon fine (le regole vengono aggiornate di conseguenza, gli input sono corretti): messaggio: "I seguenti input sono stati rimossi dalle regole corrispondenti:" Mittenti : successfull_senders Regole aggiornate: rules_updated_names_list Se almeno uno degli input non è corretto (indirizzo email non valido nel parametro, email non valida nel nome dell'entità): "Impossibile aggiungere i seguenti input alla regola:"+ Unsuccessful_email_addresses L'azione non deve riuscire e l'esecuzione del playbook deve essere interrotta: Se viene segnalato un errore: "Error performing "Remove Senders from Exchange-Siemplify Mail Flow Rules" action : {0}".format(exception.stacktrace)	Generale

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