iframe

Iframe allows to embed Improvado’s mechanism of creating datasource and destination connections in a safe way (including credentials passing). Datasources and destinations have different connection flows and attributes, Improvado handles this and has embedded all supported flows into iframe. In order to create a new connection within Improvado; call Get iframe url API, embed the iframe into your website so your customers can sign in to a datasource or setup destination connection parameters. After that you will be able to extract and load data using created connections.

Account selection

By default the iframe creates the connection as soon as the user authorizes, and that connection syncs every account the credentials give access to.

Append show_account_selection=True to the returned URL to split the flow into two steps instead:

1. Authorization — the user signs in to the data source. No connection is created yet.
2. Account selection — the accounts reachable with those credentials are listed, and the user either syncs all of them or picks specific ones. The connection is created from that choice.

The ConnectionCreated message is posted to the parent window only after the second step, so the connection always exists by the time your page is notified.

Add the parameter yourself — this endpoint does not emit it:

Code
https://embedded.improvado.io/api/v3/iframe/?code=<str>&type=datasource&name=jira&show_account_selection=True

Not every data source can list accounts before the connection exists. Where it cannot, the iframe falls back to the default single-step flow and the parameter has no effect.