Online Help Center

Web User Authentication (WUA) is a web-based authentication system that protects your DataPages from unauthorized users.  Users of protected DataPages must login with an appropriate username and password in order to work with them.  

Caspio Bridge enables you to setup WUA quickly and without programming.

The WUA option is applied to DataPage folders.  Once it is configured, it applies to all the DataPages of that folder.  Each WUA can have an unlimited number of users.

Once a user logs into a DataPage, other DataPages protected by the same WUA are available to her without requiring another login.  The authenticated session ends when the user closes her browser or logs out.

Setting Up Web User Authentication

To set up Web User Authentication:

1. Designate a table or view where user authentication information (i.e. usernames and passwords) is found.  Create or import a table or view of the information if necessary.
2. Designate a DataPage folder for which you intend to setup Web User Authentication.  Create a DataPage folder if necessary.
3. In the DataPages view open your designated DataPage folder. 
4. Click the Authentication button to bring up the Authentication Wizard.

1. Setup Options

Check the Enable Authentication option.

Select your designated users table or view from the list.

Choose one of the authentication setup options:

• With Express authentication, the login form uses two specific fields for authentication: 'Username' and 'Password'. Select the desired username and password field from the list.
• With Custom authentication you can configure one, two, or more fields for authentication, define the layout of the login form, and edit the error message displayed to users who fail to login properly.

To allow automatic focus of cursor on the first field of the login form, check the Automatically focus cursor on first field option.

Advanced Options

If using Custom authentication, check Enable advanced options to access field layout options and set up external associations and defaults.

Click Next.

2. Select Fields

This step is skipped if you chose Express authentication.

Select the desired fields from your table or view for the login form. Only Text, AutoNumber and Number fields are listed.

Click Next.

3. Configure Fields

This step is skipped if you chose Express authentication.

The fields you selected are listed on the left. Select each field, one at a time, and configure its properties on the right.

• Fields in Password Recovery DataPages can only be displayed as Text Fields or Display Only.
• The Case sensitive option must be checked for fields that require exact case match.

Click the Insert button  to add a section, a virtual field, an HTML block, CAPTCHA or header and footer.

Use the Up and Down buttons to change the display order of the sections, fields and blocks.

Advanced Options

Click the Advanced tab to configure the following:

Layout Options

• By default, every form field starts on a new line. Check Continue next element on same line to avoid this behavior.
• The Label Position radio buttons are useful when you want to override the section's label position for this particular field.

External Associations and Defaults

• By default, form fields are blank on load. You can either Assign a static value to provide a default value for the field or Receive parameter from another DataPage or from an external application.
• On exit, the form can Pass field value to next page as a parameter.

Click Next.

4. Failure Message

This step is skipped if you chose Express authentication.

Modify the authentication failure message if necessary.

The Show login form on failure page option is checked by default. It displays the fields selected for authentication on the page that displays the failure message. Deselecting this option will prevent the user from seeing the login form and only display authentication failure message.

Advanced Options

Use the Insert button to insert field values submitted through the form into failure message. Each field can be formatted as described under Advanced Options here.

5. Logout

Choose what page should be displayed to users after they log out:

• The original Login form.
• A different web page. Specify the URL of the page you wish to display.
• Another DataPage.

Advanced Options

You can set how long it takes for users to be automatically logged out by selecting a time under Timeout after.

Check the Enable auto-login across apps so that users only need to login once to access any of your Caspio Bridge applications that share the same authentication table.

Check the Authenticated DataPages will be deployed with SSL encryption option if you plan to use the SSL (Secure Socket Layer) security option for your DataPages. The field below contains the logout URL. Copy this URL and relate it to an image or block of text on the destination web page as an anchor link.

Click Finish.

6. Finish

A confirmation message that the authentication is saved is displayed.

To de-activate authentication on a DataPage folder, open the folder, click the Authentication button, deselect the Enable Authentication option and click Finish.  Note that removing authentication disables any DataPage that relies on Record Level Security.