The Control panel lets you manage your Campaign Classic instances settings, like for example the URLs to which the instances can connect, or the IP addresses that are allowed to connect to your instance.

For more information on the Control Panel itself, refer to the dedicated documentation.

Note:

If the Instance Settings card is not visible on the homepage of the Control Panel, this means your IMS ORG ID is not associated with any Adobe Campaign Classic instances

IP whitelisting for Instance access

About IP whitelisting

By default, your Adobe Campaign Classic instance is not accessible from various IP addresses.

If your IP address has not been whitelisted, you will not be able to login to the instance from this address. The same way, you may not be able to connect an API to your Message Center or Marketing instance if the IP address has not been whitelisted with the instance explicitly.

Control Panel allows you to set up new connections to your instances by whitelisting IP addresses ranges. To do this, follow the steps described below.

Once IP addresses whitelisted, you can create and link Campaign operators to them so that the users can access the instance.

Best practices

Make sure you follow the recommendations and limitations below when whitelisting IP addresses in the Control Panel.

  • Do not enable IP access to all Access Types if you do not intend the IP address to connect to your RT servers, or AEM security zone. 
  • If you temporarily enabled access to your instance for an IP address, make sure to remove the IP addresses from the whitelisted IP addresses once you don't it need anymore to connect to your instance.
  • We do not recommend whitelisting IP addresses of public places (airports, hotels, etc.). Please use your company VPN address to keep your instance secure at all times. 

Whitelisting IP addresses for Instance access

To whitelist IP addresses, follow the steps below:

  1. Open the Instances Settings card to access the IP whitelisting tab.  then click Add new IP Range.

    ip_whitelist_list1
  2. Fill in the information for the IP Range that you want to whitelist as described below.

    ip_whitelist_add1
    • Instance(s): the instances to which the IP addresses will be able to connect. Several instances can be manipulated at the same time. For example, IP whitelisting can be performed on both Production and Stage instances through the same step.
    •  IP Range: the IP range that you want to whitelist, in the CIDR format. Note that an IP range cannot overlap an existing whitelisted range. In that case, first delete the range that contains the overlapping IP.

    Note:

    CIDR (Classless Inter-Domain Routing) is the supported format when adding IP ranges with the Control Panel interface. The syntax consists of an IP address, followed by a '/' character, and a decimal number. The format and its syntax are fully detailed in this article.

    You can search on the internet for free online tools that will help you convert the IP range that you have in hand to CIDR format.

    • Label: the label that will display in the whitelisted IP addresses list.
    • Name: the name has to be unique for the Access Type, Instance (in case of External API connection) as well as the IP address.
  3. Specify the type of access that you want to grant to the IP addresses:

    • Campaign Console Access: the IP addresses will be allowed to connect to the Campaign Classic Console.
      Note that Console access is enabled for Marketing instances only. Access to MID and RT instance is not permitted and therefore not enabled.
    • AEM connection: the specified AEM IP addresses will be allowed to connect to the Marketing instance.
    • External API connection: External APIs with the specified IP addresses will be allowed to connect to the Marketing and/or Message Center (RT) instance. Note that connection to the console of RT instances is not enabled.
    ip_whitelist_acesstype
  4. Click the Save button. The IP Range is added to the list of whitelisted IP addresses.

    ip_whitelist_added

    To delete whitelisted IP ranges, select them then click the Delete IP range button.

URL permissions

About URL permissions

The default list of URLs that can be called by JavaScript codes (workflows, etc.) by your Campaign Classic 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)

For more information, refer to the Campaign Classic documentation:

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

To add a URL that your instance can connect to, follow the steps below:
  1. Open the Instances Settings card to access the URL Permissions tab.

    Note:

    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.

    add_url1

    Note:

     All your Campaign instances display in the left pane list.

    As URL Permissions management is dedicated to Campaign Classic 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:

    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.

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

    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.

    add_url_listnew

    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

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

Instance Details

Your Adobe Campaign Classic instance architecture can contain several servers to enable the flexibility of marketing activities. For example, you can have Marketing, Real Time (or Message Center) and Mid Sourcing servers supporting your instance.

The Instance Details functionality allows you to view flat architecture of your instance. In addition to server information, it also lets you know whether or not your instance build is current, as well as recommends upgrades when needed.

Note:

We recommend that your instances are upgraded at least once a year in order to avoid performance degradation, and be able to take the advantage of the newest features and fixes Adobe Campaign Classic has to offer. 

To get information on the servers connected to your instances, follow the steps below:

  1. Open the Instances Settings card to access the Instance Details tab.

  2. Select in the left pane the desired Campaign Classic instance.

    Note:

     All your Campaign instances display in the left pane list. As the Instance Details feature is dedicated to Campaign Classic instances only, the "Non-Applicable Instance" message displays if you select a Campaign Standard instance.  

  3. The servers connected to the instance display.

    instance_details

     Available information are:

    • Type: the type of the server. Possible values are MKT (Marketing), MID (Mid sourcing), and RT (Message Center / Real-time messaging).
    • Name: the name of the server.
    • Build: the build version installed on the server.
    • Upgrade info: this column informs you if any update is required for the server.
      - Green: your server is current, no upgrade is required.
      - Yellow: you should consider upgrading. You are missing the newest features and fixes.
      - Red: upgrade as soon as possible. You are missing new features and the server performance might not be optimal.

    If one of your servers requires to be upgraded, refer to this documentation for more details on how to proceed.

Common questions

Your own instance can look very different, and it may not have all types of servers, or it can have several of the same server. Not having one type of the server or another does not mean you cannot send a real-time message or perform other kinds of activities. You can request additional server capacity, additional fees will apply. 

Please contact Customer Care if you believe some servers are not showing in the "Instance Details" page. Make sure you note the specific instance URL in your message.

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy