Servicely Administration
Networking
Reverse Proxy
8 min
a reverse proxy can be set up on your own/managed web servers to serve your servicely instance’s content from your own domain this will allow you and your users to be able to navigate to and interact with, for example, https // # com that serves content from https //yourinstancename servicely ai https //yourinstancename servicely ai note that reverse proxy is different than redirecting from your own url to a servicely url a redirection always shows the servicely url as the url displayed on the web browser once the webpage has finished loading we are not responsible with your reverse proxy configuration nor its ongoing support, uptime and maintenance therefore, please ensure you have a dedicated team and process to look after the setup please be advised that servicely will not be accessible through your reverse proxy url if there is an outage with your reverse proxy setup possible solutions deciding on which solution you use is not something we can recommend it is something that should be dictated by your organisation’s requirements on hardware/software, performance as well as security and best practices when configuring the solution, always consult with the product documentation of the respective software/product there are a variety of possible solutions out there that can do reverse proxy some examples as an idea (not limited to) apache http server nginx servicely configuration please notify us should you decide to proceed so we are aware the configuration steps outlined in this section, if to be done on a live servicely environment, should only be performed outside business hours or a time window where number of users impacted will be minimal this is because the steps involve changing single sign on identity provider and your baseurl configuration once you have the reverse proxy set up, you will need to update the following on the servicely side our example below refers to a domain but you can also use a subdomain to serve servicely content as long as you provide the full url in the configs below as well as in your reverse proxy set up base url go to the application properties docid\ ltoo4wlb8le r0q20fndx called “system baseurl” change the property value from https //yourinstancename servicely ai https //yourinstancename servicely ai , to the url that you are using to serve your servicely instance’s content e g https // # ) single sign on (sso) if you have single sign on saml 2 0 docid\ o y wwionevzqzvudddmb set up prior to configuring the reverse proxy, you need to re do the identity provider set up by clearing your set up on the servicely “authentication identity provider” record clear the login url field clear the idp metadata xml field clear the sp metadata xml field save the record re do the set up on your identity provider by updating the following urls and replacing the servicely urls with yours while keeping the rest of the url parameters the same as they were before identifier/login to be, for example https ///idp callback?client name= reply to be, for example https ///idp callback?client name= logout to be, for example https ///idp callback?logoutendpoint=true\&client name= download the metadata off your identity provider settings and copy the content place the content in the metadata file onto the servicely “authentication identity provider” record’s idp metadata xml field and click on save you may then re test the sso if you are configuring sso after the reverse proxy is set up, please also ensure that you use your own url instead of servicely’s just like identified in step #2 above when it comes to setting up the urls on the sso’s identity provider side system configuration script you need to ensure that a system configuration script that runs during an instance node startup, always try to set the desired url you need first, please find an out of box system configuration script called “set initial baseurl system property”, alternatively navigate to https // servicely ai/#/systemconfigurationscript/0a00000a6d5d1809816d5df4c92b1f08 note, to get to a list of system configuration script, you may navigate to administration > business logic > system configuration scripts review the below script and make the required changes relevant to your servicely configuration for example, for the line where it has https // servicely ai, you need to replace it with your servicely url // see if the property already exists let propertyrecord = applicationpropertymanager getglobalpropertyrecordbykey("system baseurl"); let generatedbaseurl = applicationpropertymanager generatedefaultbaseurl(); let prod instance base url = "https //\<yourinstancename> servicely ai"; // replace with your servicely url let base desired prod url = "https //\<yoururl>"; // replace with your reverse proxy url if (propertyrecord == null) { // it doesn't exist, so create the property applicationpropertymanager createglobalpropertyrecord( system baseurl property, generatedbaseurl, "string", "the base url to use for url construction (e g creating external links)" ); } else { // the record already exists, so update it to a new value if appropriate let currentvalue = propertyrecord value(); if (generatedbaseurl == prod instance base url) { // we want this to be the "desired url" if (currentvalue != base desired prod url) { propertyrecord value(base desired prod url) update(); } } else { if (currentvalue != generatedbaseurl) { propertyrecord value(applicationpropertymanager generatedefaultbaseurl()) update(); } } }