All dashboards can be shared so they can be viewed outside of Learning Record Store and without the need to enter any login credentials. This enables you to embed your dashboards on other sites, or just conveniently share a link to them, without necessarily having to give out direct access to your Learning Record Store.
For example, here's a Learning Record Store dashboard embedded in an LXP:
Open the dashboard that you want to share, and click Share near the top-right:
Click New shareable link and expand the new entry:
| Title | A name that will be used in the URL of your shareable dashboard, and that you can use to differentiate between multiple shareable links. |
| Shareable link | This is the URL that you can share once your shareable link has been set up. |
| Where can this be shared? |
Nowhere: The shareable link will not display this dashboard when accessed directly. Anywhere: The shareable link will display this dashboard when accessed directly. If embedded, the dashboard will be displayed regardless of the site. Only where I choose: The shareable link will not display this dashboard when accessed directly. If embedded, the dashboard will only be displayed if the site in which it is embedded has been set as a valid domain. |
| What are the valid domains? | If you select Only where I choose above, you'll be prompted to enter valid domains in a regex format. Click here to learn more about regex. |
| URL filter mode |
To provide many versions of the same dashboard with different filters applied you can enable the URL Filter setting to allow the link itself to include a query filter. The query is built in the query builder and these options
|
| Query Builder |
You can optionally add a filter here to limit the data that the shareable dashboard will display to viewers. This makes it a lot easier to share already made Dashboards without needing to necessarily make an entirely separate one without any sensitive information. Although of course in some circumstances creating a separate Dashboard with its own isolated Visualisations is still the best option. |
Creating a JWT Secured filter
To prevent modification of the link filter, the JWT Secured option can be selected. This will only accept JWT filters that have been signed with a given secret.
Tip: Using the URL filter required setting you can prevent the dashboard from displaying any data at all unless a signed JWT token is present in the URL.
To create JWT Secured links:
- Select JWT Secured. You will see a new input box titled JWT Secret (HS256).
- Fill this with a random string sequence similar to a strong password. Avoid simple dictionary words.
- Navigate to the JSON Web Tokens site:
- Check the drop-down for Algorithm above the windows is set to HS256.
- Paste your filter in the Payload section on the middle-right of the website, replacing the default data. URL encoding or white space removal is not necessary.
- Enter the JWT Secret from Step 2 in the area titled Verify Signature, replacing the text your-256-bit-secret.
- The panel on the left titled Encoded will automatically be filled. Copy this and it can be added to your shareable link, after ?filter=