Install Public Access Using the Windows Installer

Follow these steps to install the Public Access site for use with PLL. For more information on configuring Public Access once it's installed, see Public Access Setup Guide on MyCityworks.

IMPORTANT: Public Access has been rewritten at version 6.0 to use .NET 6 rather than .NET Framework. Due to this change in the underlying architecture, existing Public Access sites cannot be updated to Public Access 6.0. You will need to install a new Public Access site for 6.0. Once you have installed a new Public Access 6.0 site, it can be updated to new versions.

PREREQUISITES:

  • .NET Desktop Runtime 6.x.x is required to run the Windows installer
  • ASP.NET Core Runtime 6.x.x Hosting Bundle is required to run the Public Access site. You can have multiple .NET packages installed, but the installer will not run if you only have .NET 6 installed.
  • IIS 7.5 or newer
  • Cityworks 15.8.3 or newer
  • The Cityworks and Public Access websites must use HTTPS
  1. Navigate to where the Public Access installer application is located.
  2. Extract the install file from the zipped file by right-clicking the zipped file and clicking Extract All.
  3. Double-click the unzipped file to open it.
  4. Right-click the installer and select Run as administrator.

The installer automatically checks to make sure all the prerequisites are installed. If an application is missing, the installer will display a message instructing you to install the needed prerequisite.

If all prerequisites are properly installed, two green check marks display.

  1. Click Next.

  1. Select Install and click Next.

  1. Select Default Web Site from the Web Sites drop-down list.
  2. Enter an Alias for the virtual application.
  3. In the Install Location field, enter the physical path where the Public Access site files will be stored.

The installer creates a new app pool for each new site it installs since Microsoft only supports one .NET 6 app per app pool. The app pool is named <site_name>AppPool. The app pool runs as the ApplicationPoolIdentity and the .NET CLR Version is No Managed Code. When the installer creates the app pool, it leaves the Idle Time Out setting to the default IIS setting. The installer does not make updates to existing app pools.

The installer gives the app pool identity Modify permissions to the ClientApp\dist\content\config and ClientApp\dist\profiles folders in the root directory.

  1. Click Next.
  1. Click the Site tab to configure overall Public Access site settings. These settings can also be updated later using the Configure option in the installer. See Configure Public Access for more information on configuring these settings after Public Access has been installed.
  • Enter the address for the Cityworks site in the Service URL field. This field is required to validate the service. The installer provides an example to assist.
  • Enter the Service User Name and Service Password for a PLL user that already exists in the Cityworks site. These fields are required to validate the service.

NOTE: The initial map extent shown in Public Access is the initial map extent defined for the user entered here. This user must be added to the service definition and the service definition must also have services marked Public for these to display within Public Access. See Public Access Map Best Practices on MyCityworks for more information.

  • Enter the number of minutes that the site will time out in the Site Timeout (Minutes) field. The default is 15 minutes.
  • Select Allow Credential Passing to allow Public Access users to be authenticated by another site. See Enable Third-Party Authentication in Public Access on MyCityworks for more information.
  • Select Allow Guest Access to enable guest access. See Information: Creating Guest Access to PLL Public Access Site on MyCityworks for more information.
  • In the Allowed File Extensions field, you can specify the types that can be added in Public Access. The file extensions must be separated by a vertical bar.
  • Click Validate Service. This step is required.

A message will indicate whether the service URL and user are valid. It also checks to make sure your version of Cityworks is compatible with the version of Public Access being installed.

  1. Click the GIS tab to configure GIS-related settings. These settings can also be updated later using the Configure option in the installer. See Configure Public Access for more information on configuring these settings after Public Access has been installed.
  • In the GIS Services Config Name field, enter Office, Tablet, Mobile, Public, or Other to specify which map services from the service user's service definition to use in Public Access. The default is Public. See Configure GIS Services in the Admin 2.2 Guide for more information.
  • Select Use GIS For Location to use the user's location when creating a case.
  • Select Require Valid Location From GIS to require that users enter a valid location on the case. If this is not enabled, users can enter an address without geocoding it. Not using a geocoded address means the location field will be populated on the case but the X and Y coordinates will not be populated.
  • Select Allow Map Drawing Attachments to allow users to draw on the map and attach the drawing to the case.

  1. Click the Payment tab to configure payment-related settings. These settings can also be updated later using the Configure option in the installer. See Configure Public Access for more information on configuring these settings after Public Access has been installed.
  • Select Paypal, AuthorizeNet, or XpressBillPay from the Payment Provider drop-down list. Additional configuration fields show depending on the selected payment provider.
  • Select None from the Payment Provider drop-down list to not configure a payment provider.

  1. Click the reCAPTCHA tab to configure reCAPTCHA-related settings. These settings can also be updated later using the Configure option in the installer. See Configure Public Access for more information on configuring these settings after Public Access has been installed.
  • Select Use reCAPTCHA V3 if you are using reCAPTCHA.
  • Copy the site key from your Google reCAPTCHA settings page and enter it in the reCAPTCHA Key field.
  • Copy the secret key from your Google reCAPTCHA settings page and enter it in the reCAPTCHA Secret field.
  • The default Minimum reCAPTCHA Score is 0.5 but you can change it.

  1. Once you have configured the desired settings on the Site, GIS, Payment, and reCAPTCHA tabs, click Next.
  2. Verify that the site information is correct and click Save.

You will be asked if you want to proceed.

  1. Click Yes.

A box with a status bar displays while the virtual application is being created.

Once the installation is complete, a box displays indicating that it is finished.

  1. Click OK.

The URL for Public Access is https://<host>/<site_alias>/login.