Creating an Embed Link

CONTENTS

Home

Embed links are added to your applications to display interactive bipp dashboards for your users. bipp users with the Tenant, Organization Creator, or Admin roles can register external applications and create the embed links.

Embedded Analytics is only supported for bipp Enterprise Edition.

Register the Application

  1. Log in to your bipp account.

  2. Navigate to Settings > External Apps. Register the Application

  3. Click Add External App. Add External App

  4. Enter the application information:

    • Application Name enter the name for the application.
    • Description enter a description of the application (optional).
    • Dashboards click in the entry box and select one or more dashboards to embed in the application

  5. Click Register to register the application with your bipp BI platform.

  6. bipp generates the credentials for the external application and sends them to the registered email for the tenant:

    • AppID is the external application identifier.
    • Client ID is the identifier generated for the specific deployment.
    • Client Secret is the passphrase for the deployment. It never expires. Additional secrets can be regenerated as needed.
    • API Key is the key you enter to generate an embed link.

Keep your generated API Key in a secure location. The key must be used to generate the embed links for the application.

Here is an example of the registration email: Registration Email

  1. Log in to the bipp tenant where you registered the external application.

  2. Click Dashboards from the home menu.

  3. Open the target dashboard.

  4. Click 3-dots Generate Embed Link. Embed Link The Generate Embed Link dialog opens. Embed Link Dialog

  5. Enter the information on the Generate Embed Link dialog:

    • External App select the target application from the list.
    • Filters select any filters for the dashboard (optional). Available filters are specific to the dashboard.
    • White-listed Domain(s) add domains that host the external application. Add a , (comma) after a domain entry to add another domain or Enter to finish the entry.
    • API key enter the bipp-generated API key for the application. This key is generated when the application is registered with bipp. The key is emailed to the registered user for the tenant.

  6. Click Generate Embed Link. The link is shown in the Output field. This is the link you embed in the application. Refer to

  7. Click Copy link and paste it into a text file for later use.

  8. Click Close.