You need to enable JavaScript to run this app.
导航
短信服务
  • 文档首页
    • /
  • 短信服务

手机号加密

最近更新时间：2023.12.12 14:19:17

首次发布时间：2023.12.12 14:19:17

我的收藏

火山引擎短信服务为客户提供了手机号加密功能。您可在火山引擎控制台配置手机号加密方式；配置成功后，发送接口和回调中的手机号均可按照约定的加密方式加解密。

说明

支持的加密方式：RSA2048、AES256


前提条件
  • 开通短信服务。

使用指引

新增加密配置

您可在短信服务控制台新增加密配置。

操作步骤

  1. 登陆短信服务控制台，并点击“通用管理”-“服务设置”；

  2. 点击“立即配置”；

  1. 根据实际情况，填写加密配置；
字段名称描述

加密配置名称

根据实际业务需求填写加密配置名称（限制1-15个字符），该名称需要在发送请求中传入（字段：EncryptName）；

注意：不允许和已有的加密名称重复；

加密方式

根据实际业务需求选择加密方式；
已支持的加密方式：AES256、RSA2048；

密钥生成方式

根据实际业务需求选择密钥生成方式，支持系统生成或者直接输入：

  1. 系统生成：选择“系统生成”，则直接根据选择的加密方式生成密钥；

  2. 已有密钥，直接输入：根据选择的加密方式，需要填入密钥：

    1. 加密方式为 AES256：需要输入256位密钥，只支持英文字母和数字；

    2. 加密方式为 RSA2048：需要输入不超过2048位的公私钥，支持英文字母、数字和特殊字符；

是否加“盐”

根据实际业务需求选择是否加“盐”；

加“盐”，指的是在字符串的特定位置插入指定字符串（“盐”），打乱原始的字符串，增加额外安全性。目前仅支持“后缀盐”，即默认将“盐”拼接在字符串末尾。 

“盐”生成方式

如需加“盐”，可根据实际业务需求选择“盐”生成方式，支持系统生成或者直接输入：

  1. 系统生成；

  2. 已有“盐”，直接输入：需要输入8位"盐"，只支持英文字母和数字；

  1. 点击“确定”，即可新增加密配置。

查看加密配置

您可在短信服务控制台查看加密配置。

操作步骤

登陆短信服务控制台，并点击“通用管理”-“服务设置”，即可查看加密配置，其中密钥和“盐”支持复制；


禁用加密配置

您可在短信服务控制台禁用加密配置。禁用加密配置后：

  1. 发送请求将不再支持按照该加密配置进行加解密；

  2. 已按照该加密配置发送的短信，仍按照该加密配置回调；

操作步骤

登陆短信服务控制台，并点击“通用管理”-“服务设置”，即可禁用加密配置。


加解密工具

火山引擎短信服务为您提供了加解密工具，支持您输入明文手机号或者密文字符串，测试加解密功能。

操作步骤

  1. 登陆短信服务控制台，并点击“通用管理”-“服务设置”-“加解密工具”；

  2. 加密：输入明文手机号，并点击“加密”，即可查看该明文手机号通过该配置加密得到的密文字符串；

注意

如果配置了“后缀盐”，会自动添加至手机号末尾再进行加密，无需手动添加。

  1. 解密：输入密文字符串，并点击“解密”，即可查看该字符串通过该配置解密得到的明文手机号；
    alt

发送加密

您需在发送请求中传加密配置相关字段。
相关字段如下，详细字段可参见发送接口文档。

参数数据类型是否必填说明

EncryptName

string

否

加密配置名称。火山引擎将按照该加密配置对密文字符串解密后进行下发。

PhoneNumbersstring是短信发送的目标手机号，可传入密文字符串。多个密文字符串之间使用英文逗号（,）间隔。

回调解密

如果发送请求中传了加密配置，回调消息的mobile字段为明文手机号按照发送的加密配置加密后的密文字符串。
相关字段如下，详细字段可参见回调消息文档。

参数类型描述
mobilestring手机号或者密文字符串。
EncryptNamestring加密配置名称，和发送请求的加密配置一致。