Authentication Settings

This page documents the Authentication Settings in FormMail.

Type Of Setting

Authentication Settings are OPTIONAL settings, which means...

Précis

Sets authentication requirements for multi-page form processing.

Description

When FormMail returns to a form for the user in a multi-page form sequence, it opens a URL to read in the form. This means your server is opening a URL to itself.

If your form requires authentication, you need FormMail to be able to authenticate with the server to open the URL.

From version 7.05, FormMail attempts to provide the authentication information automatically.

If this doesn't work on your site or you want to provide a separate authentication for FormMail, put the authentication information in these settings.

The three possible authentication settings are:

• AUTHENTICATE
• AUTH_USER
• AUTH_PW

You can use AUTHENTICATE by itself, or AUTH_USER and AUTH_PW instead.

AUTHENTICATE is placed as the value of the "Authorization:" header of the HTTP request. For example:

Basic cnVzc2VsbHI6dGVzdA==

The second value is the Base-64 encoded user name and password separated by ":". (The above value is: "russellr:test".)

If this is inconvenient for you (for example, you might not know how to generate a Base-64 encoding), leave AUTHENTICATE empty and set AUTH_USER and AUTH_PW as normal strings (e.g. "russellr" and "test").

When using $AUTH_USER and $AUTH_PW FormMail will automatically specify "Basic" authentication.

Note: the authentication configuration is similar to that in FMBadHandler, but in FormMail the configuration is only used in multi-page form processing.

Default Value

$AUTHENTICATE = "";
$AUTH_USER = "";
$AUTH_PWD = "";

$AUTHENTICATE = "Basic cnVzc2VsbHI6dGVzdA==";
$AUTH_USER = "";
$AUTH_PWD = "";

$AUTHENTICATE = "";
$AUTH_USER = "russellr";
$AUTH_PW = "test";