# 媒体流加密 (/zh-CN/realtime-media/rtsa/build/media-transmission/encryption) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 在实时音视频互动过程中,你需要对媒体流加密,从而保障用户的数据安全。声网 RTSA SDK 提供内置加密方案,可以对音视频数据包进行加密。 :::info[信息] 你可以根据业务所在区域对数据安全及隐私保护的要求,以及自身的安全策略,选择是否启用声网支持的加密功能以及具体的加密方式。 ::: 声网 RTSA SDK 的加密原理如下: ![RTSA 加密原理](https://web-cdn.agora.io/docs-portal/img/rtsa/encryption.png) RTSA SDK 目前支持以下加密模式: - `AES_128_XTS` - `AES_128_ECB` - `AES_256_XTS` - `SM4_128_ECB` - `AES_128_GCM` - `AES_256_GCM` - `AES_128_GCM2`(推荐) - `AES_256_GCM2`(推荐) ## 实现方法 [#实现方法] 在启用媒体流加密前,请确保已在你的项目中实现基本的实时音视频功能。 参考如下步骤,为你的 App 添加内置媒体流加密功能: 1. 在你的服务端生成一个密钥和盐。 - 在你的服务端,参考以下命令,通过 OpenSSL 随机生成一个 16 字节的随机值,并以 16 进制 (hex) 字符串形式输出,作为密钥使用: ```shell # 随机生成一个密钥 openssl rand -hex 16 # 示例输出 9f3c7a1e5b8d4c2a6e0f91b7d4a2c8e5 ``` - 在你的服务端,参考以下命令,通过 OpenSSL 随机生成 Base64 编码、32 字节的盐: ```shell # 随机生成一个 Base64 编码、32 字节的盐 openssl rand -base64 32 # 示例输出 X5w9T+50kzxVOnkJKiY/lUk82/bES2kATOt3vBuGEDw= ``` 2. 实现客户端逻辑: 1. 从服务端获取 String 型的密钥和 Base64 编码的盐。 2. 将盐从 Base64 转换成 uint8_t。 3. 调用 `agora_rtc_join_channel` 时在 `crypto_option_t` 中开启加密,设置加密模式为 `AES_128_GCM2` 或 `AES_256_GCM2`,并将密钥和盐传入 SDK。 :::info[信息] - 同一频道内所有用户必须使用相同的加密模式、密钥和盐。否则,可能会出现黑屏或音频丢失等未定义行为。 - 为确保安全性,声网建议在每次启用媒体流加密前使用新的密钥和盐。 ::: 以下示例代码展示了该逻辑的实现过程: ``` c rtc_channel_options_t channel_options = { 0 }; // 开启加密 channel_options.crypto_opt.enable = true; // 设置加密模式 channel_options.crypto_opt.mode =AES_128_GCM2; // 传入密钥 sprintf(channel_options.crypto_opt.key, "%s", key_str); // 传入盐 uint8_t *salt_bytes = NULL; uint32_t salt_bytes_len = 0; salt_bytes = util_base64_decode(salt_base64_str, strlen(salt_base64_str), &salt_bytes_len); memcpy(channel_options.crypto_opt.salt, salt_bytes, salt_bytes_len); free(salt_bytes); // 加入频道 agora_rtc_join_channel(conn_id, channel_name, uid, token, &channel_options); ``` ## API 参考 [#api-参考] 开发过程中,你还可以参考如下文档,了解各 API 的详细信息: [`agora_rtc_join_channel`](/zh-CN/api-reference/rtsa/c/agora-rtc-api-8h#a6c29ff27f04623526a164cf6e5dcd738)