Connettore Google Workspace (G Suite) (con Funzioni di Azure) per Microsoft Sentinel
Il connettore dati di Google Workspace offre la possibilità di inserire gli eventi dell'attività di Google Workspace in Microsoft Sentinel tramite l'API REST. Il connettore consente di ottenere eventi che consentono di esaminare i potenziali rischi per la sicurezza, analizzare l'uso della collaborazione del team, diagnosticare i problemi di configurazione, tenere traccia degli accessi e quando, analizzare le attività di amministratore, comprendere come gli utenti creano e condividono il contenuto e altri eventi di revisione nell'organizzazione.
Questo contenuto è generato automaticamente. Per modifiche, contattare il provider di soluzioni.
Attributi connettore
| Attributo connettore | Descrizione |
|---|---|
| Codice dell'app per le funzioni di Azure | https://aka.ms/sentinel-GWorkspaceReportsAPI-functionapp |
| Tabelle Log Analytics | GWorkspace_ReportsAPI_admin_CL GWorkspace_ReportsAPI_calendar_CL GWorkspace_ReportsAPI_drive_CL GWorkspace_ReportsAPI_login_CL GWorkspace_ReportsAPI_mobile_CL GWorkspace_ReportsAPI_token_CL GWorkspace_ReportsAPI_user_accounts_CL |
| Supporto regole di raccolta dati | Non è al momento supportato |
| Supportata da: | Microsoft Corporation |
Esempi di query
Eventi di Google Workspace - Tutte le attività
GWorkspaceActivityReports
| sort by TimeGenerated desc
Eventi di Google Workspace - Attività amministratore
GWorkspace_ReportsAPI_admin_CL
| sort by TimeGenerated desc
Eventi di Google Workspace - Attività del calendario
GWorkspace_ReportsAPI_calendar_CL
| sort by TimeGenerated desc
Eventi di Google Workspace - Attività drive
GWorkspace_ReportsAPI_drive_CL
| sort by TimeGenerated desc
Eventi di Google Workspace - Attività di accesso
GWorkspace_ReportsAPI_login_CL
| sort by TimeGenerated desc
Eventi di Google Workspace - Attività per dispositivi mobili
GWorkspace_ReportsAPI_mobile_CL
| sort by TimeGenerated desc
Eventi di Google Workspace - Attività token
GWorkspace_ReportsAPI_token_CL
| sort by TimeGenerated desc
Eventi di Google Workspace - Attività degli account utente
GWorkspace_ReportsAPI_user_accounts_CL
| sort by TimeGenerated desc
Prerequisiti
Per eseguire l'integrazione con Google Workspace (G Suite) (usando Funzioni di Azure) assicurarsi di avere:
- autorizzazioni Microsoft.Web/siti: sono necessarie autorizzazioni di lettura e scrittura per Funzioni di Azure al fine di creare un'app per le funzioni. Vedere la documentazione per altre informazioni su Funzioni di Azure.
- Credenziali/autorizzazioni dell'API REST: GooglePickleString è necessario per l'API REST. Per altre informazioni sull'API, vedere la documentazione. Trovare le istruzioni per ottenere le credenziali nella sezione di configurazione seguente. È possibile controllare tutti i requisiti e seguire anche le istruzioni riportate qui.
Istruzioni per l’installazione di Vendor
Nota
Questo connettore usa Funzioni di Azure per connettersi all'API Di Google Reports per eseguire il pull dei log in Microsoft Sentinel. Ciò potrebbe comportare costi aggiuntivi per l'inserimento dati. Verificare la pagina prezzi di Funzioni di Azure per altre informazioni.
(Passaggio facoltativo) Archiviare in modo sicuro le chiavi o i token dell'area di lavoro e dell'API in Azure Key Vault. Azure Key Vault offre un meccanismo sicuro per archiviare e recuperare i valori delle chiavi. Seguire queste istruzioni per usare Azure Key Vault con un'App per le funzioni di Azure.
NOTA: per funzionare come previsto questo connettore dati dipende da un parser basato su una funzione Kusto, che viene distribuito come parte della soluzione. Per visualizzare il codice della funzione in Log Analytics, aprire il pannello Log Analytics/Microsoft Sentinel Logs, fare clic su Funzioni e cercare l'alias GWorkspaceReports e caricare il codice della funzione, nella seconda riga della query immettere i nomi host dei dispositivi GWorkspaceReports e qualsiasi altro identificatore univoco per il logstream. La funzione richiede in genere 10-15 minuti per l'attivazione dopo l'installazione/aggiornamento della soluzione.
PASSAGGIO 1 - Verificare i prerequisiti per ottenere la stringa di Selezione Google
- Python 3 o versione successiva è installato.
- Lo strumento di gestione dei pacchetti pip è disponibile.
- Dominio di Google Workspace con accesso all'API abilitato.
- Un account Google in tale dominio con privilegi di amministratore.
PASSAGGIO 2 - Passaggi di configurazione per l'API Google Reports
- Accedere alla console cloud di Google con le credenziali https://console.cloud.google.comdi amministratore dell'area di lavoro.
- Usando l'opzione di ricerca (disponibile nella parte superiore centrale), cercare API e servizi
- Dalle API e dai servizi abilitati> alle API e ai servizi, abilitare l'API admin SDK per questo progetto.
- Passare a API e servizi -> Schermata di consenso OAuth. Se non è già configurato, creare una schermata di consenso OAuth seguendo questa procedura:
- Specificare Il nome dell'app e altre informazioni obbligatorie.
- Aggiungere domini autorizzati con Accesso API abilitato.
- Nella sezione Ambiti aggiungere l'ambito dell'API Admin SDK.
- Nella sezione Utenti di test verificare che l'account amministratore di dominio sia stato aggiunto.
- Passare ad API e servizi ->Credenziali e creare l'ID client OAuth 2.0
- Fare clic su Crea credenziali nella parte superiore e selezionare ID client OAuth.
- Selezionare Applicazione Web nell'elenco a discesa Tipo di applicazione.
- Specificare un nome appropriato per l'app Web e aggiungere http://localhost:8081/ come uno degli URI di reindirizzamento autorizzati.
- Dopo aver fatto clic su Crea, scaricare il codice JSON dal popup visualizzato. Rinominare il file in "credentials.json".
- Per recuperare Google Pickel String, eseguire lo script Python dalla stessa cartella in cui viene salvato credentials.json.
- Quando viene visualizzato per l'accesso, usare le credenziali dell'account amministratore di dominio per accedere.
Nota: questo script è supportato solo nel sistema operativo Windows. 7. Dall'output del passaggio precedente copiare Google Pickle String (contenuto tra virgolette singole) e tenerlo a portata di mano. Sarà necessario nel passaggio di distribuzione dell'app per le funzioni.
PASSAGGIO 3: scegliere UNA tra le due opzioni di distribuzione seguenti per distribuire il connettore e la funzione di Azure associata
IMPORTANTE: prima di distribuire il connettore dati dell'area di lavoro, disporre dell'ID area di lavoro e della chiave primaria dell'area di lavoro (può essere copiato dai seguenti), nonché dell'area di lavoro GooglePickleString immediatamente disponibile.
Opzione 1 - Modello di Azure Resource Manager (ARM)
Usare questo metodo per la distribuzione automatica del connettore dati di Google Workspace usando un modello di Resource Manager.
Fare clic sul pulsante Distribuisci in Azure sotto.
Selezionare la Sottoscrizione preferita, il Gruppo di risorse e la Località.
Immettere l'ID dell'area di lavoro, la chiave dell'area di lavoro, GooglePickleString e distribuire.
Contrassegnare la casella di controllo etichettata Accetto le condizioni riportate sopra.
Fare clic su Acquista per effettuare la distribuzione.
Opzione 2 - Distribuzione manuale di Funzioni di Azure
Usare le istruzioni dettagliate seguenti per distribuire manualmente il connettore dati di Google Workspace con Funzioni di Azure (distribuzione tramite Visual Studio Code).
1. Distribuire un'App per le funzioni
NOTA: sarà necessario preparare VS Code per lo sviluppo di funzioni di Azure.
Scaricare il file App per le funzioni di Azure. Estrarre l'archivio nel computer di sviluppo locale.
Avviare VS Code. Scegliere File nel menu principale quindi selezionare Apri cartella.
Selezionare la cartella di primo livello dai file estratti.
Selezionare l'icona di Azure nella barra attività, quindi nell'area Azure: Funzioni scegliere il pulsante Distribuisci nell'app per le funzioni. Se non si ha ancora effettuato l'accesso, selezionare l'icona di Azure nella barra attività, quindi nell'area Azure: Funzioni scegliere Accedi ad Azure. Se si ha già effettuato l'accesso, andare al passaggio successivo.
Quando richiesto, immettere le informazioni seguenti:
a. Seleziona cartella: scegliere una cartella dall'area di lavoro o selezionarne una che contenga l'app per le funzioni.
b. Selezionare Sottoscrizione: scegliere la sottoscrizione da usare.
c. Selezionare Crea nuova App per le funzioni in Azure (non scegliere l'opzione Avanzata)
d. Immettere un nome univoco globale per l'app per le funzioni: Digitare un nome valido in un percorso URL. Il nome digitato viene convalidato per assicurarsi che sia univoco in Funzioni di Azure. (ad esempio GWorkspaceXXXXX).
e. Selezionare un runtime: scegliere Python 3.8.
f. Select a location for new resources. Per prestazioni migliori e costi inferiori, scegliere la stessa area in cui si trova Microsoft Sentinel.
La distribuzione avrà inizio. Dopo la creazione dell'app per le funzioni e dopo l'applicazione del pacchetto di distribuzione viene visualizzata una notifica.
Andare al portale di Azure per la configurazione dell'App per le funzioni.
2. Configurare l'App per le funzioni
Nell'App per le funzioni selezionare Nome App per le funzioni seguito da Configurazione.
Nella scheda Impostazioni applicazione selezionare ** Nuova impostazione applicazione**.
Aggiungere singolarmente ognuna delle impostazioni dell'applicazione seguenti, con i rispettivi valori stringa (distinzione tra maiuscole e minuscole): GooglePickleString WorkspaceID WorkspaceKey LogAnalyticsUri (facoltativo)
(Facoltativo) Se necessario, modificare i ritardi predefiniti.
NOTA: sono stati aggiunti i valori predefiniti seguenti per i ritardi di inserimento per diversi set di log di Google Workspace in base alla documentazione di Google. Questi possono essere modificati in base ai requisiti ambientali. Ritardo recupero recupero - Ritardo recupero calendario 10 minuti - Ritardo recupero chat 6 ore - Ritardo recupero account utente 1 giorno - Ritardo recupero 3 ore di accesso - 6 ore
Usare logAnalyticsUri per eseguire l'override dell'endpoint dell'API di Log Analytics per il cloud dedicato. Ad esempio, per il cloud pubblico lasciare vuoto il valore; per l'ambiente cloud Azure GovUS, specificare il valore nel formato seguente:
https://<CustomerId>.ods.opinsights.azure.us.Dopo aver immesso tutte le impostazioni dell'applicazione, fare clic su Salva.
Passaggi successivi
Per altre informazioni, visitare la soluzione correlata in Azure Marketplace.