本文為您介紹如何通過SDK調用OpenAPI查詢敏感數據識別規則的列表。
查看OpenAPI文檔
閱讀API概覽,選擇可以查詢指定地域實例列表的OpenAPI:DescribeRules - 查詢識別規則的列表。根據接口文檔,了解調用該接口需要的參數及權限。
創建RAM用戶并授權
身份
您可以使用阿里云賬號(主賬號)、RAM用戶、RAM角色調用該接口,有關各種身份的差異請參見身份、憑據、授權。本案例中,我們使用RAM用戶進行接口調用。登錄RAM訪問控制,創建一個僅允許API調用的RAM用戶,記錄AccessKey信息,更多詳情請參見創建RAM用戶。
授權
訪問RAM用戶列表,單擊目標RAM用戶操作列的添加權限。
在權限策略區塊中輸入關鍵字
sddp
進行搜索,根據實際需要選擇策略。說明AliyunYundunSDDPFullAccess:管理數據安全中心的權限。
AliyunYundunSDDPReadOnlyAccess:只讀訪問數據安全中心的權限。
AliyunYundunSDDPDataManager:數據安全中心的數據域管理權限。
如何新建自定義權限,請參見授權信息。
單擊確認新增授權,完成授權操作。
憑證
在創建RAM用戶時會默認生成一個AccessKey,可直接使用。您也可進入到對應的RAM用戶詳情頁,在認證管理頁簽,單擊創建 AccessKey。具體操作,請參見創建AccessKey。
調用OpenAPI
本文使用Java語言SDK。關于阿里云SDK的更多信息,請參見快速開始。
配置環境變量
通過在環境變量中設置AccessKey信息避免在代碼中直接硬編碼AccessKey給業務帶來安全風險。
以在Linux和macOS系統中配置環境變量ALIBABA_CLOUD_ACCESS_KEY_ID
和ALIBABA_CLOUD_ACCESS_KEY_SECRET
為例。
通過export命令配置環境變量
使用export命令配置的臨時環境變量僅當前會話有效,當會話退出之后所設置的環境變量將會丟失。若需長期保留環境變量,可將export命令配置到對應操作系統的啟動配置文件中。
配置AccessKey ID并按回車。
# 將<ACCESS_KEY_ID>替換為您自己的AccessKey ID。 export ALIBABA_CLOUD_ACCESS_KEY_ID=<ACCESS_KEY_ID>
配置AccessKey Secret并回車。
# 將<ACCESS_KEY_SECRET>替換為您自己的AccessKey Secret。 export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<ACCESS_KEY_SECRET>
驗證是否配置成功。
執行
echo $ALIBABA_CLOUD_ACCESS_KEY_ID
命令,如果返回正確的AccessKey ID,則說明配置成功。
關于在Windows系統環境變量中設置AccessKey信息的詳細內容,請參見在Windows系統環境變量中設置阿里云AccessKey。
下載示例代碼
在左側的參數配置頁簽,填寫參數信息。
在右側的SDK示例頁簽,SDK版本選擇v2.0,語言選擇Java語言,單擊下載完整工程按鈕,下載示例代碼包。
本地解壓并進入sample目錄。
打開并運行項目
使用IntelliJ IDEA加載項目,待相關依賴加載完畢后,打開 src/main/java/com/aliyun/sample/Sample.java。根據代碼中的注釋提示自行添加打印返回值的代碼。
單擊IDE右上角的運行按鈕,可查看輸出日志。本案例中的返回內容如下:
{
"TotalCount": 568,
"RequestId": "B62E33DC-368B-52E8-A401-1DFFEB0D4DD8",
"PageSize": 2,
"CurrentPage": 1,
"Items": [
{
"Status": 1,
"CustomType": 1,
"LoginName": "sddp_test",
"Category": 5,
"GmtModified": 1693215690000,
"Name": "delete_test",
"HitTotalCount": 0,
"GroupId": "",
"GmtCreate": 1693215690000,
"MatchType": 1,
"Content": "[{\"rule\":[{\"target\":\"content\"}],\"ruleRelation\":\"AND\"}]",
"DisplayName": "User01",
"SupportForm": 1,
"CategoryName": "關鍵字",
"Id": 9950553,
"ContentCategory": 108
},
{
"Status": 1,
"CustomType": 1,
"LoginName": "sddp_test",
"Category": 5,
"GmtModified": 1692950931000,
"Name": "OCR-test",
"HitTotalCount": 0,
"GroupId": "",
"GmtCreate": 1692950931000,
"MatchType": 1,
"Content": "[{\"rule\":[{\"operator\":\"contains\",\"target\":\"fileName\",\"value\":\"Orc\"}],\"ruleRelation\":\"AND\"}]",
"DisplayName": "User01",
"SupportForm": 2,
"CategoryName": "User01",
"Id": 9950551,
"ContentCategory": 108
}
]
}