Install Cityworks Single Sign-on

Cityworks Single Sign-on has to be installed. If you are updating your Cityworks Single Sign-on site, see Update Cityworks Single Sign-on.

PREREQUISITES: Before installing Single Sign-on, you must complete the steps in Create the Application in ArcGIS Online or Portal for ArcGIS. You must have .NET 4.7.2 You must have IIS 7.5 or newer If there is a previous version of ASP.NET MVC on the machine, you will need to install ASP.NET MVC 4.0. If ASP.NET MVC has not been installed on the machine, you do not need to install ASP.NET MVC 4.0.

1. To download Single Sign-on, log in to MyCityworks and search for Single Sign-on 1.3.
2. After reading the download page, download the file found under the Download Files section.
3. Open the file, then double-click the install file to open the installer.

The first page shows the prerequisites for Single Sign-on.

4. Click Continue.

5. Select the Install option and click Continue.

NOTE: The Configure option can be used to update your Single Sign-on site settings if necessary.

6. Leave the Web Sites drop-down list as Default Web Site.
7. Enter an Alias for the site. This is the name you gave the application in ArcGIS Online or Portal for ArcGIS in Create the Application in ArcGIS Online or Portal for ArcGIS. Note that the URL to access the Single Sign-on site is <server_name>/<alias>, so whatever you enter here will be part of the URL that users will use to access the Single Sign-on site. It is important that you name the Single Sign-on site something different than the core Cityworks site alias.
8. The default location for storing the Cityworks Single Sign-on files is C:\inetpub\wwwroot\<alias>. If desired, you can specify a different location.
9. Click Continue.

10. In the Server Settings section, enter the Cityworks Server Url. This the URL for your Cityworks site. Note that this value is stored in the WebAppSettings.config file located under ...\inetpub\wwwroot\<Single_Sign-on_site_alias>\WebSite.
11. In the OAuth2 settings section, select either ArcGIS Online or Portal for ArcGIS.

• If you select ArcGIS Online, enter the Client Id and Client Secret (password) that you got when creating the application in ArcGIS Online. See Create the Application in ArcGIS Online or Portal for ArcGIS for more information.
• If you select Portal for ArcGIS, enter the Client Id and Client Secret (password) that you got when creating the application in Portal for ArcGIS. See Create the Application in ArcGIS Online or Portal for ArcGIS for more information. Also, enter the Base Url for your Portal for ArcGIS site (https://<server>/<web_adaptor>).

NOTE: The information entered in the OAuth2 settings section above is stored in the Oauth2Settings.config file located under ...\inetpub\wwwroot\<Single_Sign-on_site_alias>\WebSite.

12. Click Continue.

This is an example for ArcGIS Online:

This is an example for Portal for ArcGIS:

13. Review the install information and click Install.

14. When asked if you want to proceed, click Yes.

You will be notified when the install process is complete.

15. Click OK.

To access your Cityworks Single Sign-on site, open your browser and navigate to <server_name>/<alias>.

TIP: The Cityworks logo that is displayed on this page can be changed by replacing the logo.png file located under ...\inetpub\wwwroot\<Single_Sign-on_site_alias>\WebSite\Content with your desired .png file. It is important to note that this customization is not preserved when updating Single Sign-on, so you will need to replace the image after any updates.

 

Last updated 2/25/2020.

Copyright^© 2017–2019 by Azteca Systems, LLC. All rights reserved.