Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Are You a Human (AYAH) Python integration library and CAPTCHA alternative

Project Description

SUMMARY

Copyright (c) 2011 AYAH LLC http://www.areyouahuman.com

BY USING THIS SOFTWARE YOU AGREE TO THE TERMS AND CONDITIONS FOUND AT: http://portal.areyouahuman.com/termsAndConditions

INSTALLATION

The AYAH Python Integration Library is compatible with Python 2.x and 3.x. (It was built and tested on versions 2.7.x and 3.2.x.) Python 3.x requires an extra installation step as described below.

Python 2.x Installation:

  1. Download and extract the appropriate source distribution for your OS.

  2. Install the package:

    python setup.py install
    

Python 3.x Installation:

  1. Download and extract the appropriate source distribution for your OS.

  2. Convert the package to Python 3.x:

    2to3 -wn ./ayah
    
  3. Install the package:

    python3 setup.py install
    

INTEGRATION

The AYAH Python Integration Library is compatible with all web application frameworks.

  1. Get your publisher key and scoring key from https://portal.areyouahuman.com/.

  2. Import the ayah module:

    import ayah
    
  3. Configure the ayah module when your application initializes:

    ayah.configure(<your-publisher-key>, <your-scoring-key>)
    
  4. Display the AYAH HTML on any page that requires a human:

    html = ayah.get_publisher_html()
    

    Django: you can pass this HTML to the view through the context or simply call get_publisher_html() in the template.

  5. Allow the alleged human to complete the PlayThru challenge. When they’re finished, your web page will have a hidden field on it with id=”session_secret”.

  6. Use the value of the hidden session secret field to determine if the alleged human passed the challenge:

    passed = ayah.score_result(<session-secret>)
    

    Django: the hidden field will be available in your form object:

    if request.method == 'POST':
        form = LoginForm(request.POST)
        if form.is_valid():
            secret = form.cleaned_data['session_secret']
            passed = ayah.score_result(secret)
            # Redirect...
    
  7. If you’d like to record a conversion with our system, a special bit of HTML will need to be embedded in your ‘conversion’ page. To get that HTML, call the following method:

    html = ayah.record_conversion(<session-secret>)

Congratulations, your application detects humans without requiring CAPTCHA!

Release History

Release History

This version
History Node

1.0.5

History Node

1.0.4

History Node

1.0.3

History Node

1.0.2

History Node

1.0.1

History Node

1.0.0

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
are-you-a-human-1.0.5.tar.gz (5.9 kB) Copy SHA256 Checksum SHA256 Source Mar 22, 2012
are-you-a-human-1.0.5.zip (7.8 kB) Copy SHA256 Checksum SHA256 Source Mar 22, 2012

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting