Installation Guide

Configuring the Self Service Portal

You configure the Self Service Portal 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 Self Service Portal:

  1. On the main menu of the Web Configuration tool, click File > Create > Self Service Portal. 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 Self Service Portal 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 Self Service Portal instance on the IIS server.

    Click Next.

  4. On the Installation Type page, specify where to install the Self Service Portal:

    • 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 (SSP).

    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 Self Service Portal. 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 Self Service Portal. For example, if your server's host name is "www.example.com," specifying "hd" as the Virtual Directory Name will result in the following URL: https://www.example.com/hd/.

    Click Next.

  7. On the Authentication Method page, choose the authentication type for SSP customers:

    • 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 Self Service Portal Link macro. This macro is used in workflow notifications to generate direct links to objects.

    INFO: For details, see Customizing the Self Service 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 Self Service Portal 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 > Self Service Portal.

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 is required.

NOTE: If your Self Service Portal 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.