火山引擎短信服务为客户提供了手机号加密功能。您可在火山引擎控制台配置手机号加密方式;配置成功后,发送接口和回调中的手机号均可按照约定的加密方式加解密。
:::tip
支持的加密方式:RSA2048、AES256
:::
您可在短信服务控制台新增加密配置。
登陆短信服务控制台,并点击“通用管理”-“服务设置”;
点击“立即配置”;
| 字段名称 | 描述 |
|---|---|
| 加密配置名称 | 根据实际业务需求填写加密配置名称(限制1-15个字符),该名称需要在发送请求中传入(字段:EncryptName); |
注意:不允许和已有的加密名称重复; |
|
| 加密方式 | 根据实际业务需求选择加密方式; |
| 已支持的加密方式:AES256、RSA2048; | |
| 密钥生成方式 | 根据实际业务需求选择密钥生成方式,支持系统生成或者直接输入: |
| 1. 系统生成:选择“系统生成”,则直接根据选择的加密方式生成密钥; | |
| 2. 已有密钥,直接输入:根据选择的加密方式,需要填入密钥: | |
| 1. 加密方式为 AES256:需要输入256位密钥,只支持英文字母和数字; | |
| 2. 加密方式为 RSA2048:需要输入不超过2048位的公私钥,支持英文字母、数字和特殊字符; | |
| 是否加“盐” | 根据实际业务需求选择是否加“盐”; |
加“盐”,指的是在字符串的特定位置插入指定字符串(“盐”),打乱原始的字符串,增加额外安全性。目前仅支持“后缀盐”,即默认将“盐”拼接在字符串末尾。 |
|
| “盐”生成方式 | 如需加“盐”,可根据实际业务需求选择“盐”生成方式,支持系统生成或者直接输入: |
| 1. 系统生成; | |
| 2. 已有“盐”,直接输入:需要输入8位"盐",只支持英文字母和数字; |
您可在短信服务控制台查看加密配置。
登陆短信服务控制台,并点击“通用管理”-“服务设置”,即可查看加密配置,其中密钥和“盐”支持复制;
您可在短信服务控制台禁用加密配置。禁用加密配置后:
发送请求将不再支持按照该加密配置进行加解密;
已按照该加密配置发送的短信,仍按照该加密配置回调;
登陆短信服务控制台,并点击“通用管理”-“服务设置”,即可禁用加密配置。
火山引擎短信服务为您提供了加解密工具,支持您输入明文手机号或者密文字符串,测试加解密功能。
登陆短信服务控制台,并点击“通用管理”-“服务设置”-“加解密工具”;
加密:输入明文手机号,并点击“加密”,即可查看该明文手机号通过该配置加密得到的密文字符串;
:::warning
如果配置了“后缀盐”,会自动添加至手机号末尾再进行加密,无需手动添加。
:::

您需在发送请求中传加密配置相关字段。
相关字段如下,详细字段可参见发送接口文档。
| 参数 | 数据类型 | 是否必填 | 说明 |
|---|---|---|---|
| EncryptName | string | 否 | 加密配置名称。火山引擎将按照该加密配置对密文字符串解密后进行下发。 |
| PhoneNumbers | string | 是 | 短信发送的目标手机号,可传入密文字符串。多个密文字符串之间使用英文逗号(,)间隔。 |
如果发送请求中传了加密配置,回调消息的mobile字段为明文手机号按照发送的加密配置加密后的密文字符串。
相关字段如下,详细字段可参见回调消息文档。
| 参数 | 类型 | 描述 |
|---|---|---|
| mobile | string | 手机号或者密文字符串。 |
| EncryptName | string | 加密配置名称,和发送请求的加密配置一致。 |