Quicksight integration with Amorphic

QuickSight is a cloud-powered business intelligence service that makes it easy to deliver insights. To integrate Quicksight with Amorphic application follow the the steps mentioned below

Subscribe to Quicksight in the region Amorphic application is deployed

Quicksight Console

Signup for Quicksight, once you click signup you’ll be provided with an option to select standard or enterprise.

Quicksight Options

Select enterprise edition and continue.

Quicksight Region Selection

In the next screen select ‘Use Role based Federation(SSO)’ and then in the region drop down select AWS region same as Amorphic application deployed region.

Give Quicksight Account name as Amorphic application name. Enter the email address for notifications and then select finish.

Quicksight Signup Success

It takes around 15 seconds to create an account. Once created, console will display Amazon Quicksight information. Select ‘Go to Amazon QuickSight’ button.

Manage Quicksight

Once the enterprise edition is set up in the account, in the console we need to add the domain of Amorphic application in Quicksight. To do that select Manage Quicksight which will be dropped down once we select our profile on the top right corner of the console.

Quicksight Domain Embedding

Once we select manage quicksight we will be able to see Domains and Embedding on the left hand side. We need to select that and add Domain name in the text box provided. Domain name is the amorphic application URL (Not the backend Cloudfront URL).

We do this to whitelist our domain and make it available for application to project dashboard urls.

This link has the steps of how to add a domain: https://docs.aws.amazon.com/quicksight/latest/user/approve-domain-for-dashboard-embedding.html

For the first time, we need to create a dummy dashboard in quicksight and register it in the amorphic application. Open the dashboard details in the amorphic application(it will not display the embedded dashboard, but it creates a required user in the backend). This is a temporary hack to create the required user in the backend.

After this step following user will be created in Quicksight : {projectShortName}-Quicksight-Lambda-ExecutionRole/lambdaaccess

Dashboard Sharing

To share/use a quicksight dashboard using Amorphic application. Follow the below steps

In the console, select dashboards options which will display available dashboards.

Quicksight View Dashboards

For application to use these dashboards, they should be shared with a user(the user created by application to access quicksight) the username for that user would be {projectShortName}-Quicksight-Lambda-ExecutionRole/lambdaaccess. The email address(noreply@amorphicdata.com/noreply@cloudwick.com) associated with this username needs to be used to share the dashboard.

Quicksight Share Dashboard

To share the dashboard, click on the share option on the top right corner once you open the dashboard from AWS Console. A dialog box appears in which email address needs to be entered. Selecting that would populate the table below and then select share.

Quicksight Share Email Address

Next dialog box would display the users who have access to the dashboard, the dashboard is now shared and can be used from Amorphic application.

Quicksight Dashboard Sharing

Share it with {projectShortName}-Quicksight-Lambda-ExecutionRole/lambdaaccess user with Viewer access.