URL permissions url-permissions

About URL permissions about-url-permissions

This feature is available for Campaign v7/v8 instances only, from build 8850. If you are using a previous build, you need to upgrade to use this feature.

The default list of URLs that can be called by JavaScript codes (workflows, etc.) by your Campaign instances is limited. These are URLs that allow your instances to function properly.

By default, instances are not allowed to connect to outside URLs. The Control Panel allows you to add some outside URLs to the list of authorized URLs, so that your instance can connect to them. This allows you to connect your Campaign instances to outside systems like, for example, SFTP servers or websites in order to enable file and/or data transfer.

Once a URL is added, it is referenced in the configuration file of the instance (serverConf.xml).

Discover this feature in video

Related topics:

Best practices best-practices

  • Do not connect your Campaign instance to websites/servers that you do not intend to connect to.
  • Delete URLs that you are no longer working with. However, be aware that, if another section of your company is still connecting to the URL that you deleted, nobody will be able to use it again.
  • The Control Panel supports http, https, and sftp protocols. Entering invalid URLs or protocols will result in errors.

Managing URL permissions managing-url-permissions

To add a URL that your instance can connect to, follow these steps:

  1. Open the Instances Settings card to access the URL Permissions tab.

    note note
    If the Instance Settings card is not visible on the homepage of the Control Panel, this means your organization ID is not associated with any Adobe Campaign instances
    The URL permissions tab lists all outside URLs that your instance can connect to. This list does not include URLs that are required for Campaign to work (e.g., connections between infrastructure pieces).
  2. Select in the left pane the desired instance, then click the Add new URL button.

    note note
    All your Campaign instances display in the left pane list.
    As URL Permissions management is dedicated to Campaign v7/v8 instances only, the “Non-Applicable Instance” message displays if you select a Campaign Standard instance.
  3. Type the URL to authorize, with its associated protocol (http, https or sftp).

    note note
    It is possible to authorize multiple instances to connect to the URL. To do this, add them directly from the Instance(s) field by typing their first letter.

  4. The URL is added to the list, you can now connect to it.

    note note
    The “/.*” characters are automatically added to the end of the URL you enter after it has been validated, to cover all sub-pages of the entered page.

You can delete a URL at any time by selecting it and clicking the Delete URL button.

Keep in mind that, if you delete a URL, your instance will not be able to call it again.

Common questions common-questions

I added a new URL, but my instance is still unable to connect to that URL. Why is that?

In some cases, URLs you try to connect to require allow listing, password entry or another form of authentication. The Control Panel does not manage additional authentication.