Skip to content
Bitzsoft.Integrationsbitzsoft.integrations

Reference

阿里云验证码

阿里云验证码 2.0 包的 AliyunOptions 配置字段、SceneId/AppKey 场景配置与使用示例。

Last updated

包信息

属性
NuGet 包Bitzsoft.Integrations.Captcha.Aliyun
Provider IDaliyun
鉴权AccessKeyId + AccessKeySecret(API 签名)
版本验证码 2.0

配置字段(AliyunOptions)

字段类型必填默认值说明
AccessKeyIdstring阿里云 AccessKey ID
AccessKeySecretstring阿里云 AccessKey Secret
SceneIdstring验证码场景 ID
AppKeystring验证码应用 AppKey(前端 SDK 初始化)
Regionstringcn-hangzhou地域
Endpointstringcaptcha.cn-hangzhou.aliyuncs.com验证码服务端点
ScriptUrlstring阿里 CDN前端 SDK 脚本地址
TimeoutTimeSpan30sHTTP 请求超时
HttpClientNamestringAliyunCaptchaProvider命名 HttpClient

配置示例

{
"Captcha": {
"Aliyun": {
"AccessKeyId": "LTAIxxxxxxxx",
"AccessKeySecret": "your-secret-key",
"SceneId": "your-scene-id",
"AppKey": "your-app-key"
}
}
}

DI 注册

builder.Services.AddBitzsoftAliyunCaptcha(builder.Configuration.GetSection("Captcha:Aliyun"));

使用示例

public class CaptchaService(ICaptchaProvider captcha)
{
public async Task<CaptchaResult<CaptchaChallenge>> GenerateAsync()
{
return await captcha.GenerateAsync(new CaptchaGenerateRequest());
}
public async Task<CaptchaResult<CaptchaVerification>> VerifyAsync(string verifyResult)
{
return await captcha.VerifyAsync(new CaptchaVerifyRequest { VerifyResult = verifyResult });
}
}

已知限制

  • SceneIdAppKey 在阿里云验证码控制台创建场景后获得。
  • AccessKeySecret 用于请求签名,日志中脱敏输出。

相关

100%

滚轮或按钮缩放 · 放大后拖动画面 · 双击切换 100% / 200%