Auto-link DevRev GitHub accounts
The Auto-link DevRev GitHub accounts snap-in links GitHub accounts to corresponding DevRev accounts at scale. The snap-in supports automatic creation of shadow users for inactive DevRev accounts and handles the conversion to active users upon their first login.
Features
- The system reads a CSV file containing user data.
- For each user, it checks if a DevRev account exists using the provided email (
saml_name_id). - If the user exists and is active, the GitHub account is linked directly.
- If the user does not exist or is inactive, a shadow user is created and the GitHub account is linked.
- Shadow users automatically convert to active users upon their first login.
- If the user does not exist or is inactive, a shadow user is created and the GitHub account is linked.
- Shadow users automatically convert to active users upon their first login.
Installation
Prerequisites
- Obtain the necessary CSV file containing user details.
Input requirements
The input CSV file should include the following columns. These are case-sensitive, but the order in which they appear is flexible:
| Column name | Type | Description |
|---|---|---|
| login | string | GitHub account identifier |
| saml_name_id | string | DevRev account email identifier |
Steps to Install and Configure
- Download the latest version of the snap-in from the DevRev marketplace.
- Upload the CSV file containing user details.
- Run the snap-in to process the file and link accounts.
- Verify the linked accounts in DevRev.
How to use the snap-in
- Use slash commands in the Events section.
- In the Discussion tab, type the slash commands.
- Run the snap-in using the
/link_github_accounts_to_devrevcommand in the snap-in discussion thread. - The columns
loginandsaml_name_idcan be in any order.