Overview
Torii integrates with DX and syncs:
| User Fields | License Types |
|---|---|
| Status Role | DX |
- You can constantly stay updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table.
Requirements
To connect this integration, we require the following:
Accounts & Permissions
- A DX user with the Workspace Admin role, to create an organization token.
- An organization token with the users:read scope.
- Optional: add the users:write scope only if you want to use the Update DX user workflow action.
Required keys
- DX organization token
How to Generate the Required Values
Step 1: Create an organization token
- Sign in to DX as a Workspace Admin.
- Go to Admin >> Organization tokens.
- Create a new token (for example, named "Torii").
- Select the users:read scope. Add users:write only if you plan to use the Update DX user action.
- Save the token and copy its value.
Important
Select only the scopes listed above. Torii does not need any other DX scope.
How to Connect the Integration
- Go to the Integrations page in Torii.
- Search for DX and click Connect.
- Enter an Account Name and paste the Organization token.
- Click Connect.
Q&A
Q: Which DX users does Torii sync?
A: Torii syncs the users DX returns from its users API: users with a DX role, a team or group membership, a non-default user property, or entity ownership. Users that DX has deleted are shown with a Deleted status.
Q: Can Torii create or remove DX users?
A: No. The DX API has no method to create or delete users. DX creates users through directory sync, SSO or SCIM. Torii offers one workflow action, Update DX user, which sets a user's GitHub username, GitLab username or start date.
Q: What should I enter in the "Account Name" field?
A: The Account Name field lets you connect multiple DX accounts to Torii. The value can be anything you choose. It is only used to distinguish between your connected accounts. Make sure to use a unique Account Name for each account: connecting a different account with an Account Name that is already in use will overwrite the existing account's data, so choosing distinct names is your responsibility.
For any further questions, please contact Torii Support.