Mimecast

Questo documento fornisce indicazioni su come integrare Mimecast con Google SecOps.

Casi d'uso

  1. Esegui l'importazione dei messaggi
  2. Eseguire un'azione di triage (rifiuto/rilascio/segnalazione del messaggio)

Prima di iniziare

Prima di procedere, assicurati che il tuo ambiente Mimecast sia preparato con le licenze di prodotto e i ruoli amministrativi necessari.

Prodotti e servizi Mimecast richiesti

Per assicurarti che l'integrazione dell'API Mimecast 2.0 funzioni correttamente, il tuo account Mimecast deve disporre di licenze per i seguenti prodotti:

Autorizzazioni richieste per il ruolo Mimecast

Per configurare l'integrazione di Mimecast, devi prima creare un ruolo Mimecast con le autorizzazioni richieste nella console di amministrazione di Mimecast.

Le autorizzazioni richieste sono le seguenti:

  • Account | Dashboard | Read

  • Account | Monitoring | Held | Edit

  • Archive | Search Logs | Read

  • Archive | View Logs | Read

  • Gateway | Managed Senders | Edit

  • Gateway | Policies | Edit

  • Gateway | Policies | Read

  • Gateway | Tracking | Read

Configura l'integrazione di Mimecast 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
Root API Stringa https:/<<api root>> Sì Radice API dell'istanza Mimecast.
ID applicazione Stringa N/D Sì ID applicazione dell'istanza Mimecast.
Chiave applicazione Password N/D Sì Chiave applicazione dell'istanza Mimecast.
Chiave di accesso Password N/D Sì Chiave di accesso dell'istanza Mimecast.
Chiave segreta Password N/D Sì Chiave segreta dell'istanza Mimecast.
Verifica SSL Casella di controllo Selezionata Sì Se abilitata, verifica che il certificato SSL per la connessione al server Mimecast sia valido.

Azioni

Dindin

Descrizione

Testa la connettività a Mimecast 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
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve fallire né interrompere l'esecuzione di un playbook:
se l'operazione va a buon fine: "Connessione al server Mimecast stabilita con i parametri di connessione forniti."

L'azione non deve andare a buon fine e deve interrompere l'esecuzione di un playbook:
if not successful: "Failed to connect to the Mimecast server! Error is {0}".format(exception.stacktrace)

 Generale

Descrizione

Cerca le email archiviate utilizzando i parametri definiti in Mimecast.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
Campi da restituire CSV

attachmentcount,status,subject,
size,receiveddate,displayfrom,
displayfromaddress,id,displayto,
displaytoaddresslist,smash

 Sì Specifica un elenco di campi separati da virgole che devono essere restituiti.
Caselle di posta CSV N/D No Specifica un elenco separato da virgole di caselle di posta in cui eseguire la ricerca.
Da CSV N/D No Specifica un elenco separato da virgole di indirizzi email da cui sono state inviate le email.
A CSV N/D No Specifica un elenco separato da virgole di indirizzi email a cui sono state inviate le email.
Oggetto Stringa N/D No Specifica un oggetto da cercare.
Intervallo di tempo DDL

Ultima ora

Valori possibili:

Ultima ora

Ultime 6 ore

Ultime 24 ore

Settimana scorsa

Mese scorso

Personalizzato

 Sì Specifica un intervallo di tempo per la ricerca. Se selezioni "Personalizzato", devi anche fornire l'"Ora di inizio".
Ora di inizio Stringa N/D No Specifica l'ora di inizio della ricerca. Questo parametro è obbligatorio se per il parametro "Periodo di tempo" è selezionato "Personalizzato". Formato: ISO 8601
Ora di fine Stringa N/D No Specifica l'ora di fine della ricerca. Formato: ISO 8601. Se non viene fornito alcun valore e per il parametro "Periodo di tempo" è selezionata l'opzione "Personalizzato", questo parametro utilizzerà l'ora corrente.
Numero massimo di email da restituire Integrazione 50 No Specifica il numero di email da restituire. Valore predefinito: 50.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve fallire né interrompere l'esecuzione di un playbook:
se i dati sono disponibili(is_success = true): "Successfully found archive emails for the provided criteria in Mimecast".

