Delen via

Armis Alerts Activities -connector (met behulp van Azure Functions) voor Microsoft Sentinel

  • Artikel

De Armis Alerts Activities-connector biedt de mogelijkheid om Armis-waarschuwingen en -activiteiten op te nemen in Microsoft Sentinel via de Armis REST API. Raadpleeg de API-documentatie voor https://<YourArmisInstance>.armis.com/api/v1/docs meer informatie. De connector biedt de mogelijkheid om waarschuwings- en activiteitsgegevens op te halen van het Armis-platform en om bedreigingen in uw omgeving te identificeren en te prioriteren. Armis gebruikt uw bestaande infrastructuur om apparaten te detecteren en te identificeren zonder agents te hoeven implementeren.

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-ArmisAlertsActivitiesAPI-functionapp
Log Analytics-tabellen Armis_Alerts_CL
Armis_Activities_CL
Ondersteuning voor regels voor gegevensverzameling Wordt momenteel niet ondersteund
Ondersteund door Armis Corporation

Voorbeelden van query's

Armis-waarschuwingsgebeurtenissen - alle waarschuwingen.

Armis_Alerts_CL

| sort by TimeGenerated desc

Armis-activiteitengebeurtenissen - Alle activiteiten.

Armis_Activities_CL

| sort by TimeGenerated desc

Vereisten

Als u wilt integreren met Armis Alerts Activities (met behulp van Azure Functions), controleert u of 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: Armis Secret Key is vereist. Raadpleeg de documentatie voor meer informatie over API op de https://<YourArmisInstance>.armis.com/api/v1/doc

Installatie-instructies van leverancier

Notitie

Deze connector maakt gebruik van Azure Functions om verbinding te maken met de Armis-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 die is gebaseerd op een Kusto-functie om te werken zoals verwacht. Deze 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 ArmisActivities/ArmisAlerts en laadt u de functiecode. Het duurt meestal 10-15 minuten voordat de functie wordt geactiveerd na de installatie/update van de oplossing.

STAP 1: configuratiestappen voor de Armis-API

Volg deze instructies om een geheime sleutel voor de Armis-API te maken.

  1. Aanmelden bij uw Armis-exemplaar
  2. Ga naar Instellingen -> API Management
  3. Als de geheime sleutel nog niet is gemaakt, drukt u op de knop Maken om de geheime sleutel te maken
  4. Druk op de knop Weergeven om toegang te krijgen tot de geheime toets
  5. De geheime sleutel kan nu worden gekopieerd en gebruikt tijdens de configuratie van de Armis Alerts Activities-connector

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

BELANGRIJK: Voordat u de gegevensconnector Armis-waarschuwingenactiviteiten implementeert, moet u de werkruimte-id en primaire sleutel van de werkruimte (kunnen worden gekopieerd uit de volgende) direct beschikbaar zijn.., evenals de Autorisatiesleutel(s) van de Armis-API

Optie 1: ARM-sjabloon (Azure Resource Manager)

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

  1. Klik op de knop Implementeren in Azure hieronder.

    Implementeren in Azure Implementeren in Azure Gov

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

  3. Voer de onderstaande gegevens in:

    • Functienaam
    • Werkruimte-id
    • Werkruimtesleutel
    • Armis Secret Key
    • Armis-URL https://<armis-instance>.armis.com/api/v1/
    • Naam van armis-waarschuwingstabel
    • Naam van armis-activiteitstabel
    • Armis-planning
    • Duplicaten voorkomen (standaard: true)

  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 gegevensconnector Armis Alerts Activities 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.

  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 ARMISXXXXX).

    e. Een runtime selecteren: Python 3.11 kiezen

    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.

2. 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-id
    • Werkruimtesleutel
    • Armis Secret Key
    • Armis-URL https://<armis-instance>.armis.com/api/v1/
    • Naam van armis-waarschuwingstabel
    • Naam van armis-activiteitstabel
    • Armis-planning
    • Duplicaten voorkomen (standaard: true)
    • 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.

Volgende stappen

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