Condividi tramite

Connettore dati Dataminr Pulse Alerts (che utilizza Funzioni di Azure) per Microsoft Sentinel

  • Articolo

Dataminr Pulse Alerts Data Connector offre funzionalità di intelligence in tempo reale basate sull'intelligenza artificiale in Microsoft Sentinel per un rilevamento e una risposta più veloci delle minacce.

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-DataminrPulseAlerts-functionapp
Tabelle Log Analytics DataminrPulse_Alerts_CL
Supporto regole di raccolta dati Non è al momento supportato
Supportata da: Supporto di Dataminr

Esempi di query

Dati degli avvisi Dataminr Pulse per tutti i tipi di avviso

DataminrPulse_Alerts_CL

| sort by TimeGenerated desc

Prerequisiti

Per l'integrazione con Dataminr Pulse Alerts Data Connector (usando Funzioni di Azure) assicurarsi di disporre di:

  • Sottoscrizione di Azure: la sottoscrizione di Azure con ruolo proprietario è necessaria per registrare un'applicazione nell'ID Microsoft Entra e assegnare il ruolo di collaboratore all'app nel gruppo di risorse.
  • 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 di Dataminr necessarie:

a. Per usare questo connettore dati, gli utenti devono avere un ID client e un segreto dell'API Pulse Dataminr validi.

b. È necessario configurare uno o più watchlist di Dataminr Pulse nel sito Web Dataminr Pulse.

Istruzioni per l’installazione di Vendor

Nota

Questo connettore usa Funzioni di Azure per connettersi a DataminrPulse in cui i log vengono inseriti tramite Dataminr RTAP e inserisce i log in Microsoft Sentinel. Inoltre, il connettore recupera i dati inseriti dalla tabella dei log personalizzati e crea indicatori di intelligence sulle minacce in Intelligence sulle minacce di 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.

PASSAGGIO 1- Credenziali per l'ID client Dataminr Pulse e il segreto client

  • Ottenere l'ID utente/password e l'ID client API/segreto di Dataminr Pulse da Dataminr Customer Success Manager (CSM).

PASSAGGIO 2- Configurare watchlist nel portale Dataminr Pulse.

Seguire la procedura descritta in questa sezione per configurare i watchlist nel portale:

  1. Accedere al sito Web Dataminr Pulse.

  2. Fare clic sull'icona a forma di ingranaggio delle impostazioni e selezionare Gestisci elenchi.

  3. Selezionare il tipo di Watchlist che si desidera creare (Cyber, Argomento, Società e così via) e fare clic sul pulsante Nuovo elenco.

  4. Specificare un nome per il nuovo watchlist, quindi selezionare un colore di evidenziazione oppure mantenere il colore predefinito.

  5. Al termine della configurazione dell'elenco di controllo, fare clic su Salva per salvarlo.

PASSAGGIO 3 - Passaggi di registrazione dell'app per l'applicazione in Microsoft Entra ID

Questa integrazione richiede una registrazione dell'app nel portale di Azure. Seguire la procedura descritta in questa sezione per creare una nuova applicazione in Microsoft Entra ID:

  1. Accedi al portale di Azure.
  2. Cerca e seleziona Microsoft Entra ID.
  3. Alla voce Gestisci, selezionare Registrazioni app > Nuova registrazione.
  4. Immettere un Nome visualizzato per l'applicazione.
  5. Selezionare Registra per completare la registrazione iniziale dell'app.
  6. Al termine della registrazione nel portale di Azure viene visualizzato il riquadro Panoramica della registrazione dell'app. Viene visualizzato l'ID applicazione (client) e l'ID tenant. L'ID client e l'ID tenant sono necessari come parametri di configurazione per l'esecuzione di DataminrPulse Data Connector.

Collegamento di riferimento:/azure/active-directory/develop/quickstart-register-app

PASSAGGIO 4 - Aggiungere un segreto client per l'applicazione in Microsoft Entra ID

Talvolta chiamato password dell'applicazione, un segreto client è un valore stringa necessario per l'esecuzione di DataminrPulse Data Connector. Seguire la procedura descritta in questa sezione per creare un nuovo segreto client:

  1. Nel portale di Azure selezionare l'applicazione in Registrazioni app.
  2. Selezionare Certificati e segreti> Segreti client > Nuovo segreto client.
  3. Aggiungere una descrizione per il segreto client.
  4. Selezionare una scadenza per il segreto o specificare una durata personalizzata. Il limite è di 24 mesi.
  5. Selezionare Aggiungi.
  6. Registrare il valore del segreto da usare nel codice dell'applicazione client. Questo valore del segreto non viene mai più visualizzato dopo aver lasciato questa pagina. Il valore del segreto è obbligatorio come parametro di configurazione per l'esecuzione di DataminrPulse Data Connector.

