分享方式：

適用於 Microsoft Sentinel 的 Dataminr Pulse Alerts Data Connector (使用 Azure Functions) 連接器

  • 文章

Dataminr Pulse Alerts Data Connector 可將 AI 支援的即時智慧帶入 Microsoft Sentinel，以加快偵測和回應威脅的速度。

這是自動產生的內容。 如需變更，請連絡解決方案提供者。

連接器屬性

連接器屬性 描述
Azure 函數應用程式程式碼 https://aka.ms/sentinel-DataminrPulseAlerts-functionapp
記錄分析資料表 DataminrPulse_Alerts_CL
資料收集規則支援 目前不支援
支援者： Dataminr 支援 (英文)

查詢範例

所有 alertTypes 的 Dataminr Pulse Alerts Data

DataminrPulse_Alerts_CL

| sort by TimeGenerated desc

必要條件

若要與 Dataminr Pulse Alerts Data Connector (使用 Azure Functions) 整合，請確定您有：

  • Azure 訂用帳戶：需要具有擁有者角色的 Azure 訂用帳戶，才能在 Microsoft Entra ID 中註冊應用程式，並將參與者角色指派給資源群組中的應用程式。
  • Microsoft.Web/網站權限：需要 Azure Functions 的讀寫權限才能建立函數應用程式。 請參閱文件以深入了解 Azure Functions。
  • 必要的 Dataminr 認證/權限：

a. 使用者必須具有有效的 Dataminr Pulse API 用戶端識別碼和祕密，才能使用此資料連接器。

b. 您必須在 Dataminr Pulse 網站中設定一個或多個 Dataminr Pulse 關注清單。

廠商安裝指示

注意

此連接器會使用 Azure Functions 連線到 DataminrPulse，透過 Dataminr RTAP 推送記錄，並將記錄內嵌至 Microsoft Sentinel。 此外，連接器會從自訂記錄資料表擷取內嵌的資料，並將威脅情報指標建立到 Microsoft Sentinel 威脅情報中。 這可能會導致額外的資料擷取成本。 如需詳細資料，請參閱 Azure Functions 價格頁面。

(選擇性步驟) 將工作區和 API 授權金鑰或權杖安全地儲存在 Azure Key Vault 中。 Azure Key Vault 提供儲存和擷取金鑰值的安全機制。 遵循這些指示來搭配使用 Azure Key Vault 與 Azure Function App。

步驟 1 - Dataminr Pulse 用戶端識別碼和用戶端密碼的認證

  • 向 Dataminr 客戶成功經理取得 Dataminr Pulse 使用者識別碼/密碼和 API 用戶端識別碼/秘密。

步驟 2- 在 Dataminr Pulse 入口網站中設定關注清單。

請遵循本節中的步驟，在入口網站中設定關注清單：

  1. 登入 Dataminr Pulse 網站。

  2. 按一下設定齒輪圖示，然後選取 [管理清單]。

  3. 選取您要建立的關注清單類型 (網路、主題、公司等)，然後按一下 [新增清單] 按鈕。

  4. 為新的關注清單提供名稱，並為其選取醒目提示色彩，或保留預設色彩。

  5. 當您完成設定關注清單時，請按一下 [儲存] 來將其儲存。

步驟 3 - Microsoft Entra ID 中應用程式的應用程式註冊步驟

此整合需要在 Azure 入口網站中註冊應用程式。 請遵循本節中的步驟，在 Microsoft Entra ID 中建立新的應用程式：

  1. 登入 Azure 入口網站。
  2. 搜尋並選取 Microsoft Entra ID。
  3. 在 [管理] 底下，選取 [應用程式註冊] > [新增註冊]。
  4. 輸入應用程式的顯示 [名稱]。
  5. 選取 [註冊] 以完成伺服器初始註冊。
  6. 註冊完成時，Azure 入口網站會顯示應用程式註冊的 [概觀] 窗格。 您會看到應用程式 (用戶端) 識別碼和租用戶識別碼。 執行 DataminrPulse Data Connector 時，需要用戶端識別碼和租用戶識別碼作為設定參數。

參考連結： /azure/active-directory/develop/quickstart-register-app

步驟 4 - 在 Microsoft Entra ID 中新增應用程式的用戶端密碼

有時稱為應用程式密碼，用戶密碼是執行 DataminrPulse Data Connector 所需的字串值。 請遵循本節中的步驟來建立新的用戶端密碼：

  1. 在 Azure 入口網站的應用程式註冊中，選取您的應用程式。
  2. 選取 [憑證和祕密] > [用戶端密碼] > [新增用戶端密碼]。
  3. 新增用戶端密碼的描述。
  4. 選取祕密的到期日，或指定自訂存留期。 上限為 24 個月。
  5. 選取 [新增]。
  6. 記錄祕密的值，以在用戶端應用程式程式碼中使用。 離開此頁面後，就「不會再次顯示」此祕密值。 執行 DataminrPulse Data Connector 時，需要祕密值作為設定參數。

參考連結： /azure/active-directory/develop/quickstart-register-app#add-a-client-secret

步驟 5 - 將參與者的角色指派給 Microsoft Entra ID 中的應用程式

請遵循本節中的步驟來指派角色：

  1. 在 Azure 入口網站中，移至 [資源群組]，然後選取您的資源群組。
  2. 前往左側面板中的 [存取控制 (IAM)]。
  3. 按一下 [新增]，然後選取 [新增角色指派]。
  4. 選取 [參與者] 作為角色，然後按 [下一步]。
  5. 在 [存取權指派對象] 中，選取 User, group, or service principal。
  6. 按一下 [新增成員]，然後輸入您已建立的應用程式名稱並將其選取。
  7. 現在，按一下 [檢閱 + 指派]，然後再按一下 [檢閱 + 指派]。

