English

How To: Configure Portal for ArcGIS to work with survey123.arcgis.com

Summary

Portal for ArcGIS versions 10.4, 10.4.1, and 10.5 require additional configurations to connect a survey123.arcgis.com website with a Portal. These configurations are not required for Portal for ArcGIS 10.5.1 and newer versions, as these versions are pre-configured to connect to the survey123.arcgis.com website. 

Not performing these steps may result in the error message when attempting to sign in to the Portal from the Survey123 for ArcGIS website:

Error:   
"Invalid client_id, Error: 400"

Procedure

Adding survey123.arcgis.com as a registered application involves registering an App ID. Follow the steps below to add survey123.arcgis.com as a registered application to Portal for ArcGIS.

  1. Add and share the Survey123.arcgis.com website
    1. Open the ArcGIS Portal Directory sharing application and log in as a member with administrative privileges. The URL format is:
      1. https://webadaptorhost.domain.com/arcgis/sharing/rest
    2. Navigate to the administrative user’s content page.
      1. https://webadaptorhost.domain.com/arcgis/sharing/rest/content/users/<username>
    3. Under Supported Operations, select Add Item.
    4. In the Add Item form, enter the following:
      • Type: Web Mapping Application
      • Type Keywords: Web Map, Map, Online Map, Mapping Site, JavaScript, Ready To Use
      • URL: https://survey123.arcgis.com
      • Title: Survey 123 Website
      • Tags: survey123
    5. Click Add Item.
    6. On the User Item page, under Supported Operations, click Share Item.
    7. On the Share Item page, set Share with Everyone to True.
    8. Click Share Item.
  2. Register the survey123.arcgis.com website
    1. On the User Item page, select and copy the ID value.
    2. Under Related Operations, click Register App.
    3. On the Register App page, enter the following:
      • Item ID: This is the ID copied in Part II, Step 1.
      • App Type: Select a browser from the drop-down menu.
      • Redirect URIs: Enter ["http://survey123.arcgis.com", "https://survey123.arcgis.com"] - This value allows the successful authentication response to be sent to the portal URL.
    4. Click Register App. The Registered App page displays the App ID.
    5. On the Registered App page, copy the App ID value.
  3. Change the Survey123 App ID
    1. Open the ArcGIS Portal Directory admin application and log in as a member with administrative privileges. The URL format is:
      1. https://webadaptorhost.domain.com/arcgis/portaladmin
    2. Navigate to Home > Security > OAuth > Change App ID.
    3. On the Change App ID page, enter the following:
      • Current App ID: This is the App ID copied in Part II, Step 5.
      • New App ID: Enter survey123hub.
    4. Click Change App ID.
  4. Use the Survey123 for ArcGIS website to connect to Portal for ArcGIS
    • Navigate to the survey123.arcgis.com website, and add a portalUrl parameter (note the capitalization). For example, if a Portal is "portal.domain.com/arcgis", the following URL is used to load the Survey123 for ArcGIS website:
      https://survey123.arcgis.com?portalUrl=https://portal.domain.com/arcgis

Related Information