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, Collaboration Hub 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.

Learn how to integrate an iFrame into a Confluence documentation.

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, that means 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.

Trusted domains

Collaboration Hub can only be embedded in third-party systems via iframes if trusted domains are used. If a domain not included in the trusted domains is used, web browsers don't load the page, and instead show a security violation page to the users.

To embed Signavio products in an iframe using trusted domains, you have the following options:

  • Use one of the public trusted domains

  • Add workspace-specific trusted domains

Use public trusted domains

Some common third-party tools use domains that are public trusted domains.

When you embed Collaboration Hub in the following domains, no further action is required on your side:

  • *.atlassian.net

  • *.sharepoint.com

  • *.force.com

Add workspace-specific trusted domains

When you want to embed Collaboration Hub in other third-party tools, you have to add the domains to the security configuration and adapt the URLs.

Follow these steps:

  1. In the Explorer, open Setup> Edit security configuration.

  2. In the section Domain policies, add the trusted domains.

  3. Add the parameter ?t=<workspace_id> to the URLs used for embedding.

URL format

To embed Collaboration Hub in a website or wiki via iframe, add an iframe tag and insert the Collaboration Hub URL as its source. Make sure to use a URL of the form https://editor.signavio.com/intralink/portal?t=<workspace ID > (European Server), https://app-us.signavio.com/intralink/portal?t=<workspace ID > (US server) or https://app-au.signavio.com/intralink/portal?t=<workspace ID > (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: https://editor.signavio.com/intralink/portal#model/<DiagramID>?usp=sharing. The example iframe below defines such a start diagram. To find the diagram link, open the corresponding diagram in Collaboration Hub and copy its URL.

When defining a start diagram, make sure that this 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.

An 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>

Next steps