FireFly Analytics LogoFireFly Analytics
Architecture / Solutions

Embedding Databricks Apps via Proxy

The proxy uses a session-cookie architecture — a short-lived JWT is exchanged for an opaque HttpOnly session cookie, so no Databricks tokens ever appear in URLs, browser storage, or logs. Documentation is organized into dedicated pages below.

Solution Documentation

The embedding architecture and individual solutions are documented separately for easier navigation and more detailed coverage.

⚠️ Production Deployment Warning

The Firefly reference implementation uses path-based cookies on a single shared proxy domain for simplicity. This is suitable for development and demos only.

For production, use wildcard subdomain routing (e.g., app-*.firefly-analytics.com) to ensure full app isolation, strict CORS, and to prevent cross-app cookie contamination. Path-scoping is a browser hint — it is not enforced by the Same-Origin Policy.

See the Embedding Databricks Apps — Production Deployment section for the full guidance and architecture comparison.