Best Practices

Last Updated : Jun 05, 2026 |

When using the Management Interface web service, keep the following in mind:

  • The Management Interface web service is only available on the Primary EPM and only accessible over HTTPS. The web service clients need to accept the SSL certificate from the Primary EPM server.

  • The Management Interface web service uses Basic Authentication to authenticate web service client requests. When you submit a request to the web service, you need to include the user name and password that is configured as one of the Experience Portal users and that user must have the role with the appropriate feature enabled. For example, if the user wants to add an application, then the role must have the feature for adding an application enabled. Similarly, if the user wants to delete an application, then the role must have the feature for deleting an application enabled. If the user wants to update an application, then the role must have the feature for updating an application enabled.

  • If non-ASCII characters are sent in the URL request to the web service they should be encoded as UTF-8 prior to sending the request. For example, an application name of ‘aña’ is encoded and sent as ‘a%C3%B1a’. Note that the non-ASCII character ‘ñ’ is sent as the UTF-8 value of ‘%C3%B1’.

  • If zones are configured on the system, the zone name should be specified. If the zone name is not specified, then the web service operation is performed against the default zone.

  • Field names are case-sensitive.