Set up a Twingate connector
Capabilities
Resource | Sync | Provision |
---|---|---|
Accounts | ✅ | |
Groups | ✅ | ✅ (locally created groups only) |
Roles | ✅ |
Gather Twingate credentials
Configuring the connector requires you to pass in credentials generated in Twingate. Gather these credentials before you move on.
A user with the Admin role in Twingate must perform this task.
Generate a new API key
Log into Twingate as an Admin user and click Settings.
Click API.
Click Generate Token. Give the API token a label, such as ConductorOne.
Select the appropriate permission level for the API key:
- Read only to run access reviews on your Twingate users.
- Read & Write to provision group membership via ConductorOne and run access reviews.
Click Generate. (Setting the Allowed Range is not required.)
The new API key is generated for you. Click Copy and save the key.
That’s it! Next, move on to the connector configuration instructions.
Configure the Twingate connector
To complete this task, you’ll need:
- The Connector Administrator or Super Administrator role in ConductorOne
- Access to the set of Twingate credentials generated by following the instructions above
Follow these instructions to use a built-in, no-code connector hosted by ConductorOne.
In ConductorOne, navigate to Admin > Connectors and click Add connector.
Search for Twingate and click Add.
Choose how to set up the new Twingate connector:
Add the connector to a currently unmanaged app (select from the list of apps that were discovered in your identity, SSO, or federation provider that aren’t yet managed with ConductorOne)
Add the connector to a managed app (select from the list of existing managed apps)
Create a new managed app
Set the owner for this connector. You can manage the connector yourself, or choose someone else from the list of ConductorOne users. Setting multiple owners is allowed.
If you choose someone else, ConductorOne will notify the new connector owner by email that their help is needed to complete the setup process.
Click Next.
Find the Settings area of the page and click Edit.
Paste the API key you into the API key field.
In the Domain field, enter your Twingate domain.
For example, if your Twingate instance address is
sampledomain.twingate.com
, enter sampledomain in the Domain field.Click Save.
The connector’s label changes to Syncing, followed by Connected. You can view the logs to ensure that information is syncing.
That’s it! Your Twingate connector is now pulling access data into ConductorOne.
Follow these instructions to use a connector, hosted and run in your own environment.
Self-hosted connector not currently available.