Google Workspace -connector (G Suite) (met behulp van Azure Functions) voor Microsoft Sentinel
De Google Workspace-gegevensconnector biedt de mogelijkheid om Google Workspace-activiteitengebeurtenissen op te nemen in Microsoft Sentinel via de REST API. De connector biedt de mogelijkheid om gebeurtenissen op te halen die helpen bij het onderzoeken van mogelijke beveiligingsrisico's, het gebruik van samenwerking analyseren, configuratieproblemen diagnosticeren, bijhouden wie zich aanmeldt en wanneer, beheerdersactiviteiten analyseren, begrijpen hoe gebruikers inhoud maken en delen, en meer gebeurtenissen in uw organisatie bekijken.
Dit is automatisch gegenereerde inhoud. Neem contact op met de provider van de oplossing voor wijzigingen.
Verbinding maken orkenmerken
| Verbinding maken orkenmerk | Beschrijving |
|---|---|
| Code van Azure-functie-app | https://aka.ms/sentinel-GWorkspaceReportsAPI-functionapp |
| Log Analytics-tabellen | 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 |
| Ondersteuning voor regels voor gegevensverzameling | Wordt momenteel niet ondersteund |
| Ondersteund door | Microsoft Corporation |
Voorbeelden van query's
Google Workspace-gebeurtenissen - Alle activiteiten
GWorkspaceActivityReports
| sort by TimeGenerated desc
Google Workspace-gebeurtenissen - Beheer-activiteit
GWorkspace_ReportsAPI_admin_CL
| sort by TimeGenerated desc
Google Workspace-gebeurtenissen - Agenda-activiteit
GWorkspace_ReportsAPI_calendar_CL
| sort by TimeGenerated desc
Google Workspace Events - Drive Activity
GWorkspace_ReportsAPI_drive_CL
| sort by TimeGenerated desc
Google Workspace-gebeurtenissen - Aanmeldingsactiviteit
GWorkspace_ReportsAPI_login_CL
| sort by TimeGenerated desc
Google Workspace-gebeurtenissen - Mobiele activiteit
GWorkspace_ReportsAPI_mobile_CL
| sort by TimeGenerated desc
Google Workspace-gebeurtenissen - Tokenactiviteit
GWorkspace_ReportsAPI_token_CL
| sort by TimeGenerated desc
Google Workspace-gebeurtenissen - Activiteit gebruikersaccounts
GWorkspace_ReportsAPI_user_accounts_CL
| sort by TimeGenerated desc
Vereisten
Als u wilt integreren met Google Workspace (G Suite) (met behulp van Azure Functions), moet u ervoor zorgen dat u het volgende hebt:
- Machtigingen voor Microsoft.Web/sites: Lees- en schrijfmachtigingen voor Azure Functions om een functie-app te maken is vereist. Raadpleeg de documentatie voor meer informatie over Azure Functions.
- REST API-referenties/machtigingen: GooglePickleString is vereist voor REST API. Zie de documentatie voor meer informatie over API. Raadpleeg de instructies voor het verkrijgen van de referenties in de onderstaande configuratiesectie. U kunt alle vereisten controleren en ook de instructies hier volgen.
Installatie-instructies van leverancier
Notitie
Deze connector maakt gebruik van Azure Functions om verbinding te maken met de Google Reports-API om de logboeken in Microsoft Sentinel op te halen. Dit kan leiden tot extra kosten voor gegevensopname. Raadpleeg de pagina met prijzen van Azure Functions voor meer informatie.
(Optionele stap) Sla werkruimte en API-autorisatiesleutel(s) of token(s) veilig op in Azure Key Vault. Azure Key Vault biedt een veilig mechanisme voor het opslaan en ophalen van sleutelwaarden. Volg deze instructies voor het gebruik van Azure Key Vault met een Azure Function-app.
OPMERKING: Deze gegevensconnector is afhankelijk van een parser op basis van een Kusto-functie om te werken zoals verwacht, die wordt geïmplementeerd als onderdeel van de oplossing. Als u de functiecode in Log Analytics wilt weergeven, opent u de blade Log Analytics/Microsoft Sentinel-logboeken, klikt u op Functies en zoekt u naar de alias GWorkspaceReports en laadt u de functiecode. Voer op de tweede regel van de query de hostnaam(s) van uw GWorkspaceReports-apparaat(en) en andere unieke id's voor de logstream in. Het duurt meestal 10-15 minuten voordat de functie wordt geactiveerd na de installatie/update van de oplossing.
STAP 1: zorg ervoor dat de vereisten voor het verkrijgen van de Google Pickel-tekenreeks
- Python 3 of hoger is geïnstalleerd.
- Het pip-pakketbeheerprogramma is beschikbaar.
- Een Google Workspace-domein waarvoor API-toegang is ingeschakeld.
- Een Google-account in dat domein met beheerdersbevoegdheden.
STAP 2: configuratiestappen voor de Google Reports-API
- Meld u aan bij de Google-cloudconsole met uw werkruimte Beheer referentieshttps://console.cloud.google.com.
- De zoekoptie gebruiken (beschikbaar in het middelste midden), Zoeken naar API's & Services
- Schakel vanuit API's en services -> API's en services Beheer SDK-API in voor dit project.
- Ga naar api's en services -> OAuth-toestemmingsscherm. Als dit nog niet is geconfigureerd, maakt u een OAuth-toestemmingsscherm met de volgende stappen:
- Geef de app-naam en andere verplichte informatie op.
- Voeg geautoriseerde domeinen toe waarvoor API-toegang is ingeschakeld.
- Voeg in de sectie Bereiken Beheer SDK-API-bereik toe.
- Controleer in de sectie Testgebruikers of het domeinbeheerdersaccount is toegevoegd.
- Ga naar API's & Services -> Referenties en maak OAuth 2.0-client-id
- Klik bovenaan op Referenties maken en selecteer Oauth-client-id.
- Selecteer Webtoepassing in de vervolgkeuzelijst Toepassingstype.
- Geef een geschikte naam op voor de web-app en voeg deze toe http://localhost:8081/ als een van de geautoriseerde omleidings-URI's.
- Nadat u op Maken hebt geklikt, downloadt u de JSON uit het pop-upvenster dat wordt weergegeven. Wijzig de naam van dit bestand in 'credentials.json'.
- Als u Google Pickel String wilt ophalen, voert u het Python-script uit vanuit dezelfde map waarin credentials.json wordt opgeslagen.
- Wanneer u wordt weergegeven voor aanmelding, gebruikt u de referenties van het domeinbeheerdersaccount om u aan te melden.
Opmerking: dit script wordt alleen ondersteund op het Windows-besturingssysteem. 7. Kopieer in de uitvoer van de vorige stap Google Pickle String (tussen enkele aanhalingstekens) en houd deze bij de hand. Deze is nodig in de implementatiestap van de functie-app.
STAP 3: Kies EEN uit de volgende twee implementatieopties om de connector en de bijbehorende Azure-functie te implementeren
BELANGRIJK: Voordat u de connector voor werkruimtegegevens implementeert, moet u beschikken over de werkruimte-id en de primaire sleutel van de werkruimte (kan worden gekopieerd uit het volgende), evenals de Werkruimte GooglePickleString direct beschikbaar.
Optie 1: ARM-sjabloon (Azure Resource Manager)
Gebruik deze methode voor geautomatiseerde implementatie van de Google Workspace-gegevensconnector met behulp van een ARM-sjabloon.
Klik op de knop Implementeren in Azure hieronder.
Selecteer het voorkeursabonnement, de resourcegroep en de locatie.
Voer de werkruimte-id, werkruimtesleutel, GooglePickleString in en implementeer.
Markeer het selectievakje met het label Ik ga akkoord met de bovenstaande voorwaarden.
Klik op Kopen om te implementeren.
Optie 2: handmatige implementatie van Azure Functions
Gebruik de volgende stapsgewijze instructies om de Google Workspace-gegevensconnector handmatig te implementeren met Azure Functions (implementatie via Visual Studio Code).
1. Een functie-app implementeren
OPMERKING: U moet VS-code voorbereiden voor azure-functieontwikkeling.
Download het Azure Function App-bestand . Pak archief uit op uw lokale ontwikkelcomputer.
Start VS Code. Kies Bestand in het hoofdmenu en selecteer Map openen.
Selecteer de map op het hoogste niveau uit uitgepakte bestanden.
Kies het Azure-pictogram in de activiteitenbalk en kies vervolgens in het gebied Azure: Functions de knop Implementeren naar functie-app . Als u nog niet bent aangemeld, kiest u het Azure-pictogram op de activiteitenbalk en kiest u vervolgens in het gebied Azure: Functions de optie Aanmelden bij Azure als u al bent aangemeld, gaat u naar de volgende stap.
Geef de volgende informatie op bij de prompts:
a. Map selecteren: Kies een map in uw werkruimte of blader naar een map die uw functie-app bevat.
b. Selecteer Abonnement: Kies het abonnement dat u wilt gebruiken.
c. Selecteer Nieuwe functie-app maken in Azure (kies niet de optie Geavanceerd)
d. Voer een globaal unieke naam in voor de functie-app: typ een naam die geldig is in een URL-pad. De naam die u typt, wordt gevalideerd om er zeker van te zijn dat deze uniek is in Azure Functions. (bijvoorbeeld GWorkspaceXXXXX).
e. Selecteer een runtime: Kies Python 3.8.
f. Selecteer een locatie voor nieuwe resources. Kies voor betere prestaties en lagere kosten dezelfde regio waar Microsoft Sentinel zich bevindt.
De implementatie wordt gestart. Nadat de functie-app is gemaakt en het implementatiepakket is toegepast, wordt er een melding weergegeven.
Ga naar Azure Portal voor de configuratie van de functie-app.
2. De functie-app configureren
Selecteer in de functie-app de naam van de functie-app en selecteer Configuratie.
Selecteer op het tabblad Toepassingsinstellingen ** Nieuwe toepassingsinstelling**.
Voeg elk van de volgende toepassingsinstellingen afzonderlijk toe met de bijbehorende tekenreekswaarden (hoofdlettergevoelig): GooglePickleString WorkspaceID WorkspaceKey logAnalyticsUri (optioneel)
(Optioneel) Wijzig indien nodig de standaardvertragingen.
OPMERKING: De volgende standaardwaarden voor opnamevertragingen zijn toegevoegd voor verschillende reeks logboeken van Google Workspace op basis van Google-documentatie. Deze kunnen worden gewijzigd op basis van milieuvereisten. Ophaalvertraging - 10 minuten Kalendervertraging ophalen - 6 uur Chatten ophalen vertraging - 1 dag Gebruikersaccounts Ophalen vertraging - 3 uur Aanmeldvertraging - 6 uur
Gebruik logAnalyticsUri om het eindpunt van de Log Analytics-API voor toegewezen cloud te overschrijven. Laat voor de openbare cloud bijvoorbeeld de waarde leeg; geef voor de Azure GovUS-cloudomgeving de waarde op in de volgende indeling:
https://<CustomerId>.ods.opinsights.azure.usZodra alle toepassingsinstellingen zijn ingevoerd, klikt u op Opslaan.
Volgende stappen
Ga naar de gerelateerde oplossing in Azure Marketplace voor meer informatie.