Frequently Asked Question

1. Register the new domain on the DNS and point the A record to the instance external IP

2. Configure the load balancer to transfer request and response for this new domain

http-request redirect location https://%[hdr(host)]/Amelia/ code 301 if [ hdr(host) -i  ] is_root 

use_backend Amelia-HTTPS if [ hdr(host) -i  ] is_amelia 

use_ backend Amelia-HTTPS if [ hdr(host) -i  ] is_api_amelia_integration

use_backend A0-HTTPS if [ hdr ]

3. Verify there is no override configuration for admin & user web in the common application.properties. If there are any, please comment out.

#amelia.samI.supercedins.target.url-https://amelia.domain.com/Amelia/ui/domain/chat?domainCode=domain

4. Configure the basics for the new authentication system

Save and download Amelia's metadata. Send the metadata to the IDP and request their metadata.

5. When the metadata are received, edit the auth system and include the IDP metadata. You can skip to 6 while waiting.

Save and continue the setup.

6. Configure the new domain. You can skip this step if already created.

7. If the custom ui is needed, create a new ui bundle

- Export a bundle if you do not have the bundle base zip

- In the new bundle creation screen, select the zip exported

- Include the following as JSON config

{
"autoConnect": true,
"logoActive": true,
"logout": false,
"allowAnonymous": false,
"mobileSSODisabled": false,
"hideLogin": true,
"hideLoginOnMobile": true,
"ssoImmediateRedirect": true,
"showAnonymousDomains": false,
"showAgentRealName": false,
"showSSOButton": false,
"changeDomain": false,
"ui": {
"variables": {
"name": "Custom Theme"
}
},
"embed": "iframe",
"initialConversationAttributesMerge": true,
"initialConversationAttributes": {},
"id": "4877ee9a-d364-41fe-954b-08ddadd7c76f",
"name": "Custom Theme"
}

- Save and deploy the new bundle

8. Create the virtual host and link the ui bundle

9. Add the virtual host previously created to the domain and remove the default vhost

10. Set default ui bundle to the main domain if an override was found at step 3

11. Restart LB and Amelia user/admin web service.

12. Test SSO.