短信配置-阿里短信平台¶
最后更新:2024-07-31
1. 阿里短信平台¶
您需要先确认已开通阿里云短信服务。您可以选择前往 短信服务控制台 或
查看 短信服务帮助文档 。
我们建议您在短信服务控制台配置一个测试用短信模板,以方便测试 IDaaS 配置是否成功。
1.1. 短信网关配置¶
IDaaS EIAM短信网关为管理员登录IDaaS,然后访问以下菜单【设置】→【通知服务】→【短信配置】,选择【阿里短信平台】点击“配置”按钮即可配置。
IDaaS 需要您从短信服务中获取下列配置信息:
RAM 账户 AK
RAM 账户 SK,您可以查看 短信服务帮助文档 了解 RAM AK/SK 如何获取
已经过审核的短信签名
测试用短信模板 ID
配置页参考下图:
配置完成后,可以通过页面下放的发送测试短信功能,检验
IDaaS 与 短信服务的配置是否成功。
效果如下:
1.2. 短信模板配置¶
IDaaS EIAM短信网关为管理员登录IDaaS,然后访问以下菜单【设置】→【通知服务】→【短信配置】,然后点击【短信模板配置】按钮即可配置。
为了使用 IDaaSEIAM 的全部功能,您需要切换到【短信模板配置】标签中,并为各短信触发点配置对应的 “短信模板 ID”
,并确保IDaaS中的短信文本和短信服务中的短信模板一一对应,完全一致。
注:阿里云短信模板分为验证码、短信通知和推广短信三种类型,其中验证码类签名只能发送验证码模板,通用类签名可以发送全部类型的模板。建议申请“通用”类型的短信模板。
1.3. 常见短信发送失败错误¶
1.短信签名不匹配
错误返回:签名和模板类型不一致(isv.SMS_SIGNATURE_SCENE_ILLEGAL)
错误原因:IDaaS短信网关配置中【短信签名】与在阿里云短信服务中申请的短信签名不匹配
解决方法:修改IDaaS中【短信签名】配置,或在阿里云短信服务中更换模板类型为”通用”类型
2.特殊字符无法发送
错误返回:“params must be [a-zA-Z0-9] for verification sms”(isv.TEMPLATE_PARAMS_ILLEGAL)
错误原因:用户名中有特殊字符或对应模板类型不匹配
解决方法:在IDaaS中去掉特殊字符,或在阿里云短信服务中更换模板类型为”通用”类型
其他错误返回请参考 短信服务错误码