MULTIFORMURL

Index

FORM_INI_FILE

This page documents the Authentication Settings in FormMail.

Authentication Settings are OPTIONAL settings, which means...

OPTIONAL

you can change these settings if you need to, but the default values are fine for most circumstances.

Sets authentication requirements for multi-page form processing.

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 user 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:

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.

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

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

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

MULTIFORMURL

Index

FORM_INI_FILE