Blog available for sell
This blog is available for sale. Please 'contact us' if interested.
Advertise with us
security captcha   0   24197
How to use Google reCAPTCHA in Django

Using Google reCAPTCHA in Django forms is one of the best way to prevent DOS attack in your Django application. Although you may deploy other measures like blocking user after 3 unsuccessful attempts or blocking the IP address but I think reCAPTCHA is one of the most widely used method to stop bots from attacking your login/sign-in page.

In this article we will see how to use Google reCAPTCHA in Django forms.

Using Google reCAPTCHA in Django Forms:

First of all we need to get reCAPTCHA API keys from Google. Go to and add your application for recaptcha.

how to use google recaptcha in django For demo purpose I am adding '' application. If you want to test your application with reCAPTCHA on your system in development environment, add localhost to the domain list.

how to use google recaptcha in django

After registering, site key and secret key will be generated.

how to use google recaptcha in django

Using reCAPTCHA keys in Django code:

In your html file, create a login form.

Add <div class="g-recaptcha" data-sitekey="XXeZ2XXAAXAAKrOXXXZ1fXDwXXX7xKgXXMAFYXX"></div> inside your form.

<form action="{{url}}" method="post">
    {% csrf_token %}
    <input type="email" placeholder="email">
    <input type="password" placeholder="password">
    <div class="g-recaptcha" data-sitekey="XXeZ2XXAAXAAKrOXXXZ1fXDwXXX7xKgXXMAFYXX"></div>
    <input type="submit" value="login">

Now inside ModelForm class of above form, use clean method to validate the reCAPTCHA.

def clean(self):
        ca = self.request.POST["g-recaptcha-response"]
        url = ""
        params = {
            'secret': config.RECAPTCHA_SECRET_KEY,
            'response': ca,
            'remoteip': utility.get_client_ip(self.request)
        verify_rs = requests.get(url, params=params, verify=True)
        verify_rs = verify_rs.json()
        status = verify_rs.get("success", False)
        if not status:
            raise forms.ValidationError(
                _('Captcha Validation Failed.'),

I have stored the RECAPTCHA_SECRET_KEY in a separate config file and imported the config file in ModelForm file.

It is always recommended to store all secret keys and credentials in separate config file and do not commit this file to version control system (git).

In the above code you can see we are fetching captcha value from request.POST.  To access the request object in ModelForm, define below method in your ModelForm class.

def __init__(self, *args, **kwargs):
        self.request = kwargs.pop('request', None)
        super(MyModelForm, self).__init__(*args, **kwargs)

Now when using this ModelForm class in your view code, use below code.

post_data = request.POST
form = MyModelForm(post_data,request=request)

I have created a separate utility class to keep some utility functions there. get_client_ip is one such function.

We need to import both, config and utility in this file.

Code to get client's IP address:

def get_client_ip(request):
    x_forwarded_for = request.META.get('HTTP_X_FORWARDED_FOR')
    if x_forwarded_for:
        ip = x_forwarded_for.split(',')[0]
        ip = request.META.get('REMOTE_ADDR')
    return ip

So in above code, we collect recaptch value from request and send it to Google along with client's IP address.

Google return the response which is converted to JSON object and verified if success is returned.

If validation fails, we raise form validation error.


Google reCAPTCHA:

Robot beating Google in 'I am not a robot' test:

security captcha   0   24197
0 comments on 'How To Use Google Recaptcha In Django'
Login to comment

Related Articles:
How to validate an uploaded image in Python Django
Validating image before storing it in database or on file storage. Checking the size of uploaded image in python django. Checking the extension of uploaded image in python django. Checking the content size of uploaded image. Checking the mime-type of uploaded Image. Validating a malicious image before saving it. Using python-magic package...
Implementing 2FA in Python Django using Time-Based one-time password (TOTP)
Implementing 2FA in Django using Time-based one time password, Enhancing application security using 2FA and TOTP, Generating QR code for Authenticator Applications, Time based 6 digit token for enhanced security, Python code to generate TOTP every 30 seconds, HMAC, TOTP, Django, 2FA, QR Code, Authenticator, Security, Token, Login,...
Preventing cross-site scripting attack on your Django website
XSS attack in Django, preventing cross-site scripting attack in Django website, avoid XSS in Django application, Enabling SECURE_BROWSER_XSS_FILTER in Django website, blocking cross-site scripting attach on Django website...
Encryption-Decryption in Python Django
How to encrypt and decrypt the content in Django, Encrypting the critical information in Django App, Encrypting username, email and password in Django, Django security...
DigitalOcean Referral Badge

© 2022-2023 Python Circle   Contact   Sponsor   Archive   Sitemap