本文介紹如何通過OpenAPI使用辦公安全平臺SASE(Secure Access Service Edge)。
查看OpenAPI文檔
您可以通過API概覽查看支持的接口列表。本文以ListPrivateAccessTags - 批量查詢內網訪問標簽為例,為您介紹如何使用OpenAPI集成SDK示例。
創建RAM用戶并授權
身份
您可以使用阿里云賬號(主賬號)、RAM用戶(子賬號)、RAM角色調用該接口,有關各種身份的差異,請參見身份、憑據與授權。本案例中,我們使用RAM用戶進行接口調用。
登錄RAM訪問控制,創建一個僅允許API調用的RAM用戶,并記錄AccessKey信息。具體操作,請參見創建RAM用戶。
授權
訪問RAM用戶列表,單擊目標RAM用戶操作列的添加權限。
在權限策略區塊中輸入關鍵字
CSAS
進行搜索,選擇AliyunCSASFullAccess策略。說明SASE的系統權限策略如下:
AliyunCSASFullAccess:管理SASE的權限。
AliyunCSASReadOnlyAccess:只讀管理SASE的權限。
關于如何創建自定義權限,請參見授權信息。
單擊確定新增授權,完成授權操作。
憑證
在創建RAM用戶時會默認生成一個AccessKey,可直接使用。您也可以進入到對應的RAM用戶詳情頁面,在認證管理頁簽,單擊創建AccessKey,創建一個新的AccessKey。具體操作,請參見創建AccessKey。
調用OpenAPI
本文以Python語言為例,為您介紹OpenAPI的調用方法。
準備Python環境
下載并安裝Python。
Python 3的下載地址,請參見Python 3。
查看Python版本。
Linux和macOS系統
打開終端,輸入
python --version
。Windows系統
在Python的安裝路徑下,雙擊python.exe。
打開命令提示符頁面。
通過鍵盤快捷鍵Win+R打開運行對話框,輸入命令python,單擊確定。
配置環境變量
關于如何配置環境變量,請參見在Linux、macOS和Windows系統配置環境變量。
安裝依賴
pip install alibabacloud_credentials
pip install alibabacloud_csas20230120==1.0.1
pip install alibabacloud_tea_console
下載示例代碼
在OpenAPI門戶,訪問ListPrivateAccessTags - 批量查詢內網訪問標簽接口的調試地址。
在參數配置頁簽,輸入必選參數CurrentPage和PageSize的值,然后單擊發起調用。
在SDK示例頁簽,單擊Python頁簽,獲取Python語言的SDK示例。
單擊下載完整工程,下載示例代碼包。
在本地解壓示例代碼包,并進入alibabacloud_sample目錄。
運行代碼
執行以下命令:
python sample.py
得到如下輸出結果:
{
"headers": {
"date": "Fri, 11 Aug 2023 03:36:37 GMT",
"content-type": "application/json;charset=utf-8",
"content-length": "372",
"connection": "keep-alive",
"keep-alive": "timeout=25",
"access-control-allow-origin": "*",
"access-control-expose-headers": "*",
"x-acs-request-id": "E556521A-CC49-506D-8FB3-753CA5AE****",
"x-acs-trace-id": "92cce71cf7f21e142c86d7fbb46d****",
"etag": "3Eqai375bf2r78EqTr+R****"
},
"statusCode": 200,
"body": {
"RequestId": "E556521A-CC49-506D-8FB3-753CA5AED661",
"Tags": [{
"ApplicationIds": ["pa-application-58a9942ea689****", "pa-application-91f960671233****", "pa-application-c2ed1730f5f9****", "pa-application-e3f8d2c00703****"],
"CreateTime": "2021-01-12 17:53:54",
"Description": "",
"Name": "業務系統",
"PolicyIds": [],
"TagId": "tag-3d3c384d002d****",
"TagType": "Default"
}],
"TotalNum": 18
}
}