If you've built meaningful dashboards and are ready to visualize them in your own application, now is the time! In this chapter we'll cover the different steps needed to embed a Luzmo dashboard using single sign-on (SSO) tokens.
To start, an Integration needs to be set up. Creating the Integration is a one time, initial setup step, from there on you can update it when/if required. An integration is in essence a collection of dashboards and (filtered) datasets and the access rights to those. At creation time an Integration is "empty", meaning no dashboards or datasets are associated with it. After creating the integration, the next step is to associate dashboards and datasets with it:
As always, setting up an Integration and the associated dashboards/datasets is possible through both our UI and our API. The following articles will provide UI examples, the API calls can be found in the Developer documentation.
Once your Integration is set up, integrating a dashboard in your application/platform using SSO tokens is a simple two-step process, with a server-side and a client-side action.
Please note we strongly advise against turning the share link on when you also embed that dashboard in your application.
The embedding token will take preference over the share URL, thus the rights and filters you set for your user will be applied. However, when the embedding token of the user expires, and the dashboard is still open, any new data query (e.g. using a filter on the dashboard) will fall back to the public share existing on the dataset. It is thus strongly recommended not to turn this on when embedding your dashboards.
You can turn off the possibility to enable the public share URL by setting the flag "flag_private_sharing" to false. You can set this via the flags property for Luzmo users (see the User resource or add it to the embedding token).
The next article will show you how you can create an Integration, which is the first step of the one-time setup to being able to use SSO tokens.