Embedding apps with client pages

Cloudera Data Visualization allows you to embed applications into client pages using an HTML iframe component. You have two options: open access, which makes the app available to all users without requiring authentication or login, or trusted authentication for added security.

When you embed a Cloudera Data Visualization app into an iframe on a web page, you need to specify the frame-ancestor attribute, otherwise the browser security policy prevents the application from rendering on the page. The host sources you list will be the locations where the app can be embedded.

If you want to embed a Cloudera Data Visualization app into a client page iframe without requiring authentication, enable the Enable Unauthenticated Access option for the app. For more information and instructions, see the Public Applications section in Securing Applications.
Turn on the correct cookie settings by setting the environment variable IS_EMBED='true'.
If you want to maintain the embedding URL and prevent links from opening the application outside the embedded environment, add EMBED_URL_PREFIX=embeddingurl to the advanced site settings and restart the application. This prefix will be added to all Cloudera Data Visualization URLs.

For example: EMBED_URL_PREFIX=https://embeddingsite.com# will open the url https://embeddingsite.com#/arc/apps/data if you open the data page in a new tab.

Navigate to Project Settings > Advanced in Cloudera AI/Cloudera Data Science Workbench.
Set the CDSW_FRAME_ANCESTORS environment variable: specify one or more website locations where you want to embed the application in <host-source> format.
If you are adding multiple websites, use a comma-separated list.