Извините, но этот модуль, хотя он и работает отлично, почти полностью не документирован, и его расположение немного запутывает тех из нас, кто предпочитает использовать ">> help (modulename)" после установки. Я приведу пример использования cherrypy и сделаю несколько комментариев, связанных с cgi.
captcha.py содержит две функции и класс:
display_html: возвращает знакомое «поле reCaptcha»
submit: передает значения, введенные пользователем в фоновом режиме
RecapchaResponse: класс контейнера, содержащий ответ от reCaptcha
Сначала вам нужно будет импортировать полный путь к capcha.py, а затем создать пару функций, которые обрабатывают отображение и обработку ответа.
from recaptcha.client import captcha
class Main(object):
@cherrypy.expose
def display_recaptcha(self, *args, **kwargs):
public = "public_key_string_you_got_from_recaptcha"
captcha_html = captcha.displayhtml(
public,
use_ssl=False,
error="Something broke!")
# You'll probably want to add error message handling here if you
# have been redirected from a failed attempt
return """
<form action="validate">
%s
<input type=submit value="Submit Captcha Text" \>
</form>
"""%captcha_html
# send the recaptcha fields for validation
@cherrypy.expose
def validate(self, *args, **kwargs):
# these should be here, in the real world, you'd display a nice error
# then redirect the user to something useful
if not "recaptcha_challenge_field" in kwargs:
return "no recaptcha_challenge_field"
if not "recaptcha_response_field" in kwargs:
return "no recaptcha_response_field"
recaptcha_challenge_field = kwargs["recaptcha_challenge_field"]
recaptcha_response_field = kwargs["recaptcha_response_field"]
# response is just the RecaptchaResponse container class. You'll need
# to check is_valid and error_code
response = captcha.submit(
recaptcha_challenge_field,
recaptcha_response_field,
"private_key_string_you_got_from_recaptcha",
cherrypy.request.headers["Remote-Addr"],)
if response.is_valid:
#redirect to where ever we want to go on success
raise cherrypy.HTTPRedirect("success_page")
if response.error_code:
# this tacks on the error to the redirect, so you can let the
# user knowwhy their submission failed (not handled above,
# but you are smart :-) )
raise cherrypy.HTTPRedirect(
"display_recaptcha?error=%s"%response.error_code)
Это будет примерно то же самое, если вы используете cgi, просто используйте переменную окружения REMOTE_ADDR, где я использовал cherry.quest заголовков request.headers и используйте хранилище полей для ваших проверок.
Магии нет, модуль просто следует документам:
https://developers.google.com/recaptcha/docs/display
Ошибки валидации, которые могут вам понадобиться:
https://developers.google.com/recaptcha/docs/verify