On this page

Embedding dashboards in a portal

Mugnsoft can hand you a ready-made <iframe> snippet that embeds a live, read-only dashboard into any web page — an intranet portal, a wallboard, or a public status page. The embedded view requires no login and refreshes on its own. When a Webserver-Front replica is configured, the iframe automatically points at the replica so you never expose the internal Webserver.

What you can embed

Two views are available as embeddable dashboards:

View What it shows
App view The application status grid — a compact card per application with its current health.
3D App view The 3D application plane, the same data rendered as an interactive 3D scene.

Both are read-only and scoped to a user, so the embedded dashboard shows exactly the applications that user is allowed to see.

Generate the embed snippet

  1. Log in to the Webserver and open the application dashboard.
  2. Click the share action to open the share dialog:
    • the share (share-from-square) icon for the App view,
    • the cube icon for the 3D App view.
  3. The dialog shows a complete <iframe> snippet. Adjust the width and height to fit your page, then click copy and paste it into your portal’s HTML.
Share dialog showing the generated iframe embed snippet for the application view

A generated snippet looks like this:


<iframe id="mugnsoftAppEmbeddedStatus"
        title="Application Embedded status"
        width="100%" height="600"
        src="https://front.example.com:9090/web/html/viewer.html#/appsview?user=jdoe&detail=false">
</iframe>
The host in the src is chosen for you. If a Webserver-Front replica is enabled and its public URL is set, the snippet points at the replica — the read-only, DMZ-safe host. Otherwise it falls back to the Webserver you generated it from. The share dialog tells you which host the link targets.

Tune the view with URL parameters

The snippet works as-is, but you can append optional parameters to the src URL to change what the embedded view displays.

App view (appsview)

Parameter Values Effect
detail true / false Include per-application detail in the cards.
view compact / detail Select the card layout.

3D App view (app3dPlaneview)

Parameter Values Effect
filter true / false Show the search bar and 3D controls.
weather true / false Toggle the “weather” presentation of the plane.

For example, to embed a clean 3D wallboard with no controls, end the src with …/app3dPlaneview?user=jdoe&filter=false.

Embedding notes

  • Sizing. The view is responsive; set width="100%" and a fixed height that suits your layout. Wallboards typically use a taller height for the 3D view.
  • Refresh. The embedded view polls for updates on its own — your portal does not need to reload the iframe.
  • No login. The embedded routes are public read-only views keyed by the user in the URL; the viewer never prompts for credentials, which is what makes it portal-friendly.
  • Cross-origin embedding is allowed. The dashboards are served without an X-Frame-Options: SAMEORIGIN restriction so they can be framed from your portal’s origin.

Note:

Anyone who has the link can view the embedded dashboard — there is no login step. Treat the snippet’s URL as the access control: only embed it on pages whose audience is allowed to see those applications, and prefer pointing the iframe at a Webserver-Front replica when the portal lives on an untrusted network.

See also

Translations

Import, export and repository snapshot