django-recaptcha429 2.1.0

需求

测试与

• Python: 3.7, 3.8, 3.9, 3.10

• Django: 2.2, 3.2, 4.0

• 您可以在Python-Django支持矩阵中查看

安装

1. 注册reCAPTCHA.

2. 使用pip install django-recaptcha429安装。

3. 将'captcha'添加到您的INSTALLED_APPS设置中。

   INSTALLED_APPS = [
       ...,
       'captcha',
       ...
   ]

4. 将步骤1中生成的Google reCAPTCHA密钥添加到您的Django生产设置中，使用RECAPTCHA_PUBLIC_KEY和RECAPTCHA_PRIVATE_KEY。请注意，省略这些设置将默认使用一组测试密钥，更多信息请参考本地开发和功能测试。

   例如：

   RECAPTCHA_PUBLIC_KEY = 'MyRecaptchaKey123'
   RECAPTCHA_PRIVATE_KEY = 'MyRecaptchaPrivateKey456'

   这些也可以通过传递public_key或private_key参数到ReCaptchaField来针对每个字段进行指定 - 请参阅以下字段使用说明。

5. （可选）如果您需要代理，请添加一个RECAPTCHA_PROXY设置（代理字典），例如：

   RECAPTCHA_PROXY = {'http': 'http://127.0.0.1:8000', 'https': 'https://127.0.0.1:8000'}

6. （可选）如果无法访问www.google.com，则可以将RECAPTCHA_DOMAIN设置更改为www.recaptcha.net，详情请参考reCAPTCHA FAQ

   RECAPTCHA_DOMAIN = 'www.recaptcha.net'

这将更改Google JavaScript API域名以及客户端字段验证域名。

使用

from django import forms
from captcha.fields import ReCaptchaField

class FormWithCaptcha(forms.Form):
    captcha = ReCaptchaField()

captcha = ReCaptchaField(
    public_key='76wtgdfsjhsydt7r5FFGFhgsdfytd656sad75fgh',
    private_key='98dfg6df7g56df6gdfgdfg65JHJH656565GFGFGs',
)

from django import forms
from captcha.fields import ReCaptchaField
from captcha.widgets import ReCaptchaV2Invisible

class FormWithCaptcha(forms.Form):
    captcha = ReCaptchaField(widget=ReCaptchaV2Invisible)

captcha = fields.ReCaptchaField(
    widget=widgets.ReCaptchaV2Checkbox(
        attrs={
            'data-theme': 'dark',
            'data-size': 'compact',
        }
    )
)
# The ReCaptchaV2Invisible widget
# ignores the "data-size" attribute in favor of 'data-size="invisible"'

captcha = fields.ReCaptchaField(
    widget=widgets.ReCaptchaV2Checkbox(
        api_params={'hl': 'cl', 'onload': 'onLoadFunc'}
    )
)
# The dictionary is urlencoded and appended to the reCAPTCHA api url.

致谢

当前维护者是 Andrew Chen Wang

最初由 Praekelt Consulting 开发

灵感来自 Marco Fucci 的博客文章 Integrating reCAPTCHA with Django

client.py 来自 recaptcha-client，由 Mike Crawford 以 MIT/X11 许可

reCAPTCHA 版权 2012 Google。

当前维护者

• Andrew Chen Wang

Praekelt Consulting

• Shaun Sephton

• Peter Pistorius

• Hedley Roos

• Altus Barry

• Cilliers Blignaut

bTaylor Design

• Brandon Taylor

其他

• Brooks Travis

• Denis Mishchishin

• Joshua Peper

• Rodrigo Primo

• snnwolf

• Adriano Orioli

• cdvv7788

• Daniel Gatis Carrazzoni

• pbf

• Alexey Subbotin

• Sean Stewart

• Rob Charlwood

2.1.0

1. 添加了对 Django 3.2 和 4.0 的测试

2. 移除了对 Django 1.11 和 Python 2 的支持

3. 移除了 Django 依赖项的上限约束

2.0.6

1. 添加了对 Django 3 的测试（无需代码更改）。

2.0.5

1. 添加了设置和 kwargs，允许验证 reCAPTCHA v3 分数值。

2.0.4

1. 修复了 django 2.2 的 travis 测试

2.0.3

1. 添加了对 Django 2.2 的测试（无需代码更改）。

2.0.2

1. 将基于字段的 Google 开发者密钥检查移动到应用就绪注册的安全检查。

2.0.1

1. 错误修正：从 widget_v3 模板中删除额外的 div

2.0.0

1. 添加了 reCAPTCHA v3 支持。

2. 删除了对 V1 reCAPTCHA 端点的所有提及。

