瞭解安全終端API概述
問題
本檔案介紹思科安全終端(SE)API的使用方式。
解析
要使用SE API，請在SE控制檯中建立API憑據。
本文中的示例使用Windows 7終結點。
1.登入到控制檯並導航到帳戶> API憑據。
1.按一下新建API憑據以建立新的金鑰集。
2.輸入應用程式名稱。選擇Scope of Read-only或Read & Write。
3.按一下建立按鈕。系統將顯示API Key Details頁面。儲存此資訊，因為某些資訊在離開螢幕後不可用。
如果您懷疑某個應用程式的API憑證已受到危害，請將其刪除，然後建立一個新憑據。 刪除API憑據時，它會鎖定使用舊憑據的客戶端，因此使用新憑據更新它們。
環境
- 測試的終端：Windows 7終結點。
- 產品:Cisco SE
- 存取:具有建立和刪除API憑據的許可權的控制檯訪問。
- API:SE API版本3、版本1和版本0（示例使用版本1）。
- 客戶端工具:安裝在用於運行API請求的系統上的curl。
SE API目前有三個版本：版本3、版本1和版本0。與版本1和版本0相比，版本3提供其他功能。版本3 API文檔可從此連結獲得。使用版本3可檢索此資訊：
- 稽核日誌
- 裝置控制
- 裝置
- 排除
- 主機防火牆
- IOC
- MSSP
- 組織
- 政策
- 電腦
- 漏洞
按一下文檔中的相關命令，檢視其用法示例。
API命令細分和示例
每個API命令都包含類似資訊，並分解為如下所示的curl命令：
curl -o yourfilename.json https://client_id:api_key@api.example.com/v1/whatyouwanttodo當使用帶有 — o選項的curl命令時，可將輸出儲存到檔案。在這種情況下，檔名是「yourfilename.json」。
curl命令的下一部分在@符號之前指定憑據。生成API憑據後，請使用URL此部分中的API客戶端ID和API金鑰。
https://client_id:api_key@新增版本號和要執行的操作。在本例中，運行GET /v1/computers。完整命令如下所示：
curl -o computers.json https://client_id:api_key@api.example.com/v1/computers運行該命令後，在您啟動該命令的目錄中將顯示computers.json檔案。
開啟檔案時，所有資料都顯示在一行上。要在格式化佈局中檢視它，請安裝格式化JSON的瀏覽器外掛，然後在瀏覽器中開啟該檔案。此輸出顯示電腦的資訊，例如：
connector_guid、hostname、active、links、connector_version、operating_system、internal_ips、external_ip、group_guid、network_addresses、policy guid和策略名稱。
{
version: "v1.0.0",
metadata: {
links: {
self: "https://api.amp.cisco.com/v1/computers"
},
results: {
total: 4,
current_item_count: 4,
index: 0,
items_per_page: 500
}
},
data: [
{
connector_guid: "abcdef-1234-5678-9abc-def123456789",
hostname: "host.example.com",
active: true,
links: {
computer: "https://api.amp.cisco.com/v1/computers/abcdef-1234-5678-9abc-def123456789",
trajectory: "https://api.amp.cisco.com/v1/computers/abcdef-1234-5678-9abc-def123456789/trajectory",
group: "https://api.amp.cisco.com/v1/groups/abcdef-1234-5678-9abc-def123456789"
},
connector_version: "4.4.2.10200",
operating_system: "Windows 7, SP 1.0",
internal_ips: [
"10.1.1.2",
" 192.168.1.2",
" 192.168.2.2",
" 169.254.245.1"
],
external_ip: "192.0.2.10",
group_guid: "abcdef-1234-5678-9abc-def123456789",
network_addresses: [
{
mac: "ab:cd:ef:01:23:45",
ip: "10.1.1.2"
},
{
mac: "bc:de:f0:12:34:56",
ip: "192.168.1.2"
},
{
mac: "cd:ef:01:23:45:67",
ip: "192.168.2.2"
},
{
mac: "de:f0:12:34:56:78",
ip: "169.254.245.1"
}
],
policy: {
guid: "abcdef-1234-5678-9abc-def123456789",
name: "Protect Policy"
}
}
]
}
此示例顯示一個基本API請求。現在，您可以使用其他命令選項來檢索和修改環境中的資料。
相關內容
- 思科終端進階惡意軟體防護API檔案
- 技術支援與文件 - Cisco Systems
修訂記錄
| 修訂 | 發佈日期 | 意見 |
|---|---|---|
2.0 |
26-Oct-2026
|
重新認證 |
1.0 |
20-Mar-2017
|
初始版本 |
意見