Collegamento di riferimento:/azure/active-directory/develop/quickstart-register-app#add-a-client-secret

PASSAGGIO 5 - Assegnare il ruolo collaboratore all'applicazione in Microsoft Entra ID

Seguire la procedura descritta in questa sezione per assegnare il ruolo:

  1. Nel portale di Azure andare a Gruppo di risorse e selezionare il gruppo di risorse.
  2. Andare a Controllo di accesso (IAM) nel pannello sinistro.
  3. Fare clic su Aggiungie selezionare Aggiungi assegnazione di ruolo.
  4. Selezionare Collaboratore come ruolo e fare clic su Avanti.
  5. Assegna accesso a: selezionare User, group, or service principal.
  6. Fare clic su Aggiungi membri e digitare il nome dell'app creato e selezionarlo.
  7. Fare clic su Rivedi + assegna, quindi fare di nuovo clic su Rivedi + assegna.

Collegamento di riferimento:/azure/role-based-access-control/role-assignments-portal

PASSAGGIO 6: 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 Dataminr Pulse di Microsoft Sentinel, disporre dell'ID dell'area di lavoro e della chiave primaria dell'area di lavoro (è possibile copiarli da quanto segue) immediatamente disponibili.

Opzione 1 - Modello di Azure Resource Manager (ARM)

Usare questo metodo per la distribuzione automatica del connettore DataminrPulse.

  1. Fare clic sul pulsante Distribuisci in Azure sotto.

    Distribuzione in Azure

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

  3. Inserire le informazioni seguenti: ID area di lavoro nome funzione Chiave area di lavoro AlertsTableName BaseURL ClientId ClientSecret AzureClientId AzureClientSecret AzureTenantId AzureResourceGroupName AzureWorkspaceName AzureSubscriptionId Schedule LogLevel

  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 Dataminr Pulse Microsoft Sentinel 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, DmPulseXXXXX).

    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.

  1. 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 ognuna delle seguenti impostazioni applicazioni singolarmente, con i rispettivi valori (distinzione tra maiuscole e minuscole) ID area di lavoro nome funzione Chiave area di lavoro AlertsTableName BaseURL ClientId ClientSecret AzureClientId AzureClientSecret AzureTenantId AzureResourceGroupName AzureWorkspaceName AzureSubscriptionId Schedule LogLevel logAnalyticsUri (opzionale)
  • 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.

PASSAGGIO 7 - Passaggi post-distribuzione

  1. Ottenere l'endpoint dell'app per le funzioni
  1. Andare alla pagina Panoramica delle funzioni di Azure e fare clic su "Funzioni" nel pannello sinistro.
  2. Fare clic sulla funzione denominata "DataminrPulseAlertsHttpStarter".
  3. Andare a "GetFunctionurl" e copiare l'URL della funzione.
  4. Sostituire {functionname} con "DataminrPulseAlertsSentinelOrchestrator" nell'URL della funzione copiato.
  1. Per aggiungere le impostazioni di integrazione in Dataminr RTAP usando l'URL della funzione
  1. Aprire qualsiasi strumento di richiesta API.
  2. Fare clic su "+" per creare una nuova richiesta.
  3. Selezionare il metodo di richiesta HTTP come 'POST'.
  4. Immettere l'URL preparato nel punto 1), nella parte URL della richiesta.
  5. In Corpo selezionare JSON non elaborato e fornire il corpo della richiesta come indicato di seguito(distinzione tra maiuscole e minuscole): { "integration-settings": "ADD", "url": "(URL part from copied Function-url)", "token": "(value of code parameter from copied Function-url)" }
  6. Dopo aver specificato tutti i dettagli necessari, fare clic su Invia.
  7. Si riceverà un ID impostazione di integrazione nella risposta HTTP con un codice di stato 200.
  8. Salvare l'ID di integrazione per riferimenti futuri.

A questo scopo, è possibile aggiungere le impostazioni di integrazione per Dataminr RTAP. Dopo che Dataminr RTAP invia dati di avviso, l'app per le funzioni viene attivata e dovrebbe essere possibile visualizzare i dati degli avvisi dalla tabella dell'area di lavoro Dataminr Pulse in LogAnalytics denominata "DataminrPulse_Alerts_CL".

Passaggi successivi

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