使用許可權API檢索ESA使用者角色API

簡介

本文檔介紹如何使用/esa/api/v2.0/login/privileges端點檢索經過驗證的ESA角色的許可權信息。

環境

• Python 3.x
• 已安裝Python請求庫
• 在管理介面上啟用API服務並配置API埠的郵件安全裝置(ESA)

解析

1. 確認已在管理介面上啟用ESA API服務。
2. 確認ESA上配置的API埠並在指令碼中使用相同的埠值。
3. 獲取用於呼叫API的帳戶的Authorization標頭值和有效的ESA會話cookie。
4. 如果需要，請安裝所需的依賴關係：

   pip install requests

5. 更新指令碼變數（ESA IP地址、API埠和身份驗證值），然後運行指令碼。

附註：使用ESA上配置的API埠。在指令碼和任何螢幕截圖中保持埠值一致。

解釋響應

/login/privileges響應表示授予已驗證會話的許可權。使用返回的許可權清單來確定當前使用者角色可用的API資源和操作。

在JSON負載中，檢視data.privileges。每個條目都列出資源路徑以及該資源允許的HTTP方法。

相關內容

2)安裝請求（預設情況下不隨Python一起安裝）。 在命令提示符下運行以下命令：

pip install requests

請求允許從Python傳送HTTP請求。

3)pprint隨Python（標準庫）提供。 無需安裝。

列印模組提供能力，以可用作直譯器輸入並以可讀格式顯示的形式美化地列印任意Python資料結構。此模組是可選的。指令碼可以使用列印代替；但是，輸出的可讀性較低。

 JSON不需要單獨安裝，因為它屬於標準庫。

問題

確定經過身份驗證的使用者角色可以訪問哪些思科郵件安全裝置(ESA)API。

原因

ESA上的API訪問由分配給已驗證會話和角色的許可權控制。/esa/api/v2.0/login/privileges終結點返回有效的許可權清單，以便確定當前使用者允許哪些API資源和HTTP方法。

預期結果

成功傳送到/esa/api/v2.0/login/privileges的GET請求返回HTTP 200 OK和列出已驗證會話可用的許可權（API訪問）的JSON負載。檢視返回的JSON以確定該角色允許的API資源和操作。

解析

程序

import requests
import json
import pprint

url = "https://192.0.2.10:6080/esa/api/v2.0/login/privileges"
headers = {
"Authorization": "Basic ",
    "Cookie": ""
}

response = requests.request("GET", url, headers=headers, verify=True)
json_string = json.loads(response.content)
pprint.pprint(json_string)

輸出範例

輸出示例：

{
  "data": {
    "privileges": [
      {
        "resource": "/esa/api/v2.0/login/privileges",
        "methods": ["GET"]
      }
    ]
  }
}

檢視許可權清單，以確定已驗證會話允許哪些API資源和HTTP方法。

修訂記錄

修訂	發佈日期	意見
1.0	01-Oct-2026	初始版本