Configuring the Web App

Updated in 2024.2

You configure the Web App using the Web Configuration tool. By default, if you left the Run the Web Configuration check box selected on the Completed page of the Setup Wizard, the manager starts after you complete the installation.

You can launch the Web Configuration tool from the Alloy Control Panel or using the Start menu.

INFO: For details, see Using the Alloy Control Panel.

NOTE: After you complete the initial configuration, you can always use the Web Configuration tool to modify your configuration. For details about available settings, see Pre-configuration considerations.

To configure the Web App:

1. On the main menu of the Web Configuration tool, click File > Create > Web App. This step applies only if you cleared the Run the Web Configuration check box in the last step of the installation procedure on the Completed page of the Setup Wizard.

2. On the Database page, specify the Database Access key that the Web App will use to connect to your database.

   1. Click Import Key and import the Database Access Key. This populates the SQL Server and Database fields with the values from the imported key.

      INFO: For details, see Importing the Database Access Key and Distributing the Database Access Key.

   2. Fine-tune the database connection details, if needed: in the SQL Server field, enter the network address of the SQL Server, which may differ from the SQL Server name specified in the Database Access Key.

   Click Next.

3. On the Web page, type a description of your web application. This description will help you and other administrators identify this Web App instance on the IIS server.

   Click Next.

4. On the Installation Type page, specify where to install the Web App:

   • If you want to install the web application as a web site, i.e. to the root directory of a web site, click Install as a web site.

   • If you want to install the web application to a virtual directory on a web site, click Install into a virtual directory.

     INFO: For instructions, see Choosing the Installation Type (Web App).

   Click Next.

5. On the Web Site page, all web sites available on the IIS server are displayed. Choose the site where you want to install the Web App. If you are installing the web application as a web site, you can specify parameters for the new site. Click Next.

   • If you are installing the web application into a virtual directory, the Virtual Directory page opens. Proceed to the step describing the Virtual Directory page.

   • If you are installing the web application as a site, the User Authentication Type page opens. Proceed to the step describing the User Authentication Type page.

6. On the Virtual Directory page, type the name of the virtual directory to create, or select an existing directory from the list.

   NOTE: The virtual directory name will become a part of the URL you will be using to access the Web App. For example, if your server's host name is "www.example.com," specifying "wp" as the Virtual Directory Name will result in the following URL: https://www.example.com/wp/.

   Click Next.

7. On the Authentication Method page, choose the authentication type for Web App users:

   • To use Windows authentication, click Windows Authentication.

   • To use standard (password) or single sign-on authentication, or leverage LDAP authentication, click Standard Authentication.

     INFO: For details about authentication types, see Choosing Authentication Method.

   Click Next.

8. On the Workflow Integration page, you can specify the URL address for the Web Portal Link macro. This macro is used in workflow notifications to generate direct links to objects.

   INFO: For details, see Customizing the Web Portal Link Macro.

   The Web Configuration tool detects the URL address automatically and suggests to use this value by default. To replace the auto-detected URL with your custom value, click Replace the macro’s value with a custom URL and type in your custom URL address.

   TIP: Applying the suggested URL is the best choice when the web application is to be accessed only over the local network. When the web application will be accessed over the Internet, you may need to type in the real URL manually. Keep in mind that you can skip this step, complete the configuration, and then run the Web Configuration tool again to replace the macro contents with the real URL.

   Click Next.

9. On the Ready to Apply Settings page, review your settings. To make changes, click Previous to return to the relevant page or pages. When you have finished, click Apply. Wait for the Web Configuration tool to configure the web application.

10. When completed, the Web Configuration tool displays a summary of applied settings. If any errors occurred, a There are some errors logged message will appear under Error Logs, and you can view them by clicking View Details.

    NOTE: After you complete the initial configuration, you can always use the Web Configuration tool to modify any settings.

Your Web App instance is now configured with the default settings and ready to use. To customize it (for example, apply your company logo), use the web-based Admin Center, available in the Web App. Sign in to the Web App with an administrator's account, navigate to Admin Center, and go to Apps and Portals > Web App.

TIP: You can also quickly access the Admin Center directly from the Web Configuration tool. In the navigation tree on the left, locate your Web App instance (the default location is the "wp" instance under "Alloy Navigator Site"). Find "admin-enter" underneath it, then click the URL in the right-hand pane, under Web App Admin Center. An administrator account in Alloy Navigator Express is required.

NOTE: If your Web App does not work as expected and you need to send the debug information to our Support Team, click Help > Debug Information on the main menu. The Web Configuration tool will generate the WebConfigDebugInfo.txt file and open it in Notepad.