===== 呼叫鉴权流程 =====

----

==== 概述 ====


UCPaaS从安全和业务模式方面考虑，在开发者调用云之讯融合通讯开放平台语音API后，开发者可以选择配置第三方应用服务器的呼叫鉴权地址（UCPaaS称之为回调地址，请参考呼叫鉴权接口说明），云之讯融合通讯开放平台会向第三方应用服务器发起呼叫鉴权请求，如下图所示： 
{{:doc_img2.png|}}

开发者可以根据实际情况配置该呼叫鉴权回调地址，

如果配置回调地址，用户发起语音呼叫请求时，云之讯融合通讯开放平台则将会在呼叫请求、通话建立、通话结束时通知第三方应用服务器，开发者则可以及时掌握和控制整个通话过程，并且可以建立独立的计费系统；

如果未配置或配置部分回调地址，用户发起语音呼叫请求时，云之讯融合通讯开放平台则无法将所有会话详情提供给第三方应用服务器；但开发者可以通过rest其他接口查询通话详情；

UCPaaS的呼叫鉴权请求采用标准的HTTP，请求和响应的报文参见呼叫鉴权接口说明
==== 第三方呼叫鉴权请求接口开发步骤说明 ====

==== 1. 呼叫鉴权接口说明 ====


呼叫鉴权通知有3个：分别为呼叫请求通知，呼叫建立，呼叫挂机计费，对应的Action分别为callreq，callestablish，callhangup，第三方处理程序需要根据Action区分通知。

==== 2. 添加应用回调配置 ====


配置应用回调地址，并勾选对应通知选项，如下图所示：\\ 
{{:doc_img3.png|}}

注：勾选其他回调功能，填写对应回调URL地址。

==== 3. 配置鉴权URL ====


开发者可以根据实际情况，任选以下一种方式处理呼叫鉴权通知。\\ 
**1) 通过URL区分呼叫鉴权通知** 
开发者可以在URL上增加对应的Action，如回调BaseURL：http://www.custom.com   (注：custom为开发者域名。)

在对应的Action地址栏分别输入如下回调URL地址：
^说明 ^地址|
|呼叫鉴权通知回调地址 | http://www.custom.com/callreq |
|呼叫建立通知回调地址 |http://www.custom.com/callestablish |
|呼叫挂机计费通知回调地址 |http://www.custom.com/callhangup |

**2) 通过包体解析区分呼叫鉴权通知 ** 
开发者无需在Url上增加Action，直接填写BaseUrl, 第三方通过解析请求包体区分通知Action，包体解析时参考呼叫鉴权接口说明。

在对应的Action地址栏分别输入如下回调URL地址：

^ 说明 ^地址|
|呼叫鉴权通知回调地址 |http://www.custom.com  |
|呼叫建立通知回调地址 |http://www.custom.com  |
|呼叫挂机计费通知回调地址 |http://www.custom.com  |