內容安全支持以異步消息通知的方式向您發(fā)送機器內容識別和您自助審核的結果。若您的業(yè)務需要使用或集成相關數(shù)據(jù),您需要配置消息通知。本文介紹了配置OSS違規(guī)檢測消息通知的具體操作。
相關概念
在配置回調通知前,請了解下表中描述的相關概念。
名稱 | 說明 |
回調地址 | 回調地址是您在內容安全控制臺配置的服務端地址,通常是您自己的業(yè)務服務器的公網地址。回調地址需要滿足以下要求:
|
Seed | Seed值用于校驗發(fā)送到您設置的HTTP回調通知地址的請求是否來自內容安全服務端。 說明 Seed值在控制臺設置消息通知后自動生成。 |
回調次數(shù) | 您的服務端接收到內容安全推送的回調消息后,如果返回的HTTP狀態(tài)碼為200,表示接收成功;如果返回其他的HTTP狀態(tài)碼,均視為接收失敗。如果接收失敗,內容安全服務端會重復推送回調消息,直至您接收成功。內容安全最多重復推送回調消息3次。 |
回調數(shù)據(jù) | 回調數(shù)據(jù)是內容安全服務端向您設置的回調通知地址返回的數(shù)據(jù)內容。關于回調數(shù)據(jù)的結構描述,請參見回調通知表單數(shù)據(jù)。 |
表 1. 回調通知表單數(shù)據(jù)
名稱 | 類型 | 描述 |
checksum | String | 總和校驗碼,由 說明 為防篡改,您可以在獲取到推送結果時,按上述算法生成字符串,與checksum做一次校驗。 |
content | String | 字符串格式保存的JSON對象,請自行解析反轉成JSON對象。關于content解析成JSON后的結構,請參見content表單字段結構說明。 說明 在內容檢測API和OSS違規(guī)檢測中,content的參數(shù)結構不同。 |
設置消息通知
登錄內容安全控制臺。
在左側導航欄,選擇 。
在OSS違規(guī)檢測 V1.0頁面,單擊消息通知。
在消息通知頁簽,單擊新增通知。
在新增通知對話框,完成回調通知配置,并單擊確定。
回調通知配置的描述如下。
配置項
說明
方案名稱
設置方案的名稱。必須在12個字符以內,包含中英文、下劃線和數(shù)字。
回調地址
填入回調通知地址。
加密算法
設置對回調通知內容進行加密的算法。內容安全會將返回結果(由
用戶uid + seed + content
拼接的字符串)按照您設置的加密算法加密后,再發(fā)送到您的回調通知地址。加密算法分為以下兩類:SHA256(默認):使用HMAC-SHA256加密算法。
國密SM3:使用國密SM3加密算法,返回十六進制的字符串,且字符串由小寫字母和數(shù)字組成。
例如,回調通知abc經國密SM3加密后返回66c7f0f462eeedd9d1f2d46bdc10e4e24167c4875cf2f7a2297da02b8f4ba8e0。
通知類型
開啟掃描回調后,選擇對哪些類型的掃描結果進行回調通知。支持多選,通知類型分為以下兩種:
機器審核結果
自助審核結果
審核結果
開啟掃描回調后,選擇對哪些類型的審核結果進行回調通知。支持多選,審核結果分為以下三種:
確定違規(guī)
疑似違規(guī)
正常
設置完成后,系統(tǒng)自動生成Seed。Seed值用于校驗您的回調接口收到的請求來自阿里云。請保存自動生成的Seed,根據(jù)需要應用于您的業(yè)務。
content表單字段結構說明
啟用回調通知后,內容安全將按照回調配置發(fā)送OSS違規(guī)檢測的回調通知。回調通知中包含content表單數(shù)據(jù)。下表描述了content表單字段的結構。
表 2. content表單字段結構說明
名稱 | 類型 | 是否必選 | 說明 |
bucket | String | 是 | OSS Bucket的名稱。 |
object | String | 是 | OSS文件名。 |
stock | Boolean | 是 | 是否是存量內容,取值:
|
region | String | 是 | OSS文件所在地域。 |
freezed | Boolean | 是 | 內容是否被凍結(禁止通過公網訪問這些內容),取值:
|
scanResult | JSONObject | 否 | 掃描結果。根據(jù)檢測對象(圖片、視頻)的不同,結構有差異。 |
auditResult | JSONObject | 否 | 自助審核結果,執(zhí)行自助審核操作時才會有該字段。具體結構描述,請參見auditResult。 說明 當您選擇通知類型為自助審核結果,才出現(xiàn)該字段。 |
表 3. auditResult
名稱 | 類型 | 是否必選 | 說明 |
suggestion | String | 是 | 自助審核的結果。取值:
|
resoureStatus | Integer | 是 | 自助審核后,object的狀態(tài)。取值:
|
content示例
{
"bucket": "xxxxb",
"freezed": false,
"object": "xxx.jpg",
"region": "cn-hangzhou",
"scanResult": {
"code": 200,
"dataId": "5C919E2FBD6CD6940D4A8B46",
"msg": "OK",
"results": [
{
"label": "porn",
"rate": 100.0,
"scene": "porn",
"suggestion": "block"
},
{
"label": "normal",
"rate": 99.6,
"scene": "terrorism",
"suggestion": "pass"
}
],
"taskId": "img1ZxzVQUuAz36scZEjyGXzx-1qpzhY"
},
"auditResult": {
"resoureStatus": 2,
"suggestion": "pass"
},
"stock": false
}
后續(xù)步驟
完成配置消息通知后,您就可以使用OSS違規(guī)檢測的存量掃描和增量掃描功能。詳細信息,請參見設置增量掃描任務、創(chuàng)建存量掃描任務。
如果希望檢測結果更貼合實際業(yè)務,您可以使用自定義圖庫針對性地攔截、放行、自助審核的圖片,應對突發(fā)的管控需求。詳細信息,請參見配置風險庫。