# 加密传输

为了建立安全通道，就是通信双方建立连接通道后，在这个通道中传递的信息不可被第三方窃取，或者即使窃取后，也不能识别信息内容。但是仅通信双方建立安全通道是不够的，还需要进行合法性确认。

通常终端的合法性是基于用户名密码实现的，即服务器通过客户端提交的用户名和密码来进行鉴权，确认此用户的合法性。

在建立安全通道以及身份合法性验证后，后续大量的信息交互需要高效率的加密和解密，通常我们会使用对称加密方式进行处理。

# 1. 国密加密

国密SM4分组密码算法是我国自主设计的分组对称密码算法，用于实现数据的加密/解密运算，以保证数据和信息的机密性。
要保证一个对称密码算法的安全性的基本条件是其具备足够的密钥长度，SM4算法与AES算法具有相同的密钥长度分组长度128比特，因此在安全性上高于3DES算法。

在登录的接口参数里设置 CA 证书（Certificate）和账户分录（AccountEntry）。

通过 setCertificate (opens new window) 设置 Base64 编码后的证书字符串，通过 setAccountEntry (opens new window) 设置账户分录。

示例代码：

JRTCClientLoginParam loginParam = new JRTCClientLoginParam();
loginParam.setCertificate("证书内容");
loginParam.setAccountEntry("AccountEntry:sarc -h arc@AccountEntry -p 198 -S 3;";);
//用户登录
client.login(@"123", @"123", loginParam);

在呼叫时设置加密方式 setSecurityType (opens new window) 为 SECURITY_TYPE_SM4 (opens new window)。

示例代码：

JRTCCallCenterCallParam callParam = new JRTCCallCenterCallParam();
callParam.setSecurityType(JRTCRoom.SECURITY_TYPE_SM4);
guest.call("10086", callParam);

# 2. Token校验

Token认证服务，主要用于登录时token验证，由第三方服务获取token，将token下发给集成的终端，由SDK发起登录时带上token，进行认证。

详见 token 流程介绍 (opens new window)。允许用户登录时，带入token。如果未使用，可以不带。

/**
 * 登录 Juphoon RTC 平台，只有登录成功后才能进行平台上的各种业务
 * 登录结果通过 {@link JRTCClientCallback#onLogin onLogin} 回调通知
 *
 * @param userId            用户ID
 * @param password          密码，不能为空
 * @param clientLoginParam  登录参数，一般不需要设置，如需设置请询问客服，传 null 则按默认值
 * @see JRTCClientLoginParam
 * @return 接口调用结果
 * - true: 接口调用成功
 * - false: 接口调用异常
 * @warning 目前只支持免鉴权模式，服务器不校验账号密码，免鉴权模式下当账号不存在时会自动去创建该账号
 * @warning 用户名为英文数字和'+' '-' '_' '.'，长度不要超过64字符，'-' '_' '.'不能作为第一个字符
 */
 public abstract boolean login(String userId, String password,JRTCClientLoginParam clientLoginParam);

示例代码：

JRTCClientLoginParam loginParam = new JRTCClientLoginParam();
param.setToken = "token字符串";
client.login("userId", "密码", loginParam);