基于Java8、Grails2.4.3的Google reCAPTCHA企业版实现方案咨询

针对你的技术栈（Java 8、Grails 2.4.3、Spring+Hibernate），现有插件不支持企业版reCAPTCHA，推荐以下两种可行方案：

方案一：手动集成企业版API（最稳妥，无需依赖第三方插件） #

前端实现步骤 #

1. 替换原有普通版reCAPTCHA脚本，加载企业版脚本：

   <script src="https://www.google.com/recaptcha/enterprise.js?render=YOUR_ENTERPRISE_SITE_KEY"></script>
   

2. 在表单中添加验证容器（或使用隐式渲染）：

   <div class="g-recaptcha" data-sitekey="YOUR_ENTERPRISE_SITE_KEY" data-action="login"></div>
   

   或者通过JS手动触发验证，获取token后随表单提交：

   grecaptcha.enterprise.execute('YOUR_ENTERPRISE_SITE_KEY', {action: 'login'}).then(function(token) {
       document.getElementById('recaptchaToken').value = token;
   });
   

后端验证逻辑 #

1. 创建Grails服务类封装验证逻辑，比如RecaptchaEnterpriseService：

   class RecaptchaEnterpriseService {
       def verifyToken(String token, String action, String siteKey, String secretKey, String projectId) {
           def url = "https://recaptchaenterprise.googleapis.com/v1/projects/${projectId}/assessments?key=${secretKey}"
           def body = [
               event: [
                   token: token,
                   siteKey: siteKey,
                   expectedAction: action
               ]
           ]
           // 使用Grails自带的HTTP工具发送POST请求
           def connection = new URL(url).openConnection() as HttpURLConnection
           connection.requestMethod = 'POST'
           connection.setRequestProperty('Content-Type', 'application/json')
           connection.doOutput = true
           connection.outputStream.withWriter { writer ->
               writer.write(new groovy.json.JsonBuilder(body).toString())
           }
           def response = new groovy.json.JsonSlurper().parse(connection.inputStream)
           // 解析响应，验证score和token有效性
           return response?.riskAnalysis?.score >= 0.7 && response?.tokenProperties?.valid
       }
   }
   

2. 在控制器中调用服务验证：

   class UserController {
       def recaptchaEnterpriseService
   
       def login() {
           def token = params.recaptchaToken
           def isValid = recaptchaEnterpriseService.verifyToken(
               token, 
               'login', 
               grailsApplication.config.recaptcha.enterprise.siteKey, 
               grailsApplication.config.recaptcha.enterprise.secretKey,
               grailsApplication.config.recaptcha.enterprise.projectId
           )
           if (!isValid) {
               flash.error = "验证失败，请重试"
               redirect(action: 'login')
               return
           }
           // 继续业务逻辑
       }
   }
   

方案二：改造现有reCAPTCHA插件 #

如果不想完全重写，可以基于现有iamthechad/recaptcha插件修改：

• 替换插件中验证API的URL为企业版地址（https://recaptchaenterprise.googleapis.com/v1/projects/[PROJECT_ID]/assessments）
• 调整请求参数结构，添加projectId、expectedAction等企业版必填字段
• 修改响应解析逻辑，适配企业版返回的riskAnalysis.score、tokenProperties.valid等字段
• 将修改后的插件打包为本地JAR，替换项目中原有插件依赖

关键注意事项 #

• 需在Google Cloud控制台启用reCAPTCHA Enterprise API，生成专属的site key、secret key和project ID
• Java 8环境下确保HTTPS请求正常，可添加必要的信任证书
• 处理API调用异常（如网络超时、无效参数），避免影响业务流程
• 可根据业务需求调整score阈值（通常0.5-0.8作为区分正常/异常请求的标准）

内容的提问来源于stack exchange，提问作者tyro