Connecting Vanta & Bob

  • Updated

By creating a service user in Bob, you can connect Vanta to easily import employee status information, allowing you to monitor start & end dates of your team. 

Vanta only requires base-level permissions to access the data it needs, using a permission group that applies to all employees, not just active one. 

 

Prerequisites

 

  • Admin permissions in Vanta
  • Admin Permissions in Bob
    • Permissions in Bob can be checked by navigating to your Profile, and clicking on the 'Permissions' tag next to the action dropdown

Screenshot_2023-04-26_at_3.50.39_pm.png

 

Procedure

 

  • In your Vanta dashboard, navigate to the Integrations page and click on the 'Available' tab. Search for Bob, then click 'Connect'

    Screenshot_2023-04-26_at_3.40.42_pm.png
    Note: The connection module will appear with redirect links to the Bob dashboard, allowing you to Login

  • In the Bob dashboard, click on 'Settings' button from the left hand menu, then 'Integrations'

Screenshot_2023-05-03_at_11.31.07_am.png

  • From the Integrations page, click on 'Service Users'

Screenshot_2023-05-03_at_11.33.28_am.png

  • Click on "New Service User

Screenshot_2023-04-26_at_3.54.53_pm.png

  • In the popup, enter 'Vanta' for both the Service user name & Display name, then click next

Screenshot_2023-04-26_at_4.00.39_pm.png

  • This will generate your API credentials.
    Important: Copy both the ID and Token but do not save them in Vanta yet. There is no way to retrieve the Token again so be sure to paste it in a notepad where it can be deleted afterwards.

Screenshot_2023-04-26_at_4.04.21_pm.png

  • Once you have copied the ID & Token, click Done. Click on the 'Settings' icon from the left menu, then 'Permissions Groups'.

Screenshot_2023-05-03_at_11.38.30_am.png

  • Click on 'Create Group'

Screenshot_2023-04-26_at_4.07.45_pm.png

  • Enter the group name as 'Vanta Permission Group'
    Under 'Group Members' enable 'Select people by Condition' > click on 'Edit'

Screenshot_2023-04-26_at_4.09.46_pm.png

  • The condition 'Lifecycle status' will be added by default. Hovering near the last box should give you a delete option > Delete this condition

Screenshot_2023-04-26_at_4.11.12_pm.png

  • Click on the dropbox under 'Add Specific Employees', and search for the Vanta user previously created. Select and click apply.

Screenshot_2023-04-26_at_4.13.54_pm.png

  • Then click the apply button again and click 'Create' to create the group. You'll receive a prompt to confirm that you're adding 1 person to this group, which you can confirm.

Screenshot_2023-04-26_at_4.15.08_pm.png

  • You should be automatically redirected to the settings for the new group. Click on the tab 'Peoples Data', then under the Access Rights section click on 'People'

Screenshot_2023-05-03_at_11.46.18_am.png

  • Enable the following permissions (some of these permissions may already be enabled by default): 

    • View selected employees' About sections
    • View selected employees' Basic info sections
    • View selected employees' Lifecycle sections
    • View selected employees' Work sections
    • View selected employees' Work contact details sections


  • Click Save. You will be presented with a summary of changes that you can review and cross check that everything has been set correctly. Click Apply

Screenshot_2023-04-26_at_4.20.20_pm.png

  • Navigate back to Vanta, and enter the Service ID & Token previously generated, then click store token. You should be presented with a pop-up confirming the connection with an option to configure scope

Screenshot_2023-04-26_at_4.22.43_pm.png

 

 

Additional Resources

Was this article helpful?

Have more questions? Submit a request