Se i dati non sono disponibili (is_success=true): "No archive emails were found for the provided criteria in Mimecast" (Non sono state trovate email di archivio per i criteri forniti in Mimecast)



L'azione non dovrebbe riuscire e dovrebbe interrompere l'esecuzione di un playbook:
se si verifica un errore irreversibile, come credenziali errate, nessuna connessione al server, altro: "Errore durante l'esecuzione dell'azione "Ricerca semplice nell'archivio". Reason: {0}''.format(error.Stacktrace)

Se l'ora di inizio è vuota, quando "Periodo di tempo" è "Personalizzato": "Errore durante l'esecuzione dell'azione "Ricerca semplice nell'archivio". Motivo: "Ora di inizio" deve essere fornita quando è selezionato "Personalizzato" nel parametro "Periodo di tempo"."

Se l'esecuzione non va a buon fine o si verificano errori: Errore durante l'esecuzione dell'azione "Ricerca semplice nell'archivio". Reason: fail/errors/message".

Generale
Tabella della bacheca casi

Nome: Risultati

Colonne:

Tutte le chiavi della risposta

 Generale

Descrizione

Cerca le email archiviate utilizzando una query XML personalizzata in Mimecast.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
Query XML XML N/D Sì Specifica una query XML da utilizzare per la ricerca delle email di archivio. Per ulteriori dettagli, consulta la documentazione.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve fallire né interrompere l'esecuzione di un playbook:
se i dati sono disponibili(is_success = true): "Successfully found archive emails for the provided criteria in Mimecast".

Se i dati non sono disponibili (is_success=true): "No archive emails were found for the provided criteria in Mimecast".

L'azione non dovrebbe riuscire e dovrebbe interrompere l'esecuzione di un playbook:
se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Error executing action "Advanced Archive Search". Reason: {0}''.format(error.Stacktrace)

Se fail/errors contiene valori: Errore durante l'esecuzione dell'azione "Ricerca avanzata nell'archivio". Reason: fail/errors/message".

Generale
Tabella della bacheca casi

Nome: Risultati

Colonne:

Tutte le chiavi della risposta

 Generale

Rifiuta messaggio

Descrizione

Rifiuta il messaggio in Mimecast. Nota: è possibile rifiutare solo i messaggi con lo stato "Trattenuto".

Parametri

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
ID messaggio Stringa N/D Sì Specifica l'ID del messaggio che deve essere rifiutato.
Nota Stringa N/D No Specifica una nota aggiuntiva contenente una spiegazione del motivo per cui il messaggio è stato rifiutato.
Motivo DLL

Selezionane uno

Valori possibili:

Selezionane uno

Comunicazione inappropriata

Informazioni riservate

Contro le norme relative alle email

Contenuti con limitazioni

 No Specifica il motivo del rifiuto.
Invia una notifica al mittente Casella di controllo Deselezionata No Se l'opzione è attiva, l'azione invierà una notifica al mittente in merito al rifiuto.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve fallire né interrompere l'esecuzione di un playbook:
Se non sono presenti "errori" nella risposta (is_success = true): "Messaggio con ID "{ID}" rifiutato correttamente in Mimecast".

L'azione non dovrebbe riuscire e dovrebbe interrompere l'esecuzione di un playbook:
in caso di errore irreversibile, come credenziali errate, nessuna connessione al server, altro: "Errore durante l'esecuzione dell'azione "Rifiuta messaggio". Reason: {0}''.format(error.Stacktrace)

Se l'errore contiene valori: Errore durante l'esecuzione dell'azione "Rifiuta messaggio". Reason: fail/errors/message".

Generale

Messaggio di rilascio

Descrizione

Rilascia il messaggio in Mimecast. Nota: è possibile sbloccare solo i messaggi con stato "Trattenuto".

Parametri

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
ID messaggio Stringa N/D Sì Specifica l'ID del messaggio che deve essere sbloccato.
Rilascia su Sandbox Casella di controllo N/D No Se l'opzione è attiva, l'azione rilascerà il messaggio nella sandbox.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo
Messaggio di output*

