Dataminr Pulse Alerts Data Verbinding maken or (met behulp van Azure Functions) connector voor Microsoft Sentinel

  • Artikel

Dataminr Pulse Alerts Data Verbinding maken or brengt onze realtime ai-intelligentie naar Microsoft Sentinel voor snellere detectie en reactie van bedreigingen.

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-DataminrPulseAlerts-functionapp
Log Analytics-tabellen DataminrPulse_Alerts_CL
Ondersteuning voor regels voor gegevensverzameling Wordt momenteel niet ondersteund
Ondersteund door Ondersteuning voor Dataminr

Voorbeelden van query's

Dataminr Pulse Alerts Data voor alle alertTypes

DataminrPulse_Alerts_CL

| sort by TimeGenerated desc

Vereisten

Als u wilt integreren met Dataminr Pulse Alerts Data Verbinding maken or (met behulp van Azure Functions), moet u het volgende doen:

  • Azure-abonnement: Azure-abonnement met de rol eigenaar is vereist voor het registreren van een toepassing in Microsoft Entra-id en het toewijzen van de rol van inzender aan de app in de resourcegroep.
  • 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.
  • Vereiste dataminr-referenties/machtigingen:

a. Gebruikers moeten een geldige Dataminr Pulse API-client-id en -geheim hebben om deze gegevensconnector te kunnen gebruiken.

b. Een of meer Dataminr Pulse Watchlists moeten worden geconfigureerd op de Dataminr Pulse-website.

Installatie-instructies van leverancier

Notitie

Deze connector maakt gebruik van Azure Functions om verbinding te maken met de DataminrPulse waarin logboeken worden gepusht via Dataminr RTAP, waarna logboeken worden opgenomen in Microsoft Sentinel. Bovendien haalt de connector de opgenomen gegevens op uit de tabel aangepaste logboeken en maakt de Bedreigingsinformatie-indicatoren in Microsoft Sentinel Threat Intelligence. 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.

STAP 1: Referenties voor de Dataminr Pulse-client-id en clientgeheim

  • Haal dataminr Pulse-gebruikers-id/wachtwoord en API-client-id/geheim op uit uw Dataminr Customer Success Manager (CSM).

STAP 2: Watchlists configureren in de Dataminr Pulse-portal.

Volg de stappen in deze sectie om volglijsten te configureren in de portal:

  1. Meld u aan bij de Dataminr Pulse-website.

  2. Klik op het tandwielpictogram instellingen en selecteer Lijsten beheren.

  3. Selecteer het type volglijst dat u wilt maken (Cyber, Onderwerp, Bedrijf, enzovoort) en klik op de knop Nieuwe lijst .

  4. Geef een naam op voor de nieuwe volglijst en selecteer een markeringskleur of behoud de standaardkleur.

  5. Wanneer u klaar bent met het configureren van de volglijst, klikt u op Opslaan om deze op te slaan.

STAP 3: stappen voor app-registratie voor de toepassing in Microsoft Entra-id

Voor deze integratie is een app-registratie in Azure Portal vereist. Volg de stappen in deze sectie om een nieuwe toepassing te maken in Microsoft Entra ID:

  1. Meld u aan bij het Azure-portaal.
  2. Zoek Microsoft Entra ID en selecteer deze.
  3. Selecteer onder Beheren App-registraties > Nieuwe registratie.
  4. Voer een weergavenaam voor uw toepassing in.
  5. Selecteer Registreren om de initiële app-registratie te voltooien.
  6. Wanneer de registratie is voltooid, wordt in Azure Portal het deelvenster Overzicht van de app-registratie weergegeven. U ziet de toepassings-id (client) en tenant-id. De client-id en tenant-id zijn vereist als configuratieparameters voor de uitvoering van DataminrPulse Data Verbinding maken or.

Referentiekoppeling:/azure/active-directory/develop/quickstart-register-app

STAP 4: Een clientgeheim voor de toepassing toevoegen in Microsoft Entra-id

Soms een toepassingswachtwoord genoemd, is een clientgeheim een tekenreekswaarde die vereist is voor de uitvoering van DataminrPulse Data Verbinding maken or. Volg de stappen in deze sectie om een nieuw clientgeheim te maken:

  1. Selecteer in Azure Portal in App-registraties uw toepassing.
  2. Selecteer Certificaten en geheimen Clientgeheimen >> Nieuw clientgeheim.
  3. Voeg een beschrijving voor uw clientgeheim toe.
  4. Selecteer een vervaldatum voor het geheim of geef een aangepaste levensduur op. Limiet is 24 maanden.
  5. Selecteer Toevoegen.
  6. Registreer de waarde van het geheim voor gebruik in de toepassingscode van uw client. Deze geheimwaarde wordt nooit meer weergegeven nadat u deze pagina hebt verlaten. De geheime waarde is vereist als configuratieparameter voor de uitvoering van DataminrPulse Data Verbinding maken or.

Referentiekoppeling:/azure/active-directory/develop/quickstart-register-app#add-a-client-secret

STAP 5: Rol van Inzender toewijzen aan toepassing in Microsoft Entra-id

