Decoupled setup with physically separated servers



I was reading the documentation on decoupled setup on and I was wondering about the following line:

"Have separate servers for the user interfaces and the public site, and have the UI server on an internal protected network"

If a server containing both the API and the CMS UI is only reachable from the outside by a public facing server (the frontend application) - Is there any reason to keep the CMS UI on a server separate from the API in addition to keeping it separate from the public facing server? (in order to keep the UI completely inaccessible by the public facing server)



Jan 27, 2022 14:23

This text is only referring to the CMS UI (Editing Interface) and the public site. So the suggestion is just lock down the CMS UI outside of the public domain to increase security so that only certain people such as the org can access it. If by API you're referring to the Content Delivery API I would expect that to just run of the public website but you could chose to separate it however it really depends what software your connecting the API to. If you're building headless you'll have to have the Content Delivery API on a public server for it to be accessible, if you're using it to connect to another system that doesn't you could chose to run in purely on the CMS UI box.

Jan 28, 2022 14:31

Hi Scott,

Thank you for answering! And yes, by Api I was referring to the content delivery api.

The only requests allowed to reach the server hosting the CMS UI/Api would be made by the whitelisted frontend server (so no browser ajax requests going straight to the CMS UI/Api server) or by editors within the org using the UI.

Maybe I should have written headless instead of decoupled since the frontend is not connected to episerver (so no Episerver on that server), it just consumes the content delivery api, but I figured enabling on page editing by html attributes would make it decoupled? (I haven't fully grasped the distinction...)

So I guess what I'm wondering is if splitting the CMS UI/Api into a sole purpose ui-server (and removing the UI parts from the would be sole purpose api-server) is to be considered best practice in this scenario from a security point of view?

Jan 28, 2022 20:33

Yes sure, that helps to understand your questions.

Most of the examples that I've seen use the Content Delivery API as a headless approach and supporting the OPE are client side driven. Such as the demos which are vue.js and the react version and documentation for OPE support . If you say you are consiming it directly from an IP locked web frontend server that's restricted then you are consuming the Content Delivery API from another backend framework such as node.js? If so I'm not sure there's any framework I know of for supporting the on page editing as these are all built for consuming via the client side to a public instance of the Content Delivery API.

Around security however, the best practice around all this is really just around securing the editor interface but these are more a suggestion. For example on the Optimizely Digital Experience platform everything comes from the public WebApp instance and any CMS UI lockdown is instigated by IP and that's on their core recommended platform. 

So when self hosting I'd say the main questions if there is the need for a more security access to the CMS UI needed? There's still IP restrictions for the admin you can setup and forcing strong passwords so unless you feel it's needed I'd say it's not necessary (and as mentioned the DXP doesn't even do it) and also that if your frontend server isn't going to have the Optimizely platform on it then I would keep any frontend server as lean as possible. 

Jan 31, 2022 9:33

Thanks for the awesome information.

Feb 03, 2022 12:44


You make some excellent points. Regarding the OPE I actually had not even considered this might become a problem but you're right of course. However, since the editors will always be on a private network I think we should be able to circumvent the issue since the api/cms ui must also be allowed to be reached by said network IP, but I definitely need to get a proof of concept up and running when I'm back at work :-)

Again, thank you for your time and input!

Edited, Feb 03, 2022 18:59
Scott Reed - Feb 03, 2022 22:12
ah yes if you're on a private network and consuming via client side then will be fine. Be aware the OPE support via a headless approach is still a little buggy/tricky at times but it should work as you say. And no worries glad to help
This topic was created over six months ago and has been resolved. If you have a similar question, please create a new topic and refer to this one.
* You are NOT allowed to include any hyperlinks in the post because your account hasn't associated to your company. User profile should be updated.