Dela via

Bitsight-dataanslutningsapp (med Azure Functions)-anslutningsprogram för Microsoft Sentinel

  • Artikel

BitSight Data Connector stöder evidensbaserad cyberriskövervakning genom att hämta BitSight-data i Microsoft Sentinel.

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-BitSight-functionapp
Log Analytics-tabeller Alerts_data_CL
BitsightBreaches_data_CL
BitsightCompany_details_CL
BitsightCompany_rating_details_CL
BitsightDiligence_historical_statistics_CL
BitsightDiligence_statistics_CL
BitsightFindings_data_CL
BitsightFindings_summary_CL
BitsightGraph_data_CL
BitsightIndustrial_statistics_CL
BitsightObservation_statistics_CL
Stöd för regler för datainsamling Stöds för närvarande inte
Stöds av BitSight-stöd

Exempel på frågor

BitSight-aviseringshändelser – Aviseringshändelse för alla företag i portföljen.

Alerts_data_CL

| sort by TimeGenerated desc

BitSight-intrångshändelser – Intrångshändelse för alla företag i portföljen.

BitsightBreaches_data_CL

| sort by TimeGenerated desc

BitSight Company Details Events – Företagsinformationshändelse för alla företag i portföljen.

BitsightCompany_details_CL

| sort by TimeGenerated desc

BitSight-företagsklassificeringshändelser – Företagsklassificeringshändelse för alla företag.

BitsightCompany_rating_details_CL

| sort by TimeGenerated desc

Historiska statistikhändelser för BitSight Diligence – händelse för historisk statistik för alla företag.

BitsightDiligence_historical_statistics_CL

| sort by TimeGenerated desc

BitSight Diligence Statistics Events – Händelse för flitstatistik för alla företag.

BitsightDiligence_statistics_CL

| sort by TimeGenerated desc

BitSight-resultathändelser – Resultathändelse för alla företag.

BitsightFindings_data_CL

| sort by TimeGenerated desc

Sammanfattningshändelser för BitSight-resultat – Sammanfattningshändelse för resultat för alla företag.

BitsightFindings_summary_CL

| sort by TimeGenerated desc

BitSight Graph-händelser – Grafhändelse för alla företag.

BitsightGraph_data_CL

| sort by TimeGenerated desc

BitSight Industrial Statistics Events - Industrial Statistics Event för alla företag.

BitsightIndustrial_statistics_CL

| sort by TimeGenerated desc

Händelser i BitSight Observationsstatistik – Händelse av observationsstatistik för alla företag.

BitsightObservation_statistics_CL

| sort by TimeGenerated desc

Förutsättningar

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

Installationsanvisningar för leverantör

Kommentar

Den här anslutningsappen använder Azure Functions för att ansluta till BitSight-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.

STEG 1 – Steg för att skapa/hämta Bitsight API-token

Följ de här anvisningarna för att hämta en BitSight API-token.

  1. För SPM-app: Gå till INSTÄLLNINGAR API-token för kontoinställningar > > > på fliken Användarinställningar på sidan Konto.
  2. För TPRM-app: Se fliken Användarinställningar på sidan Konto, Gå till INSTÄLLNINGAR API-token > för kontoinställningar > >.
  3. För klassisk BitSight: Gå till sidan Konto , Gå till Api-token för inställningar > för konto > .

STEG 2 – Steg för appregistrering för programmet i Microsoft Entra-ID

Den här integreringen kräver en appregistrering i Azure-portalen. Följ stegen i det här avsnittet för att skapa ett nytt program i Microsoft Entra-ID:

  1. Logga in på Azure-portalen.
  2. Sök efter och markera Microsoft Entra ID.
  3. Under Hantera väljer du Appregistreringar > Ny registrering.
  4. Ange ett visningsnamn för programmet.
  5. Välj Registrera för att slutföra den första appregistreringen.
  6. När registreringen är klar visar Azure-portalen appregistreringens översiktsfönster. Du ser program-ID :t (klient)-ID:t och klient-ID:t. Klient-ID och klient-ID krävs som konfigurationsparametrar för körning av BitSight Data Connector.

