Dela via

Armis-aviseringar (med Azure Functions)-anslutningsprogram för Microsoft Sentinel

  • Artikel

Armis Alerts-anslutningsappen ger möjlighet att mata in Armis-aviseringar i Microsoft Sentinel via Armis REST API. Mer information finns i API-dokumentationen https://<YourArmisInstance>.armis.com/api/v1/docs . Anslutningsappen ger möjlighet att få aviseringsinformation från Armis-plattformen och identifiera och prioritera hot i din miljö. Armis använder din befintliga infrastruktur för att identifiera och identifiera enheter utan att behöva distribuera några agenter.

Det här är automatiskt genererat innehåll. Om du vill ha ändringar kontaktar du lösningsleverantören.

Anslutningsattribut

Anslutningsattribut beskrivning
Kod för Azure-funktionsapp https://aka.ms/sentinel-ArmisAlertsAPI-functionapp
Kusto-funktionsalias ArmisAlerts
Kusto-funktions-URL https://aka.ms/sentinel-ArmisAlertsAPI-parser
Log Analytics-tabeller Armis_Alerts_CL
Stöd för regler för datainsamling Stöds för närvarande inte
Stöds av Armis Corporation

Exempel på frågor

Armis-aviseringshändelser – alla aviseringsaktiviteter.

Armis_Alerts_CL

| sort by TimeGenerated desc

Förutsättningar

Om du vill integrera med Armis-aviseringar (med Hjälp av Azure Functions) kontrollerar du att du har:

  • Microsoft.Web/sites-behörigheter: Läs- och skrivbehörighet till Azure Functions för att skapa en funktionsapp krävs. Mer information om Azure Functions finns i dokumentationen.
  • Autentiseringsuppgifter/behörigheter för REST API: Armis Secret Key krävs. Läs dokumentationen om du vill veta mer om API:et på https://<YourArmisInstance>.armis.com/api/v1/doc

Installationsanvisningar för leverantör

Kommentar

Den här anslutningsappen använder Azure Functions för att ansluta till Armis-API:et för att hämta loggarna till Microsoft Sentinel. Detta kan leda till ytterligare kostnader för datainmatning. Mer information finns på prissättningssidan för Azure Functions.

(Valfritt steg) Lagra arbetsyta och API-auktoriseringsnycklar på ett säkert sätt eller token i Azure Key Vault. Azure Key Vault tillhandahåller en säker mekanism för att lagra och hämta nyckelvärden. Följ de här anvisningarna för att använda Azure Key Vault med en Azure-funktionsapp.

Kommentar

Den här dataanslutningsappen är beroende av en parser som baseras på en Kusto-funktion för att fungera som förväntat. Följ de här stegen för att skapa Kusto-funktionsaliaset ArmisAlerts

STEG 1 – Konfigurationssteg för Armis-API:et

Följ de här anvisningarna för att skapa en hemlig nyckel för Armis API.

  1. Logga in på armis-instansen
  2. Gå till Inställningar –> API Management
  3. Om den hemliga nyckeln inte redan har skapats trycker du på knappen Skapa för att skapa den hemliga nyckeln
  4. Om du vill komma åt den hemliga nyckeln trycker du på knappen Visa
  5. Den hemliga nyckeln kan nu kopieras och användas under konfigurationen av Armis Alerts-anslutningsappen

STEG 2 – Välj ETT av följande två distributionsalternativ för att distribuera anslutningsappen och den associerade Azure-funktionen

VIKTIGT: Innan du distribuerar Armis Alert-dataanslutningen måste du ha arbetsyte-ID:t och primärnyckeln för arbetsytan (kan kopieras från följande) lättillgängliga.., samt Armis API-auktoriseringsnycklarna

Alternativ 1 – Arm-mall (Azure Resource Manager)

Använd den här metoden för automatisk distribution av Armis-anslutningsappen.

  1. Klicka på knappen Distribuera till Azure nedan.

    Distribuera till Azure Deploy to Azure Gov

  2. Välj önskad prenumeration, resursgrupp och plats.

  3. Ange informationen nedan:

    • Funktionsnamn
    • Arbetsplats-ID
    • Arbetsytenyckel
    • Armis-hemlighetsnyckel
    • Armis-URL https://<armis-instance>.armis.com/api/v1/
    • Namn på Armis-aviseringstabell
    • Armis-schema
    • Undvik dubbletter (standard: sant)

  4. Markera kryssrutan märkt Jag godkänner de villkor som anges ovan.

  5. Klicka på Köp för att distribuera.

Alternativ 2 – Manuell distribution av Azure Functions

Använd följande stegvisa instruktioner för att distribuera Armis Alert-dataanslutningen manuellt med Azure Functions (distribution via Visual Studio Code).

1. Distribuera en funktionsapp

Obs! Du måste förbereda VS-kod för Azure-funktionsutveckling.

  1. Ladda ned Azure Function App-filen. Extrahera arkivet till din lokala utvecklingsdator.

  2. Starta VS Code. Välj Arkiv på huvudmenyn och välj Öppna mapp.

  3. Välj mappen på den översta nivån från extraherade filer.

  4. Välj Azure-ikonen i aktivitetsfältet och välj sedan knappen Distribuera till funktionsapp i området Azure: Functions. Om du inte redan är inloggad väljer du Azure-ikonen i aktivitetsfältet. I området Azure: Functions väljer du Logga in på Azure Om du redan är inloggad går du till nästa steg.

  5. Ange följande information i meddelanderutorna:

    a. Välj mapp: Välj en mapp från arbetsytan eller bläddra till en som innehåller din funktionsapp.

    b. Välj Prenumeration: Välj den prenumeration som ska användas.

    c. Välj Skapa ny funktionsapp i Azure (välj inte alternativet Avancerat)

    d. Ange ett globalt unikt namn för funktionsappen: Ange ett namn som är giltigt i en URL-sökväg. Namnet du skriver verifieras för att se till att det är unikt i Azure Functions. (t.ex. ARMISXXXXX).

    e. Välj en körning: Välj Python 3.8 eller senare.

    f. Välj en plats för nya resurser. För bättre prestanda och lägre kostnader väljer du samma region där Microsoft Sentinel finns.

  6. Distributionen påbörjas. Ett meddelande visas när funktionsappen har skapats och distributionspaketet har tillämpats.

  7. Gå till Azure-portalen för konfigurationen av funktionsappen.

2. Konfigurera funktionsappen

  1. I funktionsappen väljer du funktionsappens namn och väljer Konfiguration.
  2. På fliken Programinställningar väljer du + Ny programinställning.
  3. Lägg till var och en av följande programinställningar individuellt med sina respektive värden (skiftlägeskänsliga):
    • Arbetsplats-ID
    • Arbetsytenyckel
    • Armis-hemlighetsnyckel
    • Armis-URL https://<armis-instance>.armis.com/api/v1/
    • Namn på Armis-aviseringstabell
    • Armis-schema
    • Undvik dubbletter (standard: sant)
    • logAnalyticsUri (valfritt)
  • Använd logAnalyticsUri för att åsidosätta LOG Analytics API-slutpunkten för dedikerade moln. För offentliga moln lämnar du till exempel värdet tomt. för Azure GovUS-molnmiljö anger du värdet i följande format: https://<CustomerId>.ods.opinsights.azure.us.
  1. När alla programinställningar har angetts klickar du på Spara.

Nästa steg

Mer information finns i den relaterade lösningen på Azure Marketplace.