Domo Integration
ReportBridge runs as a pair of Domo ProCode apps with full single-sign-on, group-based access control, and native embedding.
On this page
How It Works
ReportBridge installs as two ProCode apps inside your Domo instance. The apps communicate with a shared AWS Lambda backend through API Gateway. Reports render on a dedicated report server and are embedded via secure iframes.
Domo Card → ProCode App → API Gateway → Lambda → Report Server (iframe)
All communication is HTTPS. Lambda authenticates requests with per-tenant HMAC-derived API keys.
ProCode Apps
Two apps are installed in your Domo instance:
Admin App
Upload RDL files, run AI-powered SQL conversion, publish reports, manage databases, configure access control, and monitor the audit log. Includes a 10-step Setup Wizard for first-time configuration.
Viewer App
Browse and view published reports with a resizable sidebar, category grouping, search, favorites, dark/light theme, and deep linking. Supports demo mode with sample data.
Each app is added to a Domo card on any dashboard. Place the Admin card on a restricted page and the Viewer card where end users can access it.
Single Sign-On
ReportBridge inherits Domo's authentication automatically. Users log in to Domo as usual — no separate ReportBridge login is required. The ProCode runtime provides the authenticated user context (user ID, email, groups) to the app.
Standalone Mode
For non-Domo deployments, ReportBridge provides JWT-based authentication with 30-day tokens, automatic refresh, and invite-based user provisioning.
Group-Based Access
Access is controlled through Domo groups. Assign groups to organizations in the Admin app's Access Control screen:
- Admin groups — Full access to report management, conversion, and settings.
- Viewer groups — Read-only access to published reports within the organization.
- Multi-org — Each organization can have different admin and viewer groups, enabling tenant isolation within a single Domo instance.
Group membership is fetched from the Domo native API (/domo/groups/v1), automatically scoped to your instance.
DataSets
ReportBridge uses five Domo DataSets for configuration and catalog data. These are auto-created during the Setup Wizard:
| DataSet | Purpose |
|---|---|
| Config | Global configuration (hosts, ports, feature flags) |
| Catalog | Report inventory with status and metadata |
| Databases | Database connection configurations |
| Audit | Activity log (conversions, publishes, config changes) |
| Viewer Config | Viewer app preferences and token configuration |
Card Embedding
Add each ProCode app to a Domo card like any other visualization. The apps resize automatically to fit the card dimensions.
- Full-page cards — Best for the Admin app. Use a dedicated dashboard page with a single full-width card.
- Dashboard cards — The Viewer app works well as a standard card alongside other visualizations.
- Domo Everywhere — Embed ReportBridge cards in external portals using Domo's Everywhere platform for customer-facing deployments.