Embed surveys published from Survey123 local installer in other apps

Summary

After installing the local Survey123 installer on-premises, follow these steps to enable surveys published from the local installer to be embedded in other applications, such as Experience Builder and Workflow Manager, from different domains.

Procedure

1. Stop the Survey123 Service
   1. Access the machine where the local Survey123 installer is installed.
   2. Stop the Survey123 service from the operating system level to ensure that changes can be made safely.
2. Locate the Configuration File
   1. Navigate to the directory where the Survey123 installer is installed.
   2. Locate the config.json file, which is typically found in the installation folder. The Linux installation folder is ~\ArcGIS\Survey123website and the default location on Windows is C:\Program Files\ArcGIS\Survey123website. 
3. Modify the config.json File
   1. Open the config.json file in a text editor. 
   2. Add the following content at the root level of the config.json file to adjust the content security policy. This allows embedding of the Survey123 web app:

"securityHeader": {
  "contentSecurityPolicy": {
    "directives": {
      "frameAncestors": [
        "'self'", //this value allows survey123 webapp to be embedded within the same domain even the port is different
        "*. Esri.com" //add domain info where other apps are installed
      ]
    }
  }
}

4. Start the Survey123 Service
   1. Save the changes to the config.json file.
   2. Restart the Survey123 service at the operating system level to apply the new configuration. 

This resolves the following or similar bugs:

• BUG-000161914 The default configuration of the installed ArcGIS Survey123 website returns an X-Frame-Options error preventing published surveys to be embedded in the Survey widget in ArcGIS Experience Builder developer edition.