Skip to main content

Embed external apps

Atlan supports embedding external web applications directly within the product interface, either in the navigation sidebar or as a tab on asset profiles. Embedded apps run on your own infrastructure and are loaded via a sandboxed iframe; Atlan passes authenticated user context to your app through the postMessage API.

This capability lets you surface existing web applications, such as dashboards, BI tools, or custom interfaces, inside Atlan, enabling users to access them without leaving the platform. You are responsible for hosting and deploying the application; Atlan handles loading it within the iframe and transmitting the current user and page context, which your app can use to make Atlan API calls and display contextually relevant information.

This section covers local development setup, app registration and embedding configuration, and the authentication payload and message protocol.

Core offerings​

🧭

In-context UI

Show your app in the navigation sidebar or as an asset profile tab.

🔐

Authenticated context

Receive a JWT token, user identity, and page context through a secure handshake.

🧩

Flexible app stack

Use any browser-based web app framework that can run in an iframe.

🛡️

Sandboxed execution

Run inside a sandboxed iframe with origin validation and permission-scoped tokens.

Get started​

Follow this process to embed and validate an external app. Start with local development, then deploy and embed your app, and finally register it in Atlan.

1

Develop app

Run your app on localhost and authenticate to your tenant to test API calls before deploying.

→
2

Embed app

Deploy your app, configure CSP, and add authentication so Atlan can load it in the sidebar or on asset profiles.

→
3

Register app

Set render locations, allowed origins, and conditional rules so the product can load your app.

See also​