Raccogli i log di posta di Mimecast
Questo documento descrive come raccogliere i log di Mimecast Secure Email Gateway configurando un feed di Google Security Operations.
Per saperne di più, consulta Acquisizione dei dati in Google Security Operations.
Un'etichetta di importazione identifica il parser che normalizza i dati dei log non elaborati nel formato UDM strutturato. Le informazioni contenute in questo documento si applicano al parser con l'etichetta di importazione MIMECAST_MAIL.
Configura Mimecast Secure Email Gateway
- Abilita il logging per l'account di accesso.
- Crea l'applicazione API.
- Recupera l'ID applicazione e la chiave applicazione.
Abilita il logging per l'account di accesso
- Accedi alla console di amministrazione di Mimecast.
- Nel menu Account, fai clic su Impostazioni account.
- Espandi Logging avanzato.
- Seleziona i tipi di log da attivare:
- In entrata: registra i messaggi provenienti da mittenti esterni e indirizzati a destinatari interni.
- In uscita: registra i messaggi di log inviati da mittenti interni a destinatari esterni.
- Interno: registra i messaggi di log all'interno dei domini interni.
- Fai clic su Salva per applicare le modifiche.
Crea l'applicazione API
- Accedi alla console di amministrazione di Mimecast.
- Fai clic su Add API Application (Aggiungi applicazione API).
- Inserisci i seguenti dettagli:
- Nome applicazione.
- Descrizione dell'applicazione.
- Categoria: inserisci una delle seguenti categorie:
- Integrazione SIEM: fornisce un'analisi in tempo reale degli avvisi di sicurezza generati dall'applicazione.
- MSP Ordering and Provisioning: disponibile per partner selezionati per gestire gli ordini nel portale MSP.
- Email/Archiviazione: si riferisce ai messaggi e agli avvisi archiviati in Mimecast.
- Business Intelligence: consente all'infrastruttura e agli strumenti dell'applicazione di accedere alle informazioni e analizzarle per migliorare e ottimizzare le decisioni e le prestazioni.
- Automazione dei processi: consente l'automazione dei processi aziendali.
- Altro: nel caso in cui l'applicazione non rientri in nessun'altra categoria.
- Fai clic su Avanti.
- Specifica i valori per i seguenti parametri di input:
- Authentication HTTP Header Configuration (Configurazione intestazione HTTP di autenticazione): inserisci i dettagli di autenticazione nel seguente formato:
secret_key:{Access Secret}
access_key:{Access key}
app_id:{Application ID}
app_key:{application key} - Nome host API: il nome di dominio completo dell'endpoint API Mimecast. Il formato tipico è
xx-api.mimecast.com. Se non viene fornito, sarà specifico per la regione negli Stati Uniti e in Europa. Questo campo non può essere vuoto per altre regioni. - Spazio dei nomi dell'asset: lo spazio dei nomi dell'asset.
- Etichette di importazione: l'etichetta applicata agli eventi di questo feed.
- Authentication HTTP Header Configuration (Configurazione intestazione HTTP di autenticazione): inserisci i dettagli di autenticazione nel seguente formato:
- Fai clic su Avanti.
- Esamina le informazioni visualizzate nella pagina Riepilogo.
- Per correggere gli errori, segui questi passaggi:
- Fai clic sui pulsanti Modifica accanto a Dettagli o Impostazioni.
- Fai clic su Avanti e torna alla pagina Riepilogo.
Ottieni l'ID applicazione e la chiave applicazione
- Fai clic su Applicazione e poi su Servizi.
- Fai clic su Applicazione API.
- Seleziona l'applicazione API creata.
- Visualizza i dettagli dell'applicazione.
Creazione della chiave di accesso e della chiave segreta dell'API
Per informazioni sulla generazione della chiave di accesso e della chiave segreta, consulta Creazione della chiave di associazione utente.
Configura i feed
Per configurare questo tipo di log, segui questi passaggi:
- Vai a Impostazioni > Gestione dei dati > Feed. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Feed.
- Fai clic su Aggiungi nuovo feed.
- Fai clic sul feed pack Mimecast.
Specifica i valori per i seguenti campi:
- Tipo di origine: API di terze parti (consigliato)
- Intestazione HTTP di autenticazione: fornisci l'ID applicazione, la chiave di accesso, l'ID secret e la chiave dell'applicazione.
- Nome host API: specifica il nome di dominio del tuo host Mimecast.
Opzioni avanzate
- Nome del feed: un valore precompilato che identifica il feed.
- Spazio dei nomi dell'asset: spazio dei nomi associato al feed.
- Etichette di importazione: etichette applicate a tutti gli eventi di questo feed.
Fai clic su Crea feed.
Per ulteriori informazioni sulla configurazione di più feed per diversi tipi di log all'interno di questa famiglia di prodotti, consulta Configura i feed per prodotto.
Riferimento per la mappatura dei campi
Questo parser estrae le coppie chiave-valore dai log del server email Mimecast, classifica la fase della voce di log (RECEIPT, PROCESSING o DELIVERY) e mappa i campi estratti all'UDM. Esegue anche una logica specifica per gestire i campi relativi alla sicurezza, determinando l'azione, la categoria, la gravità e i dettagli correlati del risultato di sicurezza in base a valori come Act, RejType, SpamScore e Virus.
Tabella di mappatura UDM
| Campo log | Mappatura UDM | Logica |
|---|---|---|
acc |
metadata.product_log_id |
Il valore di acc del log non elaborato è mappato a metadata.product_log_id. |
Act |
security_result.action |
Se Act è Acc, il campo UDM è impostato su ALLOW. Se Act è Rej, il campo UDM è impostato su BLOCK. Se Act è Hld o Sdbx, il campo UDM è impostato su QUARANTINE. |
AttNames |
about.file.full_path |
Il campo AttNames viene analizzato, rimuovendo virgolette e spazi, e suddiviso in singoli nomi file. Ogni nome file viene quindi mappato a un campo about.file.full_path separato all'interno di un oggetto about. |
AttSize |
about.file.size |
Il valore di AttSize viene convertito in un numero intero senza segno e mappato a about.file.size. |
Dir |
network.direction |
Se Dir è Internal o Inbound, il campo UDM è impostato su INBOUND. Se Dir è External o Outbound, il campo UDM è impostato su OUTBOUND. Utilizzato anche per compilare una voce detection_fields in security_result. |
Err |
security_result.summary |
Il valore di Err è mappato a security_result.summary. |
Error |
security_result.summary |
Il valore di Error è mappato a security_result.summary. |
fileName |
principal.process.file.full_path |
Il valore di fileName è mappato a principal.process.file.full_path. |
filename_for_malachite |
principal.resource.name |
Il valore di filename_for_malachite è mappato a principal.resource.name. |
headerFrom |
network.email.from |
Il valore di headerFrom viene mappato a network.email.from se Sender non è un indirizzo email valido. Utilizzato anche per compilare una voce detection_fields in security_result. |
IP |
principal.ip o target.ip |
Se stage è RECEIPT, il valore di IP viene mappato a principal.ip. Se stage è DELIVERY, il valore di IP viene mappato a target.ip. |
MsgId |
network.email.mail_id |
Il valore di MsgId è mappato a network.email.mail_id. |
MsgSize |
network.received_bytes |
Il valore di MsgSize viene convertito in un numero intero senza segno e mappato a network.received_bytes. |
Rcpt |
target.user.email_addresses, network.email.to |
Il valore di Rcpt viene aggiunto a target.user.email_addresses. Se Rcpt è un indirizzo email valido, viene aggiunto anche a network.email.to. |
Recipient |
network.email.to |
Il valore di Recipient viene aggiunto a network.email.to se Rcpt non è un indirizzo email valido. |
RejCode |
security_result.description |
Utilizzato come parte del campo security_result.description. |
RejInfo |
security_result.description |
Utilizzato come parte del campo security_result.description. |
RejType |
security_result.description, security_result.category_details |
Utilizzato come parte del campo security_result.description. Anche il valore di RejType è mappato a security_result.category_details. Utilizzato per determinare security_result.category e security_result.severity. |
Sender |
principal.user.email_addresses, network.email.from |
Il valore di Sender viene aggiunto a principal.user.email_addresses. Se Sender è un indirizzo email valido, viene mappato anche a network.email.from. Utilizzato anche per compilare una voce detection_fields in security_result. |
Snt |
network.sent_bytes |
Il valore di Snt viene convertito in un numero intero senza segno e mappato a network.sent_bytes. |
SourceIP |
principal.ip |
Se stage è RECEIPT e IP è vuoto, il valore di SourceIP viene mappato a principal.ip. |
SpamInfo |
security_result.severity_details |
Utilizzato come parte del campo security_result.severity_details. |
SpamLimit |
security_result.severity_details |
Utilizzato come parte del campo security_result.severity_details. |
SpamScore |
security_result.severity_details |
Utilizzato come parte del campo security_result.severity_details. Utilizzato anche per determinare security_result.severity se RejType non è impostato. |
Subject |
network.email.subject |
Il valore di Subject è mappato a network.email.subject. |
Virus |
security_result.threat_name |
Il valore di Virus è mappato a security_result.threat_name. Impostato su EMAIL_TRANSACTION per impostazione predefinita, ma modificato in GENERIC_EVENT se né Sender né Recipient/Rcpt sono indirizzi email validi. Impostato sempre su Mimecast. Impostato sempre su Mimecast MTA. Impostato su Email %{stage}, dove stage viene determinato in base alla presenza e ai valori di altri campi di log. Impostato sempre su MIMECAST_MAIL. Imposta in base a RejType o SpamScore. Se non è disponibile nessuno dei due, il valore predefinito è LOW. |
sha1 |
target.file.sha1 |
Il valore di sha1 è mappato a target.file.sha1. |
sha256 |
target.file.sha256 |
Il valore di sha256 è mappato a target.file.sha256. |
ScanResultInfo |
security_result.threat_name |
Il valore di ScanResultInfo è mappato a security_result.threat_name. |
Definition |
security_result.summary |
Il valore di Definition è mappato a security_result.summary. |
spf.allow |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
spf.info |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
dkim.allow |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
dkim.info |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
dmarc.allow |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
dmarc.info |
event.idm.read_only_udm.security_result.detection_fields |
Mappato dal log delle modifiche |
md5 |
target.file.md5 |
Mappato dal log delle modifiche |
urlCategory |
principal.url_metadata.categories |
Mappato dal log delle modifiche |
credentialTheft |
security_result.detection_fields |
Mappato dal log delle modifiche |
reason |
security_result.summary |
Mappato dal log delle modifiche |
URL |
principal.url |
Mappato dal log delle modifiche |
sourceIp |
principal.ip |
Mappato dal log delle modifiche |
url |
principal.url |
Mappato dal log delle modifiche |
msgid |
network.email.mail_id |
Mappato dal log delle modifiche |
senderDomain", "AttNames", and "AttCnt |
security_result.detection_fields |
Mappato dal log delle modifiche |
Log delle modifiche
Visualizza il log delle modifiche per questo parser
Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.