A connection in integrator.io is a resource record that contains information about how to connect to a certain application. Connections store the the username and password (or API key) to connect and communicate with the application.
Account owners and administrators can access all connections in an account, but users who only have access to specific integrations in an account can only access the connections for the integrations they have access to. If a user needs to use a connection that has been created outside of the integration they have access to, this connection must first be registered with the integration before they can use it to build flows.
If multiple exports and imports across integrations use a given connection, any connection that is registered with an integration will also give access to the exports and imports referencing that connection. This means that a user that has access to integration A can get access to individual exports and imports used in integration B and C, if exports and imports within integration B and C uses a connection that has been registered with integration A.
Note: Connection registration is applicable to flows in an integration. This feature does not apply to integration apps and standalone flows (those not attached to an integration). To attach a standalone flow to an integration, open the integration, navigate to the Flows tab, and click Attach flow.
Register an existing connection
Use the following steps to register an existing connection with an integration:
- Open and integration and click the Connections tab. This displays a list of all connections that are already registered with the integration. Any user with access to the integration can use these connections in flows within this integration.
- In the top right corner of the Connections tab, click Register connections. The Register connections window opens.
- Click the box to the left of the name of the connections that you want to register for the integration, then click Register. The newly registered connections are listed on the integration’s Connections tab, and are now available to use in any flow within the integration.
Register a new connection
Any connection that is created within the integration itself is always automatically registered with the integration, and available to use in any of its flow.
To use a connection that was created in another integration, follow the steps in Register an existing connection.
Automatic connection registration
When you create a flow in an integration and select connections for exports and imports, upon saving the flow, the selected connections are automatically registered with the integration. A reminder displays for you to alert other users.
A connection that is registered with an integration becomes available to all users with access to the integration. These users also have access to any export and import using that same connection, even if the exports and imports are not part of the same integration.
Deregister a connection
- Open an integration and click the Connections tab.
- Click the Actions overflow (...) menu for that connection and select Deregister connection.
Comments
You say that registering a connection is not applicable for standalone flows or integration apps. What else is there? Templates?
Hi METER Group,
Thanks for letting us know that this article could be made clearer! You can only register connections for flows that are currently in an integration (not for standalone flows which are not in an integration). This also isn't available for integration apps. We are planning to allow replacing connections on any flow, as well as adding connections for integration apps.
Does deregistering a connection do so just for the one integration on which you are working, and keep it for any other integrations in your account that may be using it?
Hi Limebox User,
I just tested this question. If you deregister a connection, it will remain active in any integrations that were using it before deregistration; however, new integrations that users create will not be able to use the deregistered connection when building flows.
I would benefit from a discussion on _when_ I would register a connection. I currently have about 45 connections, dating back 2 years. I create a new connection each time I refresh my sandbox, and I often can't delete the old ones because they are 'in use' somewhere.
Should I re-use old connections when I clone my celigo flows each time I refresh my sandboxes?
METER Group you make use of the used by option against a connection to know where they are being used.
Please sign in to leave a comment.