L'azione non deve avere esito negativo né interrompere l'esecuzione di un playbook:
Se non sono presenti "errori" nella risposta (is_success = true): "Messaggio con ID "{ID}" rilasciato correttamente in Mimecast".

L'azione deve avere esito negativo e interrompere l'esecuzione di un playbook:
In caso di errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Errore durante l'esecuzione dell'azione "Rilascia messaggio". Reason: {0}''.format(error.Stacktrace)

Se fail/errors contiene valori: Errore durante l'esecuzione dell'azione "Sblocca messaggio". Reason: fail/errors/message".

Generale

Segnala messaggio - Ritirato

Segnala il messaggio in Mimecast.

Input azione

Parametro Descrizione
Message IDs

Obbligatorio.

Specifica l'ID del messaggio da segnalare.
Report as

Facoltativo.

Specifica il tipo di report per il messaggio.

I valori possibili sono:

  • Spam
  • Malware
  • Phishing
Comment

Facoltativo.

Specifica il commento per il report.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore
is_success is_success=False/is_success=True
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 i dati sono disponibili (is\_success = true): stampa "I seguenti messaggi con ID "{ID}" sono stati segnalati correttamente in Mimecast".
  • Se fail/errors contiene valori: stampa "Errore durante l'esecuzione dell'azione "Segnala messaggio". Reason: fail/errors/message".

L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook:

  • In caso di errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: stampa "Errore durante l'esecuzione dell'azione "Segnala messaggio". Reason: {0}''.format(error.Stacktrace).
 Generale

Blocca mittente

Descrizione

Blocca il mittente in Mimecast.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
Mittente Stringa N/D Sì Specifica l'indirizzo email del mittente da bloccare.
Destinatario Stringa N/D Sì Specifica l'indirizzo email del destinatario da bloccare.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve fallire né interrompere l'esecuzione di un playbook:
Se non sono presenti "errori" nella risposta (is_success = true): "Mittente {sender} bloccato correttamente per il destinatario {recipient} in Mimecast".

L'azione non dovrebbe riuscire e dovrebbe interrompere l'esecuzione di un playbook:
se si verifica un errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Errore durante l'esecuzione dell'azione "Blocca mittente". Reason: {0}''.format(error.Stacktrace)

Se fail/errors contiene valori: Errore durante l'esecuzione dell'azione "Blocca mittente". Reason: fail/errors/message".

 Generale

Autorizza mittente

Descrizione

Autorizza il mittente in Mimecast.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
Mittente Stringa N/D Sì Specifica l'indirizzo email del mittente da consentire.
Destinatario Stringa N/D Sì Specifica l'indirizzo email del destinatario da consentire.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni del valore
is_success is_success=False
is_success is_success=True
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve fallire né interrompere l'esecuzione di un playbook:
Se non sono presenti "errori" nella risposta (is_success = true): "Mittente {sender} autorizzato correttamente per il destinatario {recipient} in Mimecast".

L'azione non deve riuscire e deve interrompere l'esecuzione di un playbook:
in caso di errore irreversibile, ad esempio credenziali errate, nessuna connessione al server, altro: "Errore durante l'esecuzione dell'azione "Consenti mittente". Reason: {0}''.format(error.Stacktrace)

Se fail/errors contiene valori: Errore durante l'esecuzione dell'azione "Consenti mittente". Reason: fail/errors/message".

 Generale

Crea policy Blocca mittente

Crea una policy per bloccare i mittenti in Mimecast.

Esegui il

