Vectra XDR-connector (met behulp van Azure Functions) voor Microsoft Sentinel
De Vectra XDR-connector biedt de mogelijkheid om Vectra Detections, Audits, Entity Scoring, Lockdown en Health-gegevens op te nemen in Microsoft Sentinel via de Vectra REST API. Raadpleeg de API-documentatie voor https://support.vectra.ai/s/article/KB-VS-1666
meer informatie.
Dit is automatisch gegenereerde inhoud. Neem contact op met de provider van de oplossing voor wijzigingen.
Connectorkenmerken
Kenmerk connector | Beschrijving |
---|---|
Code van Azure-functie-app | https://aka.ms/sentinel-VectraXDR-functionapp |
Kusto-functiealias | VectraDetections |
Kusto-functie-URL | https://aka.ms/sentinel-VectraDetections-parser |
Log Analytics-tabellen | Detections_Data_CL Audits_Data_CL Entity_Scoring_Data_CL Lockdown_Data_CL Health_Data_CL |
Ondersteuning voor regels voor gegevensverzameling | Wordt momenteel niet ondersteund |
Ondersteund door | Vectra-ondersteuning |
Voorbeelden van query's
Vectra-detectiegebeurtenissen - Alle detectiegebeurtenissen.
Detections_Data_CL
| sort by TimeGenerated desc
Vectra Audits Events - Alle audits gebeurtenissen.
Audits_Data_CL
| sort by TimeGenerated desc
Vectra Entity Scoring Events - Alle gebeurtenissen voor het scoren van entiteiten.
Entity_Scoring_Data_CL
| sort by TimeGenerated desc
Vectra Lockdown-gebeurtenissen - Alle vergrendelingsgebeurtenissen.
Lockdown_Data_CL
| sort by TimeGenerated desc
Vectra Health Events - Alle statusgebeurtenissen.
Health_Data_CL
| sort by TimeGenerated desc
Vereisten
Als u wilt integreren met Vectra XDR (met behulp van Azure Functions), moet u het volgende doen:
- 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: Vectra-client-id en clientgeheim zijn vereist voor het verzamelen van gegevens voor status, entiteitsscore, detecties, vergrendeling en controlegegevensverzameling. Zie de documentatie voor meer informatie over API op de
https://support.vectra.ai/s/article/KB-VS-1666
.
Installatie-instructies van leverancier
Notitie
Deze connector maakt gebruik van Azure Functions om verbinding te maken met de Vectra-API om de logboeken naar Microsoft Sentinel 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.
Notitie
Deze gegevensconnector is afhankelijk van een parser op basis van een Kusto-functie die werkt zoals verwacht. Volg deze stappen voor Detections Parser, Audits Parser, Entity Scoring Parser, Lockdown Parser and Health Parser om de Kusto-functiealias, VectraDetections, VectraAudits, VectraEntityScoring, VectraLockdown en VectraHealth te maken.
STAP 1: configuratiestappen voor de Vectra-API-referenties
Volg deze instructies om een Vectra-client-id en clientgeheim te maken.
- Meld u aan bij uw Vectra-portal
- Navigeren naar Beheren -> API-clients
- Selecteer op de pagina API-clients de optie API-client toevoegen om een nieuwe client te maken.
- Voeg clientnaam toe, selecteer Rol en klik op Referenties genereren om uw clientreferenties op te halen.
- Zorg ervoor dat u uw client-id en geheime sleutel opneemt voor bewaring. U hebt deze twee stukjes informatie nodig om een toegangstoken te verkrijgen van de Vectra-API. Een toegangstoken is vereist voor het indienen van aanvragen voor alle Vectra-API-eindpunten.
STAP 2: Kies EEN van de volgende twee implementatieopties om de connector en de bijbehorende Azure-functie te implementeren
BELANGRIJK: Voordat u de Vectra-gegevensconnector implementeert, moet u de werkruimte-id en primaire sleutel van de werkruimte (kunnen worden gekopieerd uit de volgende) direct beschikbaar zijn.., evenals de autorisatiereferenties voor de Vectra-API
Optie 1: ARM-sjabloon (Azure Resource Manager)
Gebruik deze methode voor geautomatiseerde implementatie van de Vectra-connector.
Klik op de knop Implementeren in Azure hieronder.
Selecteer het voorkeursabonnement, de resourcegroep en de locatie.
Voer de onderstaande gegevens in:
- Functienaam
- Werkruimte-id
- Werkruimtesleutel
- Vectra-basis-URL
https://<vectra-portal-url>
- Vectra-client-id - Status
- Vectra Client Secret Key - Status
- Vectra-client-id - Scoren van entiteiten
- Vectra-clientgeheim - Entiteit scoren
- Vectra-client-id - Detecties
- Vectra Client Secret - Detecties
- Vectra-client-id - Audits
- Vectra Client Secret - Audits
- Vectra-client-id - Lockdown
- Vectra Client Secret - Lockdown
- StartTime (in MM/DD/JJJJ UU:MM:SS-indeling)
- Tabelnaam controleren
- Tabelnaam detectie
- Naam van entiteitsscoretabel
- Naam van vergrendelingstabel
- Naam van statustabel
- Logboekniveau (standaard: INFO)
- Vergrendelingsschema
- Statusschema
- Schema detecties
- Controleschema
- Scoreschema voor entiteiten
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 Vectra-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 VECTRAXXXXX).
e. Selecteer een runtime: Kies Python 3.8 of hoger.
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 + Nieuwe toepassingsinstelling op het tabblad Toepassingsinstellingen.
- Voeg elk van de volgende toepassingsinstellingen afzonderlijk toe met hun respectieve waarden (hoofdlettergevoelig):
- Werkruimte-id
- Werkruimtesleutel
- Vectra-basis-URL
https://<vectra-portal-url>
- Vectra-client-id - Status
- Vectra Client Secret Key - Status
- Vectra-client-id - Scoren van entiteiten
- Vectra-clientgeheim - Entiteit scoren
- Vectra-client-id - Detecties
- Vectra Client Secret - Detecties
- Vectra-client-id - Audits
- Vectra Client Secret - Audits
- Vectra-client-id - Lockdown
- Vectra Client Secret - Lockdown
- StartTime (in MM/DD/JJJJ UU:MM:SS-indeling)
- Tabelnaam controleren
- Tabelnaam detectie
- Naam van entiteitsscoretabel
- Naam van vergrendelingstabel
- Naam van statustabel
- Logboekniveau (standaard: INFO)
- Vergrendelingsschema
- Statusschema
- Schema detecties
- Controleschema
- Scoreschema voor entiteiten
- logAnalyticsUri (optioneel)
- 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.us
- Zodra alle toepassingsinstellingen zijn ingevoerd, klikt u op Opslaan.
Volgende stappen
Ga naar de gerelateerde oplossing in Azure Marketplace voor meer informatie.