README

提供对 TYPO3 EXT:form 的 hCaptcha 集成。

hCaptcha 是一个免费使用的 Google reCaptcha 的替代方案，更注重隐私。它支持诸如 PrivacyPass 等倡议。

更多信息，请参阅 hCaptcha 网站。

此外，hCaptcha 为解决的验证码提供收益 - 可以自动捐赠给维基媒体基金会（这是此扩展默认设置的情况）。

快速设置

hCaptcha 使用默认密钥进行配置，以使设置尽可能简单。建议为您的站点在 hCaptcha 中创建一个自定义账户，并添加您自己的密钥。

• 安装扩展并激活它
• 在 TypoScript 中包含静态模板
• 将 hCaptcha 元素添加到表单中

TypoScript 常量

如果您使用自己的账户，请设置以下常量

plugin.tx_hcaptcha {
  settings {
    publicKey = <your-public-key>
    privateKey = <your-private-key>
  }
}

环境变量

作为 TypoScript 配置的替代，您还可以使用环境变量

• HCAPTCHA_PUBLIC_KEY
• HCAPTCHA_PRIVATE_KEY

内容安全策略

如果您使用 CSP，请确保相应地调整它们

• script-src 应包括 https://hcaptcha.com, https://*.hcaptcha.com
• frame-src 应包括 https://hcaptcha.com, https://*.hcaptcha.com
• style-src 应包括 https://hcaptcha.com, https://*

隐私

请确保您的用户了解您使用 hCaptcha 的方式以及这意味着什么 - 尤其如果您使用的是不可见的 Enterprise 版本。

更多信息请参阅： https://docs.hcaptcha.com/faq

帮助与支持

• 问题： https://gitlab.com/susannemoog/hcaptcha/-/issues
• Slack: #typo3-cms

关注我 Twitter 或阅读 我在 susi.dev 关于 hCaptcha 的博客文章。