Volg de stappen in deze sectie om de rol toe te wijzen:

  1. Ga in Azure Portal naar de resourcegroep en selecteer uw resourcegroep.
  2. Ga vanuit het linkerdeelvenster naar Toegangsbeheer (IAM ).
  3. Klik op Toevoegen en selecteer vervolgens Roltoewijzing toevoegen.
  4. Selecteer Inzender als rol en klik op volgende.
  5. Selecteer User, group, or service principalin Toegang toewijzen aan .
  6. Klik op Leden toevoegen en typ uw app-naam die u hebt gemaakt en selecteer deze.
  7. Klik nu op Beoordelen + toewijzen en klik vervolgens nogmaals op Beoordelen + toewijzen.

Referentiekoppeling:/azure/op rollen gebaseerd toegangsbeheer/role-assignments-portal

STAP 6: Kies EEN uit de volgende twee implementatieopties om de connector en de bijbehorende Azure-functie te implementeren

BELANGRIJK: Voordat u de Dataminr Pulse Microsoft Sentinel-gegevensconnector implementeert, moet u de werkruimte-id en primaire sleutel van de werkruimte (kunnen worden gekopieerd uit de volgende) direct beschikbaar zijn.

Optie 1: ARM-sjabloon (Azure Resource Manager)

Gebruik deze methode voor geautomatiseerde implementatie van de DataminrPulse-connector.

  1. Klik op de knop Implementeren in Azure hieronder.

    Implementeren in Azure

  2. Selecteer het voorkeursabonnement, de resourcegroep en de locatie.

  3. Voer de onderstaande informatie in: Werkruimte-id werkruimtesleutel AlertsTableName BaseURL ClientId ClientSecret AzureClientId AzureClientSecret AzureTenantId AzureResourceGroupName AzureWorkspaceName AzureSubscriptionId Schedule LogLevel

  4. Markeer het selectievakje met het label Ik ga akkoord met de bovenstaande voorwaarden.

  5. Klik op Kopen om te implementeren.

Optie 2: handmatige implementatie van Azure Functions

Gebruik de volgende stapsgewijze instructies om de Dataminr Pulse Microsoft Sentinel-gegevensconnector handmatig te implementeren met Azure Functions (implementatie via Visual Studio Code).

  1. Een functie-app implementeren

Notitie

U moet VS-code voorbereiden voor azure-functieontwikkeling.

  1. Download het Azure Function App-bestand . Pak archief uit op uw lokale ontwikkelcomputer.

  2. Start VS Code. Kies Bestand in het hoofdmenu en selecteer Map openen.

  3. Selecteer de map op het hoogste niveau uit uitgepakte bestanden.

  4. 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.

  5. 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 DmPulseXXXXX).

    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.

  6. De implementatie wordt gestart. Nadat de functie-app is gemaakt en het implementatiepakket is toegepast, wordt er een melding weergegeven.

  7. Ga naar Azure Portal voor de configuratie van de functie-app.

  1. De functie-app configureren
  1. Selecteer in de functie-app de naam van de functie-app en selecteer Configuratie.
  2. Selecteer + Nieuwe toepassingsinstelling op het tabblad Toepassingsinstellingen.
  3. Voeg elk van de volgende toepassingsinstellingen afzonderlijk toe, met hun respectieve waarden (hoofdlettergevoelig): Werkruimte werkruimtesleutel key AlertsTableName BaseURL ClientId ClientId ClientSecret AzureClientSecret AzureTenantId AzureResourceGroupName AzureWorkspaceName AzureSubscriptionId Schedule LogLevel 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
  1. Zodra alle toepassingsinstellingen zijn ingevoerd, klikt u op Opslaan.

STAP 7: stappen na implementatie

  1. Het eindpunt van de functie-app ophalen
  1. Ga naar de overzichtspagina van De Azure-functie en klik op Functies in de linkerblade.
  2. Klik op de functie met de naam DataminrPulseAlertsHttpStarter.
  3. Ga naar 'GetFunctionurl' en kopieer de functie-URL.
  4. Vervang {functionname} door DataminrPulseAlertsSentinelOrchestrator in de gekopieerde functie-URL.
  1. Integratie-instellingen toevoegen in Dataminr RTAP met behulp van de functie-URL
  1. Open een API-aanvraagprogramma zoals Postman.
  2. Klik op +om een nieuwe aanvraag te maken.
  3. Selecteer de HTTP-aanvraagmethode als 'POST'.
  4. Voer de url in punt 1 in, in het aanvraag-URL-gedeelte.
  5. Selecteer in hoofdtekst onbewerkte JSON en geef de aanvraagbody op zoals hieronder(hoofdlettergevoelig): { "integration-settings": "ADD", "url": "(URL part from copied Function-url)", "token": "(value of code parameter from copied Function-url)" }
  6. Nadat u alle vereiste gegevens hebt opgegeven, klikt u op Verzenden.
  7. U ontvangt een integratie-instellings-id in het HTTP-antwoord met een statuscode van 200.
  8. Sla de integratie-id op voor toekomstig gebruik.

Nu zijn we klaar met het toevoegen van integratie-instellingen voor Dataminr RTAP. Zodra de Dataminr RTAP een waarschuwingsgegevens verzendt, wordt de functie-app geactiveerd en moet u de waarschuwingengegevens van de Dataminr Pulse kunnen zien in de werkruimtetabel van LogAnalytics met de naam 'DataminrPulse_Alerts_CL'.

Volgende stappen

Ga naar de gerelateerde oplossing in Azure Marketplace voor meer informatie.