Referenslänk: /azure/active-directory/develop/quickstart-register-app

STEG 3 – Lägga till en klienthemlighet för program i Microsoft Entra-ID

Ibland kallas ett programlösenord, en klienthemlighet är ett strängvärde som krävs för körning av BitSight Data Connector. Följ stegen i det här avsnittet för att skapa en ny klienthemlighet:

  1. I Azure-portalen går du till Appregistreringar och väljer ditt program.
  2. Välj Certifikat och hemligheter > Klienthemligheter > Ny klienthemlighet.
  3. Lägg till en beskrivning för din klienthemlighet.
  4. Välj en förfallotidpunkt för hemligheten eller ange en anpassad livslängd. Gränsen är 24 månader.
  5. Markera Lägga till.
  6. Registrera hemlighetens värde för användning i klientprogramkoden. Hemlighetens värde visas aldrig igen när du har lämnat den här sidan. Det hemliga värdet krävs som konfigurationsparameter för körning av BitSight Data Connector.

Referenslänk: /azure/active-directory/develop/quickstart-register-app#add-a-client-secret

STEG 4 – Tilldela rollen deltagare till programmet i Microsoft Entra-ID

Följ stegen i det här avsnittet för att tilldela rollen:

  1. I Azure-portalen går du till Resursgrupp och väljer din resursgrupp.
  2. Gå till Åtkomstkontroll (IAM) från den vänstra panelen.
  3. Klicka på Lägg till och välj sedan Lägg till rolltilldelning.
  4. Välj Deltagare som roll och klicka på nästa.
  5. I Tilldela åtkomst till väljer du User, group, or service principal.
  6. Klicka på Lägg till medlemmar och skriv ditt appnamn som du har skapat och välj det.
  7. Klicka nu på Granska + tilldela och klicka sedan igen på Granska + tilldela.

Referenslänk: /azure/role-based-access-control/role-assignments-portal

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

VIKTIGT! Innan du distribuerar BitSight-dataanslutningen måste du ha arbetsyte-ID:t och primärnyckeln för arbetsytan (kan kopieras från följande) tillgängliga.., samt BitSight API-token.

Alternativ 1 – Arm-mall (Azure Resource Manager)

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

  1. Klicka på knappen Distribuera till Azure nedan.

    Distribuera till Azure

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

  3. Ange informationen nedan:

    • Funktionsnamn
    • Arbetsplats-ID
    • Arbetsytenyckel
    • API_token
    • Företag
    • Azure_Client_Id
    • Azure_Client_Secret
    • Azure_Tenant_Id
    • Portfolio_Companies_Table_Name
    • Alerts_Table_Name
    • Breaches_Table_Name
    • Company_Table_Name
    • Company_Rating_Details_Table_Name
    • Diligence_Historical_Statistics_Table_Name
    • Diligence_Statistics_Table_Name
    • Findings_Summary_Table_Name
    • Findings_Table_Name
    • Graph_Table_Name
    • Industrial_Statistics_Table_Name
    • Observation_Statistics_Table_Name
    • Loggningsnivå
    • Schema
    • Schedule_Portfolio

  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 BitSight-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. BitSightXXXXX).

    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
    • API_token
    • Företag
    • Azure_Client_Id
    • Azure_Client_Secret
    • Azure_Tenant_Id
    • Portfolio_Companies_Table_Name
    • Alerts_Table_Name
    • Breaches_Table_Name
    • Company_Table_Name
    • Company_Rating_Details_Table_Name
    • Diligence_Historical_Statistics_Table_Name
    • Diligence_Statistics_Table_Name
    • Findings_Summary_Table_Name
    • Findings_Table_Name
    • Graph_Table_Name
    • Industrial_Statistics_Table_Name
    • Observation_Statistics_Table_Name
    • Loggningsnivå
    • Schema
    • Schedule_Portfolio
  4. 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.