Administration Guide

Web App Settings

On this page

Each Web App instance has its own settings pages in the Admin Center, under Apps and Portals > Web App. The page lists the configured Web App instances; when only one instance exists, the menu goes straight to that instance's tabs.

Before you begin

  • Your account needs the Web App configuration right. The Self Service Portal and API instance families each have a configuration right of their own. See Permissions Reference.
  • The instance tabs appear only when a Web App instance is configured. When none is, the page shows a title, a description line and a sentence that links to the installation guide, in place of the instance's tabs. See Install the Web App.

In the Admin Center

A Web App instance has these tabs: General, Logo, Color Theme, Authentication and Application Gateway. Authentication is hidden for an instance that uses Windows authentication.

General tab

The General tab has the same shape for Web App, Self Service Portal and API instances.

  • Name - "This name is for your reference only and will not be visible to users."
  • URL - "Review the auto-generated URL. Enter the correct address manually if needed." The button beside the field opens the address in a new tab; it is disabled while the field is empty.
  • System macro - a read-only field, "Used to generate direct links in workflow notifications." It appears only when the loaded URL and the system macro differ by more than a trailing slash, with the alert "System macro differs from URL" and two buttons: Update system macro with instance URL and Update instance URL with system macro. Each button sets both fields to the one value.
  • When the instance has not been used for more than 7 days, the tab shows "This instance has been inactive for over 7 days and appears to no longer exist." beside Delete. After you confirm "Delete instance?", the instance's settings are deleted.

When you save the General tab, the Admin Center checks that a Web App answers at the URL you typed. If none answers within five seconds, a dialog titled "Web App not found" asks "No Web App instance was found at this address. Save this URL anyway?". Save anyway saves the URL; Cancel does not. The API instance's General tab makes the same check; the Self Service Portal's does not.

Logo tab

The Logo tab reads "Specify the logo image that will appear at the top of Web pages. You can use the default Alloy Software logo image or load a custom image." It holds one image field, with the note "Supported formats: PNG, JPG, BMP, SVG. The logo area is 50 pixels high; larger images will be scaled down, keeping the aspect ratio." The field has no Restore button. The Web App shows this image at the left end of its header.

Once you change the image, the action bar above Save and Cancel shows "Changes will take effect within an hour after saving." and "Users can perform a hard refresh in their browser (e.g., Ctrl+F5) to see the changes immediately."

Color Theme tab

The Color Theme tab reads "Choose a color theme to customize the look and feel of the Web App." It offers ten color themes: Ocean Blue, Sky Blue, Cyber Grape, Violet Iris, Bordeaux Red, Jungle Green, Dark Slate Green, Slate Gray, Dark Gray and Sand Cream. Selecting one shows that theme's own preview image.

The tab shows the same notice as the Logo tab: changes take effect within an hour after saving, and users can hard-refresh their browser to see them immediately.

Authentication tab

The Authentication tab is hidden for an instance that uses Windows authentication. Its settings take effect only after the Web App restarts, so the tab saves with Save and Restart.

IMPORTANT: Saving these settings restarts the Web App instance, closes active connections, and can cause users to lose unsaved data.

  1. Under Password Authentication, select or clear Allow password authentication.
  2. To limit failed sign-ins, select Enable failed sign-in attempt limit (brute-force protection) and enter the number of attempts, the number of minutes they count within, and the number of minutes sign-in stays locked. Each value is a whole number of at least 1.
    • The check box is available only while Allow password authentication is selected, and the three numbers only while both check boxes are selected.
    • When no limit has been saved yet, the check box starts cleared, with 5 attempts within 1 minute and a 5-minute lock.
  3. Under SSO Authentication, Available Single Sign-On services: lists each configured single sign-on provider as a check box, sorted by name. Select or clear each provider. When no provider is configured, the section reads "No services configured." with Add SSO providers. See Authentication Methods.
  4. Click Save and Restart. The button is available only when Allow password authentication or at least one provider is selected. After a successful save, the Web App instance restarts.

When the failed attempts within the time window reach the limit, the Web App disables its sign-in button and refuses further attempts until the lock expires. A successful sign-in clears the count.

NOTE: The failed-sign-in limit counts attempts per browser session, not per account. The count is held by the web application itself, so it does not survive an application-pool recycle and is not shared between web servers. It guards the password sign-in form only; single sign-on does not use it.

Application Gateway tab

The Application Gateway tab reads "If this application is deployed behind a proxy or load balancer, please provide the host header." It has one field, Host Header. The tab uses the same within-an-hour notice with the hard-refresh sentence.

The Self Service Portal and API instances have the same Application Gateway tab, with the same single field.