文档中心

AI 原生 BaaS 平台 Supabase 版

使用 Authentication

设置基于火山短信服务的账号注册和登录

本文介绍通过 Supabase 控制台和 Admin API 配置基于火山短信服务的账号注册和登录的操作流程。

前提条件

已创建使用 Supabase 引擎的 Workspace 且 Workspace 的状态为运行中。关于创建 Workspace 的更多详细信息，请参见创建 Workspace。

注意

创建 Supabase 用到的短信模版时，模板变量只支持 ${code}，模板类型必须是 CN_OTP 或 I18N_OTP。参考火山短信服务-SendSmsVerifyCode 中的参数说明。

在 Supabase 控制台查询和修改配置

在 Authentication 页面，单击 Configuration > Sign In / Providers，进入 Sign In / Providers 页面。

在 Phone 的配置页面，打开 Enable Phone provider 开关，并配置火山短信相关参数。主要配置项如下表所示，部分参数含义参见：火山短信服务-SendSmsVerifyCode 接口。

Dashobard 配置项名称	配置项 Key	配置项 Value 类型	是否必填	配置项说明
Enable Phone Provider	EXTERNAL_PHONE_ENABLED	bool	是	是否开启短信注册登录。取值： true：是（开关打开）。 false：否（开关关闭）。
SMS Provider	SMS_PROVIDER	string	是	短信服务提供商。取值 volcsms：火山短信。
VolcSMS Access Key	SMS_VOLCSMS_AK	string	是	火山账号的 AccessKey。
VolcSMS Secret Key	SMS_VOLCSMS_SK	string	是	火山账号的 SecretKey。
VolcSMS Account ID	SMS_VOLCSMS_SMS_ACCOUNT	string	是	火山短信的消息组 ID。
VolcSMS Template ID	SMS_VOLCSMS_TEMPLATE_ID	string	是	火山短信的模板 ID。模板变量只支持 ${code}，模板类型必须是 CN_OTP 或 I18N_OTP。参见火山短信服务-SendSmsVerifyCode 中的参数说明。
VolcSMS Sign	SMS_VOLCSMS_SIGN	string	是	火山短信的签名，参考：火山短信服务-短信签名。
SMS Code Expiration	SMS_VOLCSMS_CODE_EXPIRE	int	是	短信验证码过期时间，单位为秒。
SMS Code Length	SMS_VOLCSMS_CODE_NUM	int	是	短信验证码长度。
Max Verification Attempts	SMS_VOLCSMS_CODE_TRY	int	是	短信验证最大次数。
Enable phone confirmations	SMS_AUTOCONFIRM	bool	是	通过手机号注册时是否无需短信验证。取值： true：无需验证（开关关闭），默认值。 false：需要验证（开关打开）。

通过 Admin API 查询和修改配置

上述参数可以通过 Auth 模块的 Admin API /auth/v1/config 进行查询和修改配置。

示例——通过 Supabase Client SDK 进行手机号注册和登录的示例

最近更新时间：2026.03.30 11:08:50

这个页面对您有帮助吗？

有用

无用