Iframe Mode via SSO

An increasingly common request we have is for software partners to be able to “iFrame” certain components of the product into their application in a similar way to how we built the integration in to QuickBooks Online.

The key to being able to do this is our support for “iframe” mode.

When you’re in iframe mode you don’t see any of the navigational elements such as breadcrumbs and menus.

To enable frameless mode, you can set the “navigation” property on the SSO request object like so

{
  "businessId":"100",
  "username": "john@test.com
  "navigation":"[VALUE]"
} 

The possible values for navigation are:

  • Full
  • Primary
  • Secondary
  • None

Specifying a particular value will hide the navigation elements of higher-level values. For example, specifying ‘Secondary’ will hide the ‘Primary’ and ‘Full’ navigation elements.

Please see the following screenshot for an understanding of what each of the navigation options mean.

Once this property is set, when the user is signed in, they’ll no longer see the higher-level navigational elements which will make it much nicer to iframe into.