Authen::PluggableCaptcha::Challenge
This is the base class for generating a captcha challenge
captcha challenges must support the following methods
->new( keygenerator_instance=> $keygenerator_instance ); ->validate( user_response=> $user_response ); validate must return : 1 success 0 failure -1 error
there are 3 public methods that must be available to other modules
'instructions'
what a user should do
'user_prompt'
what to prompt the user with
this will be rendered by the render engine
for image/audio this is probably the same as correct_response
'correct_response'
the repsonse
Example:
Image Authen::PluggableCaptcha:
instructions: type in the letters you see
user_prompt: abcdef
correct_response: abcdef
Text Logic Authen::PluggableCaptcha:
instructions: do this math problem
user_prompt: what is 12 divided by 1 ?
correct_response: 12
PARAMS are required name/value pairs. Required PARAMS are:
keymanager_instance TYPE
A reference to an object derived from the Authen::PluggableCaptcha::KeyManager manpage
Note that setters and getters are seperate. Setters should only be called from derived classes. Getters can be called anywhere from perl code.
validate the challege
| returns: | |
| 1 on success | |
| 0 on failure | |
| -1 on error |
This method MUST be overriden in a subclass
set the keymanager instance
get the keymanager instance
set the instructions text
get the instructions text
set the user_prompt text
get the user_prompt text
set the correct_response text
get the correct_response text