## 文档概述 「短信配置」是 MuuCmf T6 后台管理系统中用于对接第三方短信服务平台的功能模块。 系统通过本模块可接入**阿里云短信**或**腾讯云短信**任一平台,用于向用户发送短信验证码、通知类短信等。配置完成后,注册、登录、找回密码等需要短信验证的业务即可正常发送验证码。 **核心用途:** - **对接短信平台**:选择短信发送平台(阿里云 / 腾讯云),并填写平台提供的鉴权与业务参数; - **设置验证码有效期**:统一控制短信验证码的有效时长; - **保障业务可用**:短信配置正确后,注册、登录、密码重置等场景的短信验证码才能正常下发。 --- ## 1. 功能说明 「短信配置」用于将 MuuCmf 系统与第三方短信服务平台(阿里云短信、腾讯云短信)建立连接。系统依据所配置的鉴权凭证与签名、模板信息,调用对应平台的短信 API 发送短信。 模块顶部提供两项基础设置: - **短信发送平台**:选择实际使用的短信平台(阿里云 / 腾讯云),系统按所选平台读取对应平台的参数发送短信; - **验证码有效期**:设置短信验证码的有效时长(秒)。 模块下方以标签页形式提供「阿里云短信」与「腾讯云短信」两个参数区,分别填写对应平台的接入参数。**只需配置实际要使用的那一个平台**,并将顶部「短信发送平台」选定为该平台即可。 ## 2. 功能入口 左侧导航:**系统 → 第三方扩展 → 短信配置** 进入方式:点击顶部「系统」菜单 → 左侧「第三方扩展」展开 → 选择「短信配置」子项,右侧主区域即显示「短信基本配置」页面。  ## 3. 页面组成 短信配置页面自上而下分为三部分: | 区域 | 内容 | | --- | --- | | 基础配置区 | 「短信发送平台」下拉选择、「验证码有效期」数值调整 | | 平台参数区 | 「阿里云短信」「腾讯云短信」两个标签页,分别填写对应平台参数 | | 操作区 | 页面底部「保存配置」按钮,用于提交保存 | ## 4. 配置项说明 ### 4.1 基础配置(通用) | 配置项 | 用途说明 | 填写说明 | | --- | --- | --- | | 短信发送平台 | 选择实际使用的第三方短信平台 | 下拉选择「阿里云」或「腾讯云」;须与下方填写的平台参数保持一致 | | 验证码有效期 | 短信验证码的有效时长(一般以秒为单位) | 通过加减按钮或输入框设置数值,如 60 表示 60 秒 | ### 4.2 阿里云短信参数 | 配置项 | 用途说明 | 填写说明 | | --- | --- | --- | | AccessKeyID | 访问阿里云 API 的密钥 ID,拥有该账号相应权限 | 填写阿里云账号的 AccessKey ID | | AccessKeySecret | 访问阿里云 API 的密钥密码,拥有该账号相应权限 | 填写与 AccessKeyID 配套的 AccessKey Secret | | 短信签名 | 短信发送的签名名称 | 严格按阿里云已审核通过的「签名名称」填写(非签名 ID) | | 短信模板 | 短信正文模板 | 严格按阿里云已审核通过的「模板 CODE」填写(如 SMS_xxxxxxx) | | Region | 短信服务所属地域 | 填写地域参数,格式如 cn-beijing、cn-hangzhou 等 | ### 4.3 腾讯云短信参数 | 配置项 | 用途说明 | 填写说明 | | --- | --- | --- | | 腾讯云SDKAppID | 短信应用唯一标识,调用接口时需提供 | 填写短信控制台「应用管理」中的应用 SDKAppID(一串数字) | | 短信签名 | 短信发送的签名内容 | 填写已申请的「签名内容」(如「火木科技」),而非签名 ID | | 短信模板 | 短信正文模板 | 严格按腾讯云「模板 ID」填写(一串数字) | | SecretID | 项目安全密钥 ID,拥有该账号相应权限 | 填写腾讯云 API 密钥的 SecretId | | SecretKEY | 项目安全密钥,拥有该账号相应权限 | 填写与 SecretID 配套的 SecretKey | | Region | 短信服务所属地域 | 填写地域参数,格式如 ap-beijing、ap-guangzhou 等 | --- ## 5. 阿里云短信接入步骤 1、申请开通阿里云短信服务: 登录阿里云官网【短信控制台】:https://dysms.console.aliyun.com/overview 申请开通短信服务。 2、点击右上角头像-AccessKey管理  3、创建AccessKey,点击查看Secret  4、复制AccessKey ID和AccessKey Secret  5、登录MuuCmf T6管理后台-系统-第三方扩展-短信配置-阿里云短信,将上述获取到的参数分别粘贴到AccessKey ID和AccessKey Secret里  7、返回阿里云短信服务-国内消息-签名管理-添加签名  8、填写签名名称,适用场景选择:验证码,签名来源:已备案网站,网站域名:选择您在MuuCmf绑定的授权域名,其他按各自情况填写,提交后等待审核。  9、审核通过之后,将您的签名名称填写到MuuCmf T6管理后台-系统-第三方扩展-短信配置-阿里云短信-短信签名里。  10、返回腾讯云短信服务,点击国内消息-模板管理-添加模板  11、模板名称:验证码 短信类型:验证码 短信内容:您的验证码${code},该验证码5分钟内有效,请勿泄漏于他人! 申请说明:为用户提供注册、登陆等验证码发送服务  12、复制生成的【模板CODE】  13、将【模板CODE】粘贴到MuuCmf T6管理后台-系统-第三方扩展-短信配置-阿里云短信-短信模板里。点击确定,即配置完成。  --- ## 6. 腾讯云短信接入步骤 1、申请开通短信服务 登录腾讯云官网【短信控制台】,勾选我已阅读并同意 腾讯云短信[服务协议],单击**开始接入**即可开通。  2、登录腾讯云账号,右上角点击头像,在弹出的下拉菜单中点击【访问管理】  3、点击API密钥管理,复制SecretId、SecretKey  4、将SecretId、SecretKey粘贴到MuuCmf管理后台-系统-第三方扩展-短信配置-腾讯云短信相应位置  5、现腾讯云所有接口 Region 字段的可选值如下表所示  6、登录MuuCmf T6管理后台Region处可填写ap-beijing、ap-guangzhou或ap-nanjing,三者任选其一填入即可。可参考文档:https://cloud.tencent.com/document/api/382/52071#.E5.9C.B0.E5.9F.9F.E5.88.97.E8.A1.A8  7、点击左侧菜单-应用管理-应用列表-“创建应用”  8、填写自己的应用名称、应用简介,点击创建  9、进入新创建的应用,复制里面的SDK AppID  10、登录MuuCmf管理后台-系统-第三方扩展-短信配置-腾讯云短信,将SDK AppID填入Appid里  11、返回腾讯云短信配置,点击左侧菜单-国内短信-签名管理,创建签名。  12、按各填写项目下方要求,填写和上传信息后,确定等待审核,2小时左右完成审核。  13、审核通过之后,将签名内容填写到MuuCmf T6管理后台-系统-第三方扩展-短信配置-腾讯云短信的【短信签名】里。  14、返回腾讯云短信配置,点击左侧菜单-国内短信-正文模板管理-创建正文模板。  15、模板名称:验证码 短信类型:普通短信 短信内容:您的验证码:{1},如非本人操作,请忽略本短信! 申请说明:用户绑定手机号码时,给用户发送验证码,以便验证手机号码真实性。  16、复制此处ID号  17、将ID号填写到MuuCmf T6管理后台-系统-第三方扩展-短信配置-腾讯云短信的【短信模板】里,确定即可。  ## 7. 操作方法(通用) ### 7.1 保存配置 填写完成后点击页面底部「保存配置」按钮提交,配置即时生效。 ### 7.2 切换短信平台 如需更换发送平台,将顶部「短信发送平台」下拉改为目标平台,并确保已在该平台对应的标签页填写完整参数,然后保存即可。切换前建议确认新平台参数已填写正确,避免切换后短信无法发送。 --- ## 8. 使用建议 1. 阿里云、腾讯云两个平台只需配置实际使用的一个,避免仅填写参数却未将「短信发送平台」切换到对应平台; 2. 短信签名、短信模板必须先在各平台完成申请并通过审核,后台填写的是**签名名称/内容**与**模板 CODE/ID**,而非签名或模板的内部编号; 3. AccessKey/Secret 属高敏感凭证,建议使用子账号(RAM/CAM)密钥并按最小权限授权,妥善保管、定期轮换; 4. 「验证码有效期」建议设置为 60 秒左右,过短影响用户体验,过长降低安全性; 5. 接入后务必进行实际发送验证,确认签名与模板在对应平台均可用; 6. 如发送失败,请按平台返回的错误码排查(常见为签名/模板未审核通过、模板参数不匹配、密钥权限不足、欠费或限额等)。 --- ## 附录:常用参数对照表 | 参数(后台) | 阿里云对应 | 腾讯云对应 | | --- | --- | --- | | 密钥 ID | AccessKeyID | SecretID | | 密钥密码 | AccessKeySecret | SecretKEY | | 应用标识 | —(无需) | 腾讯云SDKAppID | | 签名 | 签名名称 | 签名内容 | | 模板 | 模板 CODE(SMS_xxx) | 模板 ID | | 地域 | cn-beijing 等 | ap-beijing 等 | 按以上步骤操作,即可完成 MuuCmf T6 后台短信配置的接入。