Displaying the Connect Portal
Connect to your users' app accounts with the Connect Portal
Once an integration has been added to the Paragon dashboard, you can now display the Connect Portal for that integration in your application. The Connect Portal is a component that your users interact with to connect their third-party app accounts to your application. The Connect Portal provides a fully managed authentication so you don't need to worry about managing, storing, or refreshing your customers' credentials.
.authenticateshould be called at the beginning of your application's lifecycle in all cases. This is to make sure that the
userTokenis always as fresh as possible, with respect to your user's existing session on your own site. You may reference Installing the Connect SDK for a detailed explanation on how to use
// You can find your project ID in the Overview tab of any Integration
// See Setup for how to encode your user token
.authenticatehas been called and the Promise it returns has resolved, you can call
.connectto launch your Connect Portal for a specific integration provider. You can find the
integrationTypeidentifier you need in the Overview page for the integration.
You must have an integration configured of this
integrationTypefor the Portal to appear. Otherwise, this function does nothing.
Once your user connects their third-party app account in the Connect Portal, you can access their app account by creating Workflows or via the Paragon API. You can always call
.getUserto retrieve the currently authenticated user and their connected integration state.