Condividi tramite

Connettore Attività Armis (che utilizza Funzioni di Azure) per Microsoft Sentinel

  • Articolo

Il connettore Armis Activities offre la possibilità di inserire dispositivi Armis Activities in Microsoft Sentinel tramite l'API REST Armis. Per altre informazioni vedere la documentazione API: https://<YourArmisInstance>.armis.com/api/v1/doc. Il connettore consente di ottenere informazioni sull'attività del dispositivo dalla piattaforma Armis. Armis usa l'infrastruttura esistente per individuare e identificare i dispositivi senza dover distribuire agenti. Armis rileva le operazioni eseguite da tutti i dispositivi nell'ambiente e classifica tali attività per ottenere un quadro completo del comportamento del dispositivo. Queste attività vengono analizzate per comprendere il comportamento normale e anomalo del dispositivo e vengono usate per valutare il rischio di dispositivo e di rete.

Questo contenuto è generato automaticamente. Per modifiche, contattare il provider di soluzioni.

Attributi connettore

Attributo connettore Descrizione
Codice dell'app per le funzioni di Azure https://aka.ms/sentinel-ArmisActivitiesAPI-functionapp
Tabelle Log Analytics Armis_Activities_CL
Supporto regole di raccolta dati Non è al momento supportato
Supportata da: Armis Corporation

Esempi di query

Eventi Armis Activity - Tutte le attività Activity.

Armis_Activities_CL

| sort by TimeGenerated desc

Prerequisiti

Per eseguire l'integrazione con Armis Activities (usando Funzioni di Azure) assicurarsi di disporre di:

  • autorizzazioni Microsoft.Web/siti: sono necessarie autorizzazioni di lettura e scrittura per Funzioni di Azure al fine di creare un'app per le funzioni. Vedere la documentazione per altre informazioni su Funzioni di Azure.
  • Credenziali/Autorizzazioni dell'API REST: è necessaria la chiave privata Armis. Per altre informazioni sull'API, vedere la documentazione in https://<YourArmisInstance>.armis.com/api/v1/doc

Istruzioni per l’installazione di Vendor

Nota

Questo connettore usa Funzioni di Azure per connettersi all'API Armis per eseguire il pull dei log in Microsoft Sentinel. Ciò potrebbe comportare costi aggiuntivi per l'inserimento dati. Verificare la pagina prezzi di Funzioni di Azure per altre informazioni.

(Passaggio facoltativo) Archiviare in modo sicuro le chiavi o i token dell'area di lavoro e dell'API in Azure Key Vault. Azure Key Vault offre un meccanismo sicuro per archiviare e recuperare i valori delle chiavi. Seguire queste istruzioni per usare Azure Key Vault con un'App per le funzioni di Azure.

NOTA: per funzionare come previsto questo connettore dati dipende da un parser basato su una funzione Kusto, che viene distribuito come parte della soluzione. Per visualizzare il codice della funzione in Log Analytics, aprire il pannello Log Analytics/Log di Microsoft Sentinel, fare clic su Funzioni e cercare l'alias Armis Activities e caricare il codice della funzione oppure fare clic qui. La funzione richiede in genere 10-15 minuti per l'attivazione dopo l'installazione/aggiornamento della soluzione.

PASSAGGIO 1 - Passaggi di configurazione per l'API Armis

Seguire queste istruzioni per creare una chiave privata API Armis.

  1. Accedere all'istanza di Armis
  2. Andare a Impostazioni -> Gestione API
  3. Se la chiave privata non è già stata creata, premere il pulsante Crea per creare la chiave privata
  4. Per accedere al tasto segreto, premere il pulsante Mostra
  5. È ora possibile copiare e usare la chiave privata durante la configurazione del connettore Armis Activities

PASSAGGIO 2: scegliere UNA delle due opzioni di distribuzione seguenti per distribuire il connettore e la funzione di Azure associata

IMPORTANTE: prima di distribuire il connettore dati Armis Activities, disporre dell'ID dell'area di lavoro e della chiave primaria dell'area di lavoro (è possibile copiarli da quanto segue) immediatamente disponibili, nonché delle chiavi di autorizzazione API Armis

Opzione 1 - Modello di Azure Resource Manager (ARM)