Questa azione non viene eseguita su nessuna entità.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito Filigrana Is Mandatory Descrizione
Risposta DDL N/D N/D No Specifica il tipo di risposta che verrà associato alla policy creata.
Descrizione Stringa N/D N/D Sì Descrizione della policy.
Dati estratti DDL N/D N/D Definisci da dove devono essere estratte le informazioni sul mittente e sul destinatario.
Mittente Stringa N/D N/D No Il mittente del messaggio da bloccare. Obbligatorio solo se "Tipo di mittente" è uno dei seguenti: Dominio email, Indirizzo email, Nome visualizzato nell'intestazione. Questo parametro viene ignorato se viene selezionato un valore "Tipo di origine" diverso.
Tipo di mittente DDL N/D N/D No Tipo di mittente per la policy.
Destinatario Stringa N/D N/D No A chi deve essere inviato il messaggio affinché venga bloccato. Obbligatorio solo se "Tipo di destinatario" è uno dei seguenti: Dominio email, Indirizzo email, Nome visualizzato nell'intestazione. Questo parametro viene ignorato se viene selezionato un valore "Tipo di destinatario" diverso.
Tipo di destinatario DDL N/D N/D No Il tipo di destinatario della policy.
Commento Stringa N/D N/D No Commento per una policy.
Bidirezionale Bool N/D N/D No Se abilitata, la policy verrà definita in modo bidirezionale.
Applicato Bool N/D N/D No Se viene attivata, la policy viene applicata.
Ora di inizio Stringa N/D N/D No Ora di inizio della policy. Se non viene fornito alcun valore, l'ora di inizio verrà impostata su "eternal". Prevede il formato ISO 8601. Esempio: 2025-03-07T16:03:00Z
Ora di fine Stringa N/D N/D No Ora di fine della policy. Se non viene fornito alcun valore, l'ora di fine verrà impostata su "eterna". È previsto il formato ISO 8601. Esempio: 2025-03-07T16:03:00Z

Risultati dell'azione

Tipo Disponibile
Risultato script Vero
Risultato JSON Vero
Tabella di arricchimento Falso
Tabella della bacheca casi Falso
Link alla bacheca casi Falso
Allegato della bacheca casi Falso
Risultato script
Nome del risultato dello script Opzioni del valore
is_success is_success=False
is_success is_success=True
Risultato JSON
{
   "option": "block_sender",
   "id": "eNo1jr0OgjAYAN-lqw79QKyYOCCSiCJGqSCjlmqQn2ILNmp8d3Fwv8vdGynOOsnzDE3RSsP4ZTT0tPUMO3DL1pK-LrFZzzfJ9XJTrC78yPZgcc7CW1QdSLuUo11Mfc2rpIsfxlxQHFsDFXKPdkeq10ym7uJeDIKLA6Z66T1NUklI4c3QEDWizNnzVzYnBthDxDrViopLJjLe77iHyAEgjkmgpx9cqlzUaAp_kz4b7vc2YDzCny9vYUEo",
   "policy": {
       "description": "Description",
       "fromPart": "both",
       "from": {
           "type": "individual_email_address",
           "emailAddress": "example@exampl.com"
       },
       "to": {
           "type": "individual_email_address",
           "emailAddress": "exampleto@exampl.com"
       },
       "fromType": "individual_email_address",
       "fromValue": "example@exampl.com",
       "toType": "individual_email_address",
       "toValue": "exampleto@exampl.com",
       "fromEternal": true,
       "toEternal": true,
       "fromDate": "1900-01-01T00:00:00+0000",
       "toDate": "2100-01-01T23:59:59+0000",
       "override": false,
       "bidirectional": false,
       "conditions": {},
       "enabled": true,
       "enforced": true,
       "createTime": "2025-03-27T12:51:46+0000",
       "lastUpdated": "2025-03-27T12:51:46+0000"
   }
}
Bacheca casi
Tipo di risultato Valore/Descrizione Tipo (Entità \ Generale)
Messaggio di output*

L'azione non deve causare errori o interrompere l'esecuzione di un playbook:


If no "errors" in the response (is_success = true): print "Successfully created a block sender policy in Mimecast".

L'azione dovrebbe non riuscire e interrompere l'esecuzione di un playbook:

if fatal error, like wrong credentials, no connection to server, other:print "Error executing action "{action name}". Reason: {0}''.format(error.Stacktrace)

Se fail/errors contiene valori: Errore durante l'esecuzione dell'azione "{action name}". Reason: fail/errors/message".

Connettore

Mimecast - Connettore di monitoraggio dei messaggi

Descrizione

