LiveDesign Integration Setup Guide
In this guide, we will walk you through the steps to set up the LiveDesign integration for Ideation.
The main steps are:
- Update Nginx configuration.
- Send us your LiveDesign URL for whitelisting.
Prerequisites
- Access to LiveDesign with admin privileges.
- Access to LiveDesign server and Nginx configuration.
Step 1: Update Nginx configuration
To make the gadget accessible, you will need to set up a dedicated route on Nginx. To do so, create a new configuration file at /etc/nginx/endpoints.d/ideation.conf (or wherever relevant) and fill it with the following:
location = /discngine/ideation/ {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_pass https://<your-company-prefix>-ideation.discngine.cloud/third-party-wrappers/livedesign/index.html;
proxy_read_timeout 600;
}
location /discngine/ideation/ {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_pass https://<your-company-prefix>-ideation.discngine.cloud/third-party-wrappers/livedesign/;
proxy_read_timeout 600;
}
Replace <your-company-prefix> by the proper prefix for your company.
To expose your newly created route, restart the Nginx server, usually with the following command:
sudo systemctl restart nginx
Step 2: Register Gadget in LiveDesign Admin Portal
On the LiveDesign Admin portal, under "Feature Configuration", go to "Properties".
In the "Feature Settings" section, look for "CUSTOM_TOOLS". Edit its value and add a new Object to the JSON:
[
{
"categoryName": "Discngine",
"gadgets": [
{
"name": "Ideation",
"location": "/discngine/ideation/?ideationServerUrl=https%3A%2F%2F<your-company-prefix>-ideation-demo.discngine.cloud""
}
]
},
...Other gadgets
]
Again adjust the <your-company-prefix> to be the prefix for your company.
Save the new setting and refresh LiveDesign page.
You should now see the "Ideation" item in the "Visualize" menu.
Step 3: Send LiveDesign URL to Discngine
If not already done during the registration phase with Discngine, send the full URL of your LiveDesign instance to support@discngine.com, i.e. https://livedesign.acme.com.
This is required for us to whitelist your LiveDesign server and allow Ideation to load in it.
To prevent various attacks such as Clickjacking, we only allow Ideation to be loaded in a selected list of parent application.
That is why we need you to provide us with your LiveDesign server URL.
Until your server has been whitelisted, you will not be able to load Ideation in LiveDesign.
Step 4: Log in to Ideation
Once you have received confirmation that your Ideation server has correctly been whitelisted, you will be able to load Ideation through the "Visualize" > "Ideation" item.
Log in to Ideation as usual and start importing a LiveReport to create SAR Slides from it.