Byebot - Django Example

A Django application demonstrating Byebot integration.

Installation

pip install -r requirements.txt

Configuration

Edit the values in byebot_demo/settings.py:

BYEBOT_API_KEY = "your-api-key"
BYEBOT_SITE_KEY = "your-site-key"

Usage

python manage.py runserver

Visit http://localhost:8000

How It Works

1. Frontend: The widget is loaded via <script src="https://challenge.byebot.de/ray/widget.js">. A div with class="captcha-widget" and data-sitekey attribute renders the CAPTCHA.

2. Token Submission: On verification, the widget adds a hidden byebot-token field to the form.

3. Server Validation: POST the token to /validate_token:

response = requests.post(
    "https://challenge.byebot.de/validate_token",
    json={"api_key": BYEBOT_API_KEY, "token": token}
)
# 200 OK = valid token

Files

• byebot_demo/settings.py - Django settings with Byebot configuration
• captcha_demo/validators.py - Token validation service
• captcha_demo/views.py - Form handling and CAPTCHA validation
• captcha_demo/templates/captcha_demo/index.html - Login form with CAPTCHA widget
• captcha_demo/templates/captcha_demo/result.html - Success page