云通訊平臺基于安全考慮,在開發者調用云通訊平臺語音API后,云通訊平臺會向第三方應用服務器發起鑒權請求,如下圖所示:
因此,在一個語音應用正式上線前,開發者需要配置第三方應用服務器的鑒權地址(云通訊稱之為回調地址),請參考新手指引;云通訊的鑒權請求采用標準的HTTP/HTTPS,請求和響應的報文參見鑒權接口說明。
1、鑒權接口說明
首先要明確鑒權通知有3個:分別為呼叫鑒權,呼叫建立,呼叫掛機計費,對應的Action分別為CallAuth,CallEstablish,Hangup,第三方處理程序需要根據Action區分通知。
2、添加應用回調配置
在創建或修改應用頁面配置應用回調地址,并勾選鑒權選項:
注:勾選其他回調功能,回調Action判斷與鑒權相同。
3、配置鑒權URL
開發者根據自身應用服務器的開發語言和運行環境,可以任選以下一種方式處理鑒權通知。
1、通過URL區分鑒權通知
需要在URL上增加通配符**,云通訊平臺會將通配符替換為對應的Action。應用配置回調地址:
說明 |
地址 |
---|---|
應用回調地址 |
www.abc.com/** |
云通訊轉譯后請求第三方的地址:
說明 |
地址 |
---|---|
呼叫鑒權通知回調地址 |
www.abc.com/CallAuth |
呼叫建立通知回調地址 |
www.abc.com/CallEstablish |
呼叫掛機計費通知回調地址 |
www.abc.com/Hangup |
2、通過包體解析區分鑒權通知
無需再Url上增加通配符,云通訊平臺在回調Url上不拼接對應的Action,第三方需要解析請求包體,根據Action區分通知,包體解析時參考鑒權接口說明。應用配置回調地址:
說明 |
地址 |
---|---|
應用回調地址配置 |
www.abc.com |
云通訊請求第三方的地址:
說明 |
地址 |
---|---|
呼叫鑒權通知回調地址 |
www.abc.com |
呼叫建立通知回調地址 |
www.abc.com |
呼叫掛機計費通知回調地址 |
www.abc.com |
4、鑒權處理程序部署
建議先使用官方提供的鑒權Demo進行鑒權測試。依照鑒權通知的方式部署對應的鑒權處理程序,查看請求日志是否正常。
1、配置應用鑒權后,呼叫成功,但第三方鑒權模塊沒有收到云通訊的通知
首先要確保第三方服務器和網絡運行正常;其次要檢查使用的應用ID和通訊賬號是否為隸屬的應用,因為如果誤使用測試demo應用的賬號,默認是不做鑒權的。
2、配置應用鑒權地址后,呼叫無法撥通
首先要確認應用配置的回調地址已生效;其次第三方應用服務器收到鑒權請求要正確地按云通訊要求返回包體響應。