Skip to content
Bitzsoft.Integrationsbitzsoft.integrations

Reference

极验 GeeTest

极验 GeeTest v4 验证码包的 GeetestOptions 配置字段、CaptchaId/CaptchaKey 鉴权与使用示例。

Last updated

包信息

属性
NuGet 包Bitzsoft.Integrations.Captcha.Geetest
Provider IDgeetest
鉴权CaptchaId + CaptchaKey(签名校验)
版本GeeTest v4

配置字段(GeetestOptions)

字段类型必填默认值说明
CaptchaIdstring验证码 CaptchaId
CaptchaKeystring验证码 CaptchaKey(签名密钥)
ApiServerstringgcaptcha4.geetest.comAPI 服务端点(v4)
ScriptUrlstring极验 CDN前端 SDK 脚本地址(gt4.js)
TimeoutTimeSpan30sHTTP 请求超时
HttpClientNamestringGeetestCaptchaProvider命名 HttpClient

配置示例

{
"Captcha": {
"Geetest": {
"CaptchaId": "your-captcha-id",
"CaptchaKey": "your-captcha-key"
}
}
}

DI 注册

builder.Services.AddBitzsoftGeetestCaptcha(builder.Configuration.GetSection("Captcha:Geetest"));

使用示例

public class GeetestService(ICaptchaProvider captcha)
{
public async Task<CaptchaResult<CaptchaChallenge>> GenerateAsync()
{
return await captcha.GenerateAsync(new CaptchaGenerateRequest());
}
public async Task<CaptchaResult<CaptchaVerification>> VerifyAsync(string lotNumber, string captchaOutput, string passToken, string genTime)
{
return await captcha.VerifyAsync(new CaptchaVerifyRequest
{
LotNumber = lotNumber,
CaptchaOutput = captchaOutput,
PassToken = passToken,
GenTime = genTime,
});
}
}

已知限制

  • ApiServer 默认 gcaptcha4.geetest.com(v4 端点),与 v3 的 api.geetest.com 不同。
  • CaptchaKey 用于服务端校验签名,日志中脱敏输出。

相关

100%

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