Digipass Plug-In for SBR Administrator Reference - Vasco

Digipass Plug-In for SBR Administrator Reference Web Sites
9.5 Query String Variables
The query string variables that are passed to the web pages by the CGI program are mainly
concerned with status and error reporting. There is also a variable that is used to pass a
challenge to the pages that display one.
9.5.1 Failure/Error Handling
There are three main groups of failures that can occur, which should be handled in a different
manner. In all cases there is a numeric error code, however in some cases there is an auxiliary
code and message such as the return code and message from the VACMAN Controller. The
main error codes will be assigned in three separate ranges, so that the web pages can identify
which category of error is returned.
API return codes – these are returned by the VASCO API used to make the
authentication request to the Server. In some cases there will be an auxiliary code and
message.
CGI errors – these errors are detected by the CGI program, mainly when the web pages
are not providing or enforcing the posted form fields correctly. These will not generally
have an auxiliary code and message, but it is possible.
Internal errors – these are technical errors that ‘should not occur’. In some cases there
will be an auxiliary code and message.
The intention of using this code-based scheme is to allow translation and customization of the
messages. The main error code will be translated into a message by the web pages
themselves. The pages can also translate the auxiliary code into a message, for the VACMAN
Controller codes, but normally, the pages would not know how to translate it into a message,
and should display the auxiliary message as provided.
© 2006 VASCO Data Security Inc. 110