3. 重构了客户端、字段和小部件代码。

4. 为每种类型的 reCAPTCHA 添加了小部件：V2 复选框、V2 无视、V3

5. 无需根据某些设置值选择小部件模板，每个小部件都有自己的模板。

6. 引入了大量新的单元测试，更新测试以利用 tox venvs。

7. 重新生成 po 和 mo 文件。

1.5.0 (2019-01-09)

1. 添加了对 Django 2.1 的测试（无需代码更改）。

2. 更新单元测试，不再使用 reCAPTCHA v1。

3. 为 reCAPTCHA v1 支持添加了弃用警告。

4. 在单元测试期间无需使用 RECAPTCHA_TESTING 环境变量。

5. 添加了对 Invisible reCAPTCHA V2 的支持。

1.4.0 (2018-02-08)

1. 放弃了对 Django < 1.11 的支持。

2. 添加了对 Django 2.0 的测试（无需代码更改）。

1.3.1 (2017-06-27)

1. 修复了 Django < 1.10 的小部件属性回归问题。

1.3.0 (2017-04-10)

1. 支持 Django 1.11，以及 1.8、1.9 和 1.10。

1.2.1 (2017-01-23)

1. 将reCAPTCHA测试密钥设置为默认密钥，便于开发中使用。验证码不需要任何交互，有一个警告标签说明仅用于测试目的，并且始终验证。

1.2.0 (2016-12-19)

1. 在默认模板中将选项作为HTML数据属性传递，而不是RecaptchaOptions JavaScript对象。使用RecaptchaOptions的自定义模板应迁移到使用HTML数据属性。

1.1.0 (2016-10-28)

1. 停止支持旧版本的Django。现在只支持上游支持的版本，目前为1.8、1.9和1.10。

2. 默认情况下，使recaptcha检查使用SSL。您可以通过在Django设置中设置RECAPTCHA_USE_SSL = False或传递use_ssl=False到ReCaptchaField构造函数来禁用此功能。

3. 使ReCaptchaField尊重required=False

1.0.6 (2016-10-05)

1. 已确认在Django 1.10上通过测试。旧版本应该仍然工作。

2. 修复了由于attrs是一个可变默认参数而导致的小部件始终以第一个使用语言渲染的bug。

1.0.5 (2016-01-04)

1. 中文翻译（kz26）。

2. 语法修复（zvin）。

3. 在Django 1.9上通过测试。

1.0.4 (2015-04-16)

1. 修复了Python 3支持。

2. 添加了波兰语翻译。

3. 更新文档。

1.0.3 (2015-01-13)

1. 添加了无验证码的reCAPTCHA支持。

1.0.2 (2014-09-16)

1. 修复了俄语翻译。

2. 添加了西班牙语翻译。

1.0.1 (2014-09-11)

1. 添加了对Django 1.7的支持。

2. 添加了俄语翻译。

3. 添加了多依赖支持。

4. 清理。

1.0 (2014-04-23)

1. 添加了Python 3支持。

2. 添加了法语、荷兰语和巴西葡萄牙语翻译。

0.0.9 (2014-02-14)

1. 修复：发布master而不是develop。这应该可以解决由于master曾是GitHub上的默认分支而造成的混淆。

0.0.8 (2014-02-13)

1. 修复：删除对options.html的引用。

0.0.7 (2014-02-12)

1. 通过ajax加载小部件成为可能。

0.0.6 (2013-01-31)

1. 添加了额外的参数lang以绕过Google的语言bug。请参阅http://code.google.com/p/recaptcha/issues/detail?id=133#c3

2. widget.html不再包含options.html。选项直接添加到widget.html中。

0.0.5 (2013-01-17)

1. 删除了django-registration依赖。

2. 将测试机制更改为环境变量RECAPTCHA_TESTING。

0.0.4

1. 处理缺失的REMOTE_ADDR请求元键。感谢Joe Jasinski。

2. 添加了对settings.DEBUG的检查，以方便测试。感谢Victor Neo。

3. 修复了在没有javascript的情况下正确iframe URL的bug。感谢gerdemb。

0.0.3 (2011-09-20)

1. 感谢kshileev，不强制注册版本。

2. 使用模板渲染小部件，感谢denz。

0.0.2 (2011-08-10)

1. 在验证时使用远程IP。

2. 添加了SSL支持，感谢Brooks Travis。

3. 添加了对JavaScript reCAPTCHA小部件选项的支持，感谢Brandon Taylor。

4. 允许在运行时指定密钥和ssl，感谢Evgeny Fadeev。

0.0.1 (2010-06-17)

1. 初始发布。