SAML Configuration

The mobile apps support Security Assertion Markup Language (SAML), which enables the OAuth setting when you install and configure the app and allows you to use single-sign on authentication against your Portal for ArcGIS or ArcGIS Online account.

  1. Navigate to the Cityworks Single Sign-on web application that you created in your Portal for ArcGIS instance or ArcGIS Online organizational account.
  2. Add a Redirect URL in the web application in your Portal or ArcGIS Online instance. This is found in the same place as the Client ID and Client Secret. Add cityworks12://auth as a redirect URL.

  1. The next step is to get the App ID. This is the same Client Id value obtained when setting up the Cityworks Single Sign-on site through the install steps.

  1. Navigate to the Settings in the Cityworks mobile app and tap or turn on the toggle switch to the right next to the OAuth option.
  2. Add the App ID value you obtained and type it in the corresponding Client Id field.

  1. Make sure the Cityworks site information is correct.
  2. Make sure either ArcGIS Online Login or ArcGIS Portal Login is selected and all necessary information is entered.
  3. Tap Save.
  4. Tap your ArcGIS Online or ArcGIS Portal login.

  1. The OAuth2 Portal login page opens. Choose either the SAML provider through your domain, or ArcGIS.

NOTE: OAuth2 authentication is limited to active ArcGIS Online or Portal for ArcGIS authentication configurations. Users of the mobile apps for Android and iOS must have an active OAuth2 configuration referencing the same ArcGIS Online or Portal for ArcGIS provider set up in Admin. See Configure Service Resource Security in the Admin 3.3 Guide for more information.

  1. If you choose the SAML provider through your domain, you will be redirected to your ADFS provider page.
  2. Enter your login as either user@domain or domain/user, then enter your password. Tap Sign in.

The application syncs and loads the map.