簡介
本文檔介紹使用3個可用API配置和驗證Umbrella與SecureX整合的過程。
必要條件
需求
思科建議您瞭解以下主題:
- 思科資安防護傘
- Cisco Secure X
- 思科威脅響應
採用元件
本文中的資訊係根據以下軟體和硬體版本:
- 具有DNS Advantage許可證的Umbrella帳戶
- 安全X
本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除(預設)的組態來啟動。如果您的網路正在作用,請確保您已瞭解任何指令可能造成的影響。
背景資訊
為了完整配置此整合及其所有功能,您需要訪問以下3個API
- 報告API(包含在所有許可證中)
- 實施API
- 調查API
要配置Umbrella整合,您必須首先從Umbrella例項收集一些資訊,然後完成增加新的Umbrella模組表單。
設定
建立模組
- 登入您的Secure X帳戶。如果您還沒有帳戶,則可以用Cisco安全登入建立一個帳戶。
- 導航到整合>增加新模組。在Available Integrations頁中,向下滾動到Umbrella選項,然後按一下Add New Module。
使用以下步驟,從您的Umbrella帳戶收集必要資訊,以在增加新的Umbrella模組表單中提交。
調查API
- 在Umbrella中,導航到調查>調查API訪問,點選建立新令牌並輸入令牌標題,然後再次點選建立新令牌。
- 將訪問令牌值複製到「增加新的Umbrella模組」窗體上的「API令牌」欄位中。
實施API
- 在Umbrella中,導航到策略>策略元件>整合,點選增加,輸入名稱,然後點選建立。
- 按一下新建立的整合名稱連結,選中Enablecheck框,然後進行儲存。
- 按一下integration name以顯示整合URL。將整合URL複製到Add New Umbrella Module 表單上的Custom Umbrella Integration URL欄位。
注意:要整合Umbrella實施API,您必須是Umbrella獨立組織或子組織中的管理員,而不是Umbrella控制檯中的管理員。
報告API
-
在Umbrella中,導航到管理> API金鑰,然後按一下建立。
-
在此API應做什麼?下,按一下Umbrella Reporting 單選按鈕,然後按一下Create。
-
將以下值複製到Add New Umbrella Module 窗體上的Reporting欄位中:
儲存模組
1. 在Umbrella模組中填寫API資訊,然後按一下Save。
建立SecureX儀表板
1. 增加模組後,您可以導航到Secure X並建立新控制台。
2. 在可用控制台下,選擇您的Umbrella模組並增加您感興趣的「類別」。
3. 按一下儲存,然後檢視透過API填充的資訊。
驗證
使用本節內容,確認您的組態是否正常運作。
調查
「調查API」允許您向CTR調查增加源,檢視域的處置情況並使用其他模組豐富調查。
1. 要驗證此整合,請在思科威脅響應中進行新的調查。Umbrella提供的處置可在搜尋已知域(例如cisco.com)時找到。
2. 如果您按一下「關係圖」中的領域下方,也可以從那裡樞紐分析至Umbrella中的「調查儀表板」。
強制執行
透過實施API,您可以直接阻止或取消阻止調查中的域。
1. 為了驗證API是否有效,您可以阻止調查中發現的域,並將該域增加到Umbrella中的策略阻止清單。
2. 要驗證URL是否已增加到阻止清單,請導航到策略>策略元件>整合。選擇您的SecureX整合,然後按一下檢視域。 一個窗口顯示來自CTR的已增加域。
3. 如果未阻止域,請在Umbrella控制台上導航到策略>策略元件>安全設定。 在Integrations 下,確保已應用了所需清單。
報告
報告API允許您檢視SecureX中Umbrella部署的資訊。
您可以驗證與您已知已在CTR的環境中發現的域調查是否整合。
在CTR調查中,已訪問特定域的電腦清單顯示在Sighings下。
影片
您可以在本影片中找到本文中包含的配置資訊。
相關資訊