Embedding Collaboration Hub via an iframe¶
Collaboration Hub can be embedded in third-party systems via an inline frame (iframe). When using an internal wiki, the Collaboration Portal can be embedded to provide direct access for authorized users. Like this, users can access the interactive functionality of Collaboration Hub alongside traditional documentation systems, such as Atlassian Confluence.
In case you are using Microsoft SharePoint, you can integrate Signavio Collaboration Hub using a SharePoint WebPart.
The access control rules that normally apply to Collaboration Hub also apply to an embedded instance:
- A user who is logged in will see the Collaboration Hub preview, i.e. every diagram of the workspace he can access, as well as his private diagrams.
- A user who is not logged in but has installed the matching the Collaboration Hub certificate will see the published diagrams.
- In case Collaboration Hub is integrated with your Directory Service, a user will be able to see diagrams they have read access to.
- A user who is neither logged in nor has installed the Collaboration Hub certificate will receive an SSL connection error.
To embed a Collaboration Hub in a website or wiki via iframe, add an iframe tag and insert Collaboration Hub URL as its source. Please make sure to use a URL of the form
https://editor.signavio.com/intra/portal (European Server),
https://app-us.signavio.com/intra/portal (US server) or
https://app-au.signavio.com/intra/portal (Australian server).
It is also possible to define a diagram that is displayed by default. To define a default diagram, its diagram identifier can be added to the URL in the form “#/model/[diagram id]”. The example iframe below defines such a start diagram.
To find the correct link, open the corresponding diagram in Collaboration Hub and copy its URL.
When defining a start diagram, make sure that the corresponding diagram has been published to Collaboration Hub in the correct revision. Otherwise, Collaboration Hub guests that are not logged in will not be able to see it.
On iframe that embeds Collaboration Hub can look like this, for example:
<iframe src="https://editor.signavio.com/intra/portal#/model/273j5d0mf3174c3b8b9439fn5k2a8b0f" width="90%" height="90%" name="Signavio Collaboration Hub"> </iframe>
Embedded into an empty html page, the iframe could look like this:
This is what an embedded Collaboration Hub looks like on an empty page.