第三方應(yīng)用服務(wù)器鑒權(quán)流程
一、概述
云通訊平臺(tái)基于安全考慮，在開發(fā)者調(diào)用云通訊平臺(tái)語音API后，云通訊平臺(tái)會(huì)向第三方應(yīng)用服務(wù)器發(fā)起鑒權(quán)請求，如下圖所示：
因此，在一個(gè)語音應(yīng)用正式上線前，開發(fā)者需要配置第三方應(yīng)用服務(wù)器的鑒權(quán)地址（云通訊稱之為回調(diào)地址），請參考新手指引；云通訊的鑒權(quán)請求采用標(biāo)準(zhǔn)的HTTP/HTTPS，請求和響應(yīng)的報(bào)文參見鑒權(quán)接口說明。
二、第三方鑒權(quán)接口開發(fā)步驟說明
1、鑒權(quán)接口說明
首先要明確鑒權(quán)通知有3個(gè)：分別為呼叫鑒權(quán)，呼叫建立，呼叫掛機(jī)計(jì)費(fèi)，對應(yīng)的Action分別為CallAuth，CallEstablish，Hangup，第三方處理程序需要根據(jù)Action區(qū)分通知。
2、添加應(yīng)用回調(diào)配置
在創(chuàng)建或修改應(yīng)用頁面配置應(yīng)用回調(diào)地址，并勾選鑒權(quán)選項(xiàng)：
注：勾選其他回調(diào)功能，回調(diào)Action判斷與鑒權(quán)相同。
3、配置鑒權(quán)URL
開發(fā)者根據(jù)自身應(yīng)用服務(wù)器的開發(fā)語言和運(yùn)行環(huán)境，可以任選以下一種方式處理鑒權(quán)通知。
1、通過URL區(qū)分鑒權(quán)通知
需要在URL上增加通配符**，云通訊平臺(tái)會(huì)將通配符替換為對應(yīng)的Action。應(yīng)用配置回調(diào)地址：
說明 |
地址 |
|---|---|
應(yīng)用回調(diào)地址 |
www.abc.com/** |
云通訊轉(zhuǎn)譯后請求第三方的地址：
說明 |
地址 |
|---|---|
呼叫鑒權(quán)通知回調(diào)地址 |
www.abc.com/CallAuth |
呼叫建立通知回調(diào)地址 |
www.abc.com/CallEstablish |
呼叫掛機(jī)計(jì)費(fèi)通知回調(diào)地址 |
www.abc.com/Hangup |
2、通過包體解析區(qū)分鑒權(quán)通知
無需再Url上增加通配符，云通訊平臺(tái)在回調(diào)Url上不拼接對應(yīng)的Action，第三方需要解析請求包體，根據(jù)Action區(qū)分通知，包體解析時(shí)參考鑒權(quán)接口說明。應(yīng)用配置回調(diào)地址：
說明 |
地址 |
|---|---|
應(yīng)用回調(diào)地址配置 |
www.abc.com |
云通訊請求第三方的地址：
說明 |
地址 |
|---|---|
呼叫鑒權(quán)通知回調(diào)地址 |
www.abc.com |
呼叫建立通知回調(diào)地址 |
www.abc.com |
呼叫掛機(jī)計(jì)費(fèi)通知回調(diào)地址 |
www.abc.com |
4、鑒權(quán)處理程序部署
建議先使用官方提供的鑒權(quán)Demo進(jìn)行鑒權(quán)測試。依照鑒權(quán)通知的方式部署對應(yīng)的鑒權(quán)處理程序，查看請求日志是否正常。
三、常見問題
1、配置應(yīng)用鑒權(quán)后，呼叫成功，但第三方鑒權(quán)模塊沒有收到云通訊的通知
首先要確保第三方服務(wù)器和網(wǎng)絡(luò)運(yùn)行正常；其次要檢查使用的應(yīng)用ID和通訊賬號(hào)是否為隸屬的應(yīng)用，因?yàn)槿绻`使用測試demo應(yīng)用的賬號(hào)，默認(rèn)是不做鑒權(quán)的。
2、配置應(yīng)用鑒權(quán)地址后，呼叫無法撥通
首先要確認(rèn)應(yīng)用配置的回調(diào)地址已生效；其次第三方應(yīng)用服務(wù)器收到鑒權(quán)請求要正確地按云通訊要求返回包體響應(yīng)。