Raccogli i log di ManageEngine Exchange Reporter Plus
Questo documento spiega come configurare ManageEngine Exchange Reporter Plus per inviare i log a Google Security Operations utilizzando i webhook.
ManageEngine Exchange Reporter Plus è una soluzione di reporting, controllo e monitoraggio basata sul web per gli ambienti Microsoft Exchange Server ed Exchange Online. Fornisce report completi sulle dimensioni delle caselle di posta, sul traffico email, sulle cartelle pubbliche, sui log di Exchange ActiveSync e sugli audit log per le attività degli amministratori e le modifiche alla configurazione nelle implementazioni di Exchange ibride.
Prima di iniziare
Assicurati di soddisfare i seguenti prerequisiti:
- Un'istanza Google SecOps
- ManageEngine Exchange Reporter Plus installato e configurato per monitorare Exchange Server o Exchange Online
- Accesso amministrativo alla console web di ManageEngine Exchange Reporter Plus
- Accesso alla console Google Cloud (per la creazione delle chiavi API)
Crea un feed webhook in Google SecOps
Crea il feed
- Vai a Impostazioni > Gestione dei dati > Feed. Se utilizzi una piattaforma solo SIEM, vai a Impostazioni > Feed.
- Fai clic su Aggiungi nuovo feed di notizie.
- Nella pagina successiva, fai clic su Configura un singolo feed.
- Nel campo Nome feed, inserisci un nome per il feed (ad es.
ManageEngine Exchange Reporter Plus Logs). - Seleziona Webhook come Tipo di origine.
- Seleziona ManageEngine Exchange Reporter Plus come Tipo di log.
- Fai clic su Avanti.
- Specifica i valori per i seguenti parametri di input:
- (Facoltativo) Delimitatore di suddivisione: inserisci
\nper suddividere gli eventi su più righe. - Spazio dei nomi dell'asset: lo spazio dei nomi dell'asset
- Etichette di importazione: l'etichetta da applicare agli eventi di questo feed
- (Facoltativo) Delimitatore di suddivisione: inserisci
- Fai clic su Avanti.
- Controlla la nuova configurazione del feed di notizie nella schermata Finalizza, quindi fai clic su Invia.
Genera e salva la chiave segreta
Dopo aver creato il feed, devi generare una chiave segreta per l'autenticazione:
- Nella pagina dei dettagli del feed, fai clic su Genera chiave segreta.
- Viene visualizzata una finestra di dialogo con la chiave segreta.
- Copia e salva la chiave segreta in modo sicuro.
Importante: la chiave segreta viene visualizzata una sola volta e non può essere recuperata in un secondo momento. Se la perdi, devi generare una nuova chiave segreta.
Ottieni l'URL dell'endpoint del feed
- Vai alla scheda Dettagli del feed.
- Nella sezione Informazioni sull'endpoint, copia l'URL endpoint del feed.
Il formato dell'URL è:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:importDove
{region}è la regione dell'istanza Google SecOps (ad esempious,europeoasia-southeast1) e{parent}è il percorso della risorsa nel formatoprojects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.Salva questo URL per i passaggi successivi.
Fai clic su Fine.
Crea una chiave API Google Cloud
Chronicle richiede una chiave API per l'autenticazione. Crea una chiave API limitata nella console Google Cloud .
Crea la chiave API
- Vai alla pagina Credenziali della consoleGoogle Cloud .
- Seleziona il tuo progetto (il progetto associato alla tua istanza di Chronicle).
- Fai clic su Crea credenziali > Chiave API.
- Viene creata una chiave API, che viene visualizzata in una finestra di dialogo.
- Fai clic su Modifica chiave API per limitare la chiave.
Limita la chiave API
- Nella pagina delle impostazioni della chiave API:
- Nome: inserisci un nome descrittivo (ad esempio
Chronicle Webhook API Key)
- Nome: inserisci un nome descrittivo (ad esempio
- In Restrizioni API:
- Seleziona Limita chiave.
- Nel menu a discesa Seleziona API, cerca e seleziona API Google SecOps (o API Chronicle).
- Fai clic su Salva.
- Copia il valore della chiave API dal campo Chiave API nella parte superiore della pagina.
- Salva la chiave API in modo sicuro.
Configura il webhook ManageEngine Exchange Reporter Plus
Crea l'URL webhook
Combina l'URL dell'endpoint Chronicle, la chiave API e la chiave segreta:
<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>Esempio:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
Configura l'inoltro dei log in Exchange Reporter Plus
- Accedi alla console web di ManageEngine Exchange Reporter Plus come amministratore.
- Vai a Impostazioni > Amministratore > Impostazioni generali > Agente di inoltro dei log.
- Seleziona la casella di controllo Enable Log Forwarding (Abilita l'inoltro dei log).
- Fai clic sulla scheda Webhook.
- Fornisci i seguenti dettagli di configurazione:
- Metodo HTTP: seleziona POST.
- URL HTTP: incolla l'URL webhook completo creato nel passaggio precedente (l'URL dell'endpoint Chronicle con la chiave API e la chiave secret aggiunte come parametri di ricerca).
- Nella sezione Impostazioni avanzate:
- Fai clic su Intestazioni delle richieste HTTP.
- Aggiungi la seguente intestazione:
- Chiave:
Content-Type - Valore:
application/json
- Chiave:
Fai clic su Salva.
Verifica l'inoltro dei log
- Dopo aver salvato la configurazione, Exchange Reporter Plus inizierà a inoltrare i log di controllo a Google SecOps tramite l'endpoint webhook.
- Accedi alla console Google SecOps e verifica che i log vengano visualizzati nell'interfaccia di ricerca con l'etichetta di importazione
MANAGE_ENGINE_REPORTER_PLUS.
Configurazione del firewall
Assicurati che siano configurate le seguenti regole firewall.
In uscita dal server Exchange Reporter Plus:
- Protocollo: HTTPS (TCP 443)
- Destinazione: endpoint regionale di Chronicle (
<region>-chronicle.googleapis.com) - Scopo: invio dei log a Google SecOps tramite webhook
Riferimento ai metodi di autenticazione
I feed webhook di Chronicle supportano diversi metodi di autenticazione. Scegli il metodo supportato dal tuo fornitore.
Metodo 1: intestazioni personalizzate (consigliato)
Se il tuo fornitore supporta le intestazioni HTTP personalizzate, utilizza questo metodo per una maggiore sicurezza.
Formato della richiesta:
POST <ENDPOINT_URL> HTTP/1.1 Content-Type: application/json x-goog-chronicle-auth: <API_KEY> x-chronicle-auth: <SECRET_KEY> { "event": "data", "timestamp": "2025-01-15T10:30:00Z" }
Vantaggi:
- Chiave API e secret non visibili nell'URL
- Più sicuro (le intestazioni non vengono registrate nei log di accesso del server web)
- Metodo preferito quando il fornitore lo supporta
Metodo 2: parametri di query
Se il tuo fornitore non supporta le intestazioni personalizzate, aggiungi le credenziali all'URL.
Formato dell'URL:
<ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>Esempio:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...Formato della richiesta:
POST <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY> HTTP/1.1 Content-Type: application/json { "event": "data", "timestamp": "2025-01-15T10:30:00Z" }
Svantaggi: - Credenziali visibili nell'URL - Potrebbero essere registrate nei log di accesso del server web - Meno sicuro delle intestazioni
Metodo 3: ibrido (URL + intestazione)
Alcune configurazioni utilizzano la chiave API nell'URL e la chiave secret nell'intestazione.
Formato della richiesta:
POST <ENDPOINT_URL>?key=<API_KEY> HTTP/1.1 Content-Type: application/json x-chronicle-auth: <SECRET_KEY> { "event": "data", "timestamp": "2025-01-15T10:30:00Z" }
Nomi delle intestazioni di autenticazione
Chronicle accetta i seguenti nomi di intestazione per l'autenticazione:
Per la chiave API:
x-goog-chronicle-auth(consigliata)X-Goog-Chronicle-Auth(senza distinzione tra maiuscole e minuscole)
Per la chiave secret:
x-chronicle-auth(consigliata)X-Chronicle-Auth(senza distinzione tra maiuscole e minuscole)
Limiti e best practice dei webhook
Limiti per le richieste
| Limite | Valore |
|---|---|
| Dimensioni massime della richiesta | 4 MB |
| QPS (query al secondo) max | 15.000 |
| Timeout richieste | 30 secondi |
| Comportamento dei nuovi tentativi | Automatico con backoff esponenziale |
Tabella di mappatura UDM
| Campo log | Mappatura UDM | Logica |
|---|---|---|
| msg.OrganizationId | additional.fields | Etichette unite con la chiave "OrganizationId" e il valore di msg.OrganizationId; la chiave "MailboxGuid" e il valore di msg.MailboxGuid; la chiave "RecordType" e il valore di msg.RecordType |
| msg.MailboxGuid | additional.fields | |
| msg.RecordType | additional.fields | |
| msg.CreationTime | metadata.event_type | Impostato sul valore di event_type se non è vuoto; altrimenti "USER_UNCATEGORIZED" se msg.Operation == "Update"; altrimenti "USER_CREATION" se msg.Operation == "Create" e msg.MailboxOwnerUPN non è vuoto; altrimenti "USER_UNCATEGORIZED" se msg.Operation == "Create"; altrimenti "USER_UNCATEGORIZED" se msg.UserId non è vuoto; altrimenti "STATUS_UPDATE" se msg.ClientIP non è vuoto; altrimenti "GENERIC_EVENT" |
| msg.Operation | metadata.product_event_type | Valore copiato direttamente |
| msg.Id | metadata.product_log_id | Valore copiato direttamente |
| msg.ClientVersion | metadata.product_version | Valore di msg.ClientVersion se non vuoto, altrimenti msg.Version convertito in stringa |
| msg.Version | metadata.product_version | |
| AffectedItems.0.InternetMessageId | network.email.mail_id | Gsub < |
| AffectedItems | network.email.subject | Analizzato come JSON, estratto item.Subject, unito se trovato |
| msg.ClientInfoString | network.http.user_agent | Valore di msg.ClientInfoString se non è vuoto, altrimenti msg.Client |
| msg.Client | network.http.user_agent | |
| msg.ClientProcessName | principal.application | Valore copiato direttamente |
| msg.OriginatingServer | principal.hostname | Estratto utilizzando il pattern grok, se l'operazione ha esito positivo, altrimenti il valore viene copiato direttamente |
| clientIP | principal.ip | Estratto da msg.ClientIP utilizzando grok |
| clientPort | principal.port | Estratto da msg.ClientIP utilizzando grok, convertito in numero intero |
| msg.UserKey | principal.user.attribute.labels | Imposta la chiave dell'etichetta su "UserKey", il valore su msg.UserKey, unito |
| msg.UserType | principal.user.attribute.roles | Imposta roles.name su msg.UserType, unito |
| msg.UserId | principal.user.email_addresses | Unito se msg.UserId corrisponde all'espressione regolare dell'email |
| msg.UserId | principal.user.userid | Valore copiato direttamente |
| msg.MailboxOwnerSid | principal.user.windows_sid | Valore di msg.MailboxOwnerSid se non è vuoto, altrimenti msg.LogonUserSid |
| msg.LogonUserSid | principal.user.windows_sid | |
| security_result | security_result | Unito dall'hash security_result |
| security_result_action | security_result.action | Unito da security_result_action |
| msg.ResultStatus | security_result.action_details | Valore copiato direttamente |
| msg.RecordType | security_result.detection_fields | Convertito in stringa, impostata la chiave "RecordType", il valore su msg.RecordType, unito |
| msg.OrganizationName | target.administrative_domain | Valore copiato direttamente |
| msg.DestFolder | target.file.full_path | fileId e filePath estratti utilizzando grok, barre rovesciate gsub, concatenate come fileId/filePath |
| host | target.hostname | Valore copiato direttamente |
| msg.Folder | target.process.parent_process.file.full_path | Estrazione di parentFileId e parentFilePath utilizzando grok, gsubs con barre rovesciate, concatenati come parentFileId/parentFilePath |
| msg.MailboxOwnerUPN | target.user.email_addresses | Unito se corrisponde all'espressione regolare dell'email |
| msg.MailboxOwnerUPN | target.user.user_display_name | Imposta se contiene uno spazio |
| msg.MailboxOwnerUPN | target.user.userid | Imposta se non è un'email e non contiene spazi |
| metadata.product_name | metadata.product_name | Impostato su "Manage Engine" |
| metadata.vendor_name | metadata.vendor_name | Imposta su "Manage Engine Reporter Plus" |
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.