Usare questo metodo per la distribuzione automatica del connettore Armis.

  1. Fare clic sul pulsante Distribuisci in Azure sotto.

    Distribuzione in Azure Deploy to Azure Gov

  2. Selezionare la Sottoscrizione preferita, il Gruppo di risorse e la Località.

  3. Immettere le informazioni seguenti:

    • Nome funzione
    • ID area di lavoro
    • Chiave dell'area di lavoro
    • Chiave privata AWS
    • URL Armis https://<armis-instance>.armis.com/api/v1/
    • Nome tabella Attività Armis
    • Pianificazione Schedule
    • Evitare duplicati (impostazione predefinita: false)

  4. Contrassegnare la casella di controllo etichettata Accetto le condizioni riportate sopra.

  5. Fare clic su Acquista per effettuare la distribuzione.

Opzione 2 - Distribuzione manuale di Funzioni di Azure

Usare le istruzioni dettagliate seguenti per distribuire manualmente il connettore dati Armis Activity con Funzioni di Azure (distribuzione tramite Visual Studio Code).

1. Distribuire un'App per le funzioni

NOTA: sarà necessario preparare VS Code per lo sviluppo di funzioni di Azure.

  1. Scaricare il file App per le funzioni di Azure. Estrarre l'archivio nel computer di sviluppo locale.

  2. Avviare VS Code. Scegliere File nel menu principale quindi selezionare Apri cartella.

  3. Selezionare la cartella di primo livello dai file estratti.

  4. Selezionare l'icona di Azure nella barra attività, quindi nell'area Azure: Funzioni scegliere il pulsante Distribuisci nell'app per le funzioni. Se non si ha ancora effettuato l'accesso, selezionare l'icona di Azure nella barra attività, quindi nell'area Azure: Funzioni scegliere Accedi ad Azure. Se si ha già effettuato l'accesso, andare al passaggio successivo.

  5. Quando richiesto, immettere le informazioni seguenti:

    a. Seleziona cartella: scegliere una cartella dall'area di lavoro o selezionarne una che contenga l'app per le funzioni.

    b. Selezionare Sottoscrizione: scegliere la sottoscrizione da usare.

    c. Selezionare Crea nuova App per le funzioni in Azure (non scegliere l'opzione Avanzata)

    d. Immettere un nome univoco globale per l'app per le funzioni: Digitare un nome valido in un percorso URL. Il nome digitato viene convalidato per assicurarsi che sia univoco in Funzioni di Azure. (ad esempio ARMISXXXXX).

    e. Selezionare un runtime: scegliere Python 3.8 o versione successiva.

    f. Select a location for new resources. Per prestazioni migliori e costi inferiori, scegliere la stessa area in cui si trova Microsoft Sentinel.

  6. La distribuzione avrà inizio. Dopo la creazione dell'app per le funzioni e dopo l'applicazione del pacchetto di distribuzione viene visualizzata una notifica.

  7. Andare al portale di Azure per la configurazione dell'App per le funzioni.

2. Configurare l'App per le funzioni

  1. Nell'App per le funzioni selezionare Nome App per le funzioni seguito da Configurazione.
  2. Nella scheda Impostazioni applicazione selezionare + Nuova impostazione applicazione.
  3. Aggiungere singolarmente ognuna delle impostazioni dell'applicazione seguenti, con i rispettivi valori (maiuscole/minuscole):
    • ID area di lavoro
    • Chiave dell'area di lavoro
    • Chiave privata AWS
    • URL Armis https://<armis-instance>.armis.com/api/v1/
    • Nome tabella Attività Armis
    • Pianificazione Schedule
    • Evitare duplicati (impostazione predefinita: false)
    • logAnalyticsUri (facoltativo)
  • Usare logAnalyticsUri per eseguire l'override dell'endpoint dell'API di Log Analytics per il cloud dedicato. Ad esempio, per il cloud pubblico lasciare vuoto il valore; per l'ambiente cloud Azure GovUS, specificare il valore nel formato seguente: https://<CustomerId>.ods.opinsights.azure.us.
  1. Dopo aver immesso tutte le impostazioni dell'applicazione, fare clic su Salva.

Passaggi successivi

Per altre informazioni, visitare la soluzione correlata in Azure Marketplace.