參考連結： /azure/role-based-access-control/role-assignments-portal

步驟 6 - 從下列兩個部署選項中選擇一個選項，以部署連接器和相關聯的 Azure Function

重要事項：在部署 Dataminr Pulse Microsoft Sentinel 資料連接器之前，請準備好工作區識別碼和工作區主金鑰 (可以從下方複製)。

選項 1 - Azure Resource Manager (ARM) 範本

使用此方法來自動部署 DataminrPulse 連接器。

  1. 按一下下方的 [部署至 Azure] 按鈕。

    部署至 Azure

  2. 選取偏好的 [訂用帳戶]、[資源群組] 和 [位置]。

  3. 輸入下列資訊：Function Name Workspace ID Workspace Key AlertsTableName BaseURL ClientId ClientSecret AzureClientId AzureClientSecret AzureTenantId AzureResourceGroupName AzureWorkspaceName AzureSubscriptionId Schedule LogLevel

  4. 選取標示著 [我同意上述條款及條件] 的核取方塊。

  5. 按一下 [購買] 以部署。

選項 2 - Azure Functions 手動部署

使用下列逐步指示，利用 Azure Functions (透過 Visual Studio Code 部署) 手動部署 Dataminr Pulse Microsoft Sentinel 資料連接器。

  1. 部署函數應用程式

注意

您需要為 Azure 函式開發準備 VS 程式碼。

  1. 下載 Azure 函數應用程式檔案。 將封存擷取至本機開發電腦。

  2. 啟動 VS Code。 在主功能表中選擇 [檔案]，然後選取 [開啟資料夾]。

  3. 從擷取的檔案中選取最上層的資料夾。

  4. 選擇活動列中的 Azure 圖示，然後在 [Azure: Functions] 區域中，選擇 [部署至函數應用程式] 按鈕。 如果您尚未登入，請選擇活動列中的 Azure 圖示，然後在 [Azure: Functions] 區域中選擇 [登入 Azure] 如果已登入，請移至下一個步驟。

  5. 提示中會提供下列資訊：

    a. 選取資料夾：從工作區選擇一個資料夾，或瀏覽至其中一個包含您函數應用程式的資料夾。

    b. 選取訂用帳戶：選擇要使用的訂用帳戶。

    c. 選取 [在 Azure 中建立新的函數應用程式] (不要選擇 [進階] 選項)

    d. 輸入函數應用程式的全域唯一名稱：鍵入 URL 路徑中的有效名稱。 您鍵入的名稱會經過驗證，確定其在 Azure Functions 中是唯一。 (例如 DmPulseXXXXX)。

    e. 選取執行階段：選擇 Python 3.8 或更高版本。

    f. 選取新資源的位置。 為了獲得更好的效能和更低的成本，請選擇 Microsoft Sentinel 所在的相同區域。

  6. 部署即將開始。 建立函式應用程式並套用部署套件之後，即會顯示通知。

  7. 移至 Azure 入口網站以進行函數應用程式設定。

  1. 設定函數應用程式
  1. 在函數應用程式中，選取 [函數應用程式名稱]，然後選取 [設定]。
  2. 在 [應用程式設定] 索引標籤中，選取 [+ 新應用程式設定]。
  3. 以個別值個別新增下列每個應用程式設定 (區分大小寫)：Function Name Workspace ID Workspace Key AlertsTableName BaseURL ClientId ClientSecret AzureClientId AzureClientSecret AzureTenantId AzureResourceGroupName AzureWorkspaceName AzureSubscriptionId Schedule LogLevel logAnalyticsUri (選用)
  • 使用 logAnalyticsUri 覆寫專用雲端的記錄分析 API 端點。 例如，對於公用雲端，請將值保留為空白；對於 Azure GovUS 雲端環境，請以下列格式指定值：https://<CustomerId>.ods.opinsights.azure.us。
  1. 輸入所有應用程式設定之後，請按一下 [儲存]。

步驟 7 - 部署後的步驟

  1. 取得函數應用程式端點
  1. 移至 [Azure 函式概觀] 頁面，然後按一下左側刀鋒視窗中的 [函式]。
  2. 按一下名為 "DataminrPulseAlertsHttpStarter" 的函式。
  3. 移至 [GetFunctionurl]，並複製函式 URL。
  4. 在複製的函式 URL 中，將 {functionname} 取代為 "DataminrPulseAlertsSentinelOrchestrator"。
  1. 使用函式 URL 在 Dataminr RTAP 中新增整合設定
  1. 開啟任何 API 要求工具，例如 Postman。
  2. 按兩下 [+] 以建立新的要求。
  3. 選取 [HTTP 要求方法] 作為 'POST'。
  4. 在要求 URL 部分中，輸入在第 1 點中預備的 URL。
  5. 在 [本文] 中，選取原始 JSON 並提供要求本文，如下所示 (區分大小寫)：{ "integration-settings": "ADD", "url": "(URL part from copied Function-url)", "token": "(value of code parameter from copied Function-url)" }
  6. 提供所有必要的詳細資料之後，按一下 [傳送]。
  7. 您將會在 HTTP 回應 (狀態碼為 200) 中收到整合設定識別碼。
  8. 儲存整合識別碼以供日後參考。

現在，我們已完成新增 Dataminr RTAP 的整合設定。 當 Dataminr RTAP 傳送警示資料之後，函數應用程式就會觸發，而且您應該能夠看到 Dataminr Pulse 中的警示資料進入到名為 "DataminrPulse_Alerts_CL" 的 LogAnalytics 工作區資料表。

下一步

如需詳細資訊，請移至 Azure Marketplace 中的相關解決方案 (英文)。