Estrai le informazioni sui messaggi dalla scheda "Message Tracking" (Monitoraggio dei messaggi) in Mimecast. Nota: la lista consentita funziona sul parametro "queueDetailStatus/bounceType".

Configura il connettore Mimecast - Message Tracking in Google SecOps

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

Parametri del connettore

Utilizza i seguenti parametri per configurare il connettore:

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
Nome campo prodotto Stringa Nome prodotto Sì Inserisci il nome del campo di origine per recuperare il nome del campo del prodotto.
Nome campo evento Stringa event_type Sì Inserisci il nome del campo di origine per recuperare il nome del campo evento.
Nome campo ambiente Stringa "" No

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

Se il campo dell'ambiente non viene trovato, l'ambiente è quello predefinito.
Pattern regex dell'ambiente Stringa .* No

Un pattern regex da eseguire sul valore trovato nel campo "Nome campo ambiente".

Il valore predefinito è .* per rilevare tutto e restituire il valore invariato.

Utilizzato per consentire all'utente di manipolare il campo dell'ambiente tramite la logica delle espressioni regolari.

Se il pattern regex è nullo o vuoto o se il valore dell'ambiente è nullo, il risultato finale dell'ambiente è l'ambiente predefinito.
Timeout dello script (secondi) Int 180 Sì Limite di timeout per il processo Python che esegue lo script corrente.
Root API Stringa https:/<<api root>> Sì Radice API dell'istanza Mimecast.
ID applicazione Stringa N/D Sì ID applicazione dell'istanza Mimecast.
Chiave applicazione Password N/D Sì Chiave applicazione dell'istanza Mimecast.
Chiave di accesso Password N/D Sì Chiave di accesso dell'istanza Mimecast.
Chiave segreta Password N/D Sì Chiave segreta dell'istanza Mimecast.
Domini CSV N/D Sì Un elenco separato da virgole di domini per cui eseguire query sui messaggi.
Rischio di recupero minimo Stringa N/D No

Rischio minimo che verrà utilizzato per recuperare i messaggi. Valori possibili:

Trascurabile, Basso, Medio, Alto.

Se non viene fornito alcun valore, il connettore importerà tutti i messaggi.
Filtro per stato CSV held

Un elenco separato da virgole di filtri di stato per i messaggi. Valori possibili: delivery, held, accepted, bounced, deferred, rejected, archived.

Se non viene fornito alcun valore, il connettore importerà tutti i messaggi.
Filtro route CSV N/D

Un filtro di route separato da virgole per i messaggi. I valori possibili sono: internal, outbound, inbound.

Se non viene fornito alcun valore, il connettore importerà tutti i messaggi.
Filtro motivo coda CSV N/D

Un elenco separato da virgole di motivi di quarantena che devono filtrare i messaggi. Se non viene fornito alcun valore, questo filtro viene ignorato.
Importa i messaggi senza rischi Casella di controllo Se abilitato, il connettore importerà i messaggi anche se non sono presenti informazioni sul rischio. Gli avvisi di Google SecOps generati da questi messaggi avranno la priorità impostata su Informativa.
Numero massimo di ore indietro Numero intero 1 No Numero di ore da cui recuperare i messaggi. Valore predefinito: 1 ora. Max: 30 giorni.
Numero massimo di messaggi da restituire Numero intero 100 No Il numero di messaggi da elaborare per un'iterazione del connettore. Valore predefinito: 100.
Utilizza la lista consentita come lista bloccata Casella di controllo Selezionata Sì Se questa opzione è attiva, la lista consentita verrà utilizzata come lista bloccata.
Verifica SSL Casella di controllo Selezionata Sì Se abilitata, verifica che il certificato SSL per la connessione al server Mimecast sia valido.
Indirizzo del server proxy Stringa N/D No L'indirizzo del server proxy da utilizzare.
Nome utente proxy Stringa N/D No Il nome utente del proxy con cui eseguire l'autenticazione.
Password proxy Password N/D No La password del proxy con cui eseguire l'autenticazione.

Regole del connettore

Supporto dei proxy

Il connettore supporta il proxy.

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