Dela via

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

  • Artikel

Armis Activities-anslutningsappen ger möjlighet att mata in Armis-enhetsaktiviteter i Microsoft Sentinel via Armis REST API. Mer information finns i API-dokumentationen https://<YourArmisInstance>.armis.com/api/v1/doc . Anslutningsappen ger möjlighet att hämta information om enhetsaktivitet från Armis-plattformen. Armis använder din befintliga infrastruktur för att identifiera och identifiera enheter utan att behöva distribuera några agenter. Armis identifierar vad alla enheter gör i din miljö och klassificerar dessa aktiviteter för att få en fullständig bild av enhetens beteende. Dessa aktiviteter analyseras för att förstå normalt och onormalt enhetsbeteende och används för att bedöma enhets- och nätverksrisker.

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-ArmisActivitiesAPI-functionapp
Log Analytics-tabeller Armis_Activities_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-aktivitetshändelser – alla aktiviteter.

Armis_Activities_CL

| sort by TimeGenerated desc

Förutsättningar

Om du vill integrera med Armis-aktiviteter (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.

Obs! Den här dataanslutningen är beroende av en parser baserat på en Kusto-funktion för att fungera som förväntat som distribueras som en del av lösningen. Om du vill visa funktionskoden i Log Analytics öppnar du bladet Log Analytics/Microsoft Sentinel-loggar, klickar på Funktioner och söker efter aliaset ArmisActivities och läser in funktionskoden eller klickar här. Funktionen tar vanligtvis 10–15 minuter att aktivera efter installationen/uppdateringen av lösningen.

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 anslutningskonfigurationen för Armis-aktiviteter

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

VIKTIGT! Innan du distribuerar dataanslutningsappen För Armis-aktiviteter måste du ha arbetsytans ID och primärnyckel för arbetsytan (kan kopieras från följande) lättillgängliga.., samt Armis API-auktoriseringsnyckel(er)

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-aktivitetstabell
    • Armis-schema
    • Undvik dubbletter (standard: false)

  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 Activity-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-aktivitetstabell
    • Armis-schema
    • Undvik dubbletter (standard: false)
    • 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.