Overview

Bitwarden is an open-source password manager offering optional self- and cloud-hosting and native apps for macOS, Linux, Windows, iOS, and Android.

Available Integrations

Product	Supported Asset Type(s)	Integration Type
Bitwarden	Users	Source

Why You Should Integrate

This integration will provide visibility into your users in Bitwarden within the Sevco Security app. You will be able to see their basic contact information such as name and email, as well as what groups they belong to and what role they have within Bitwarden.

How does the Integration Work

This integration pulls all users within a Bitwarden organzation.

This data is only used internally; we do not share it with any parties outside of Sevco. Refer to our privacy policy for details.

⚠️
Please review the configuration instructions in the section below before setting up permissions for apps.

Configuration

Install a runner: Follow our instructions to install a runner if using an on-prem instance of Bitwarden
Choose an Access Schema: A schema is a configuration template that defines a specific way to connect, authenticate, and interact with a source. The following are the available schemas:
- Cloud Hosted: Will retrieve users from a cloud-hosted instance of Bitwarden
- Self Hosted: Will retrieve users from a self-hosted instance of Bitwarden
Configure the Access Schema:

Cloud Hosted

Field	Description	Example
Region*	The region you Bitwarden instance is hosted in	`us`
Client ID*	The organization-level client ID for accessing Bitwarden	`organization.0866b965-9cf6-4e77-bab6-07ab010ac660`
Client Secret*	The organization-level client secret for accessing Bitwarden	`VHmILJ6k1LZXpbOMp0X6oRvNQe4toY`

Self Hosted

Field	Description	Example
URL*	The base URL of your self-hosted Bitwarden instance. Ensure it does not have a `/api` suffix	`https://bitwarden.company.com`
Client ID*	The organization-level client ID for accessing Bitwarden	`organization.0866b965-9cf6-4e77-bab6-07ab010ac660`
Client Secret*	The organization-level client secret for accessing Bitwarden	`VHmILJ6k1LZXpbOMp0X6oRvNQe4toY`

Add an Integration: Select the integration(s) you'd like to add:

Collect users

Configure General Information: OPTIONAL: You can use the following fields to provide additional information about your configuration.

Field	Description	Example
`Name (optional)`	Uniquely identifiable attribute of the configuration to delineate other similar configurations with the existing organization.	`DMZ network`
`Contact Person (optional)`	A placeholder to input a name or email address of a contact associated with the integration.	`Jane Doe`
`Link to Console (optional)`	A placeholder to input a link to the console of the product Sevco is integrating with for quick reference and access when configuring or editing the integration.	`www.product.com/devices`
`Email me about frequent errors`	Select this toggle to receive an email whenever an Integration has a ≥30% error rate in a 24-hour period.	n/a

Activate Config: Select "Activate" to enable this configuration and begin pulling data.

External Documentation

Creating Credentials

You'll be asked to provide source credentials that Sevco will use to connect to Bitwarden. This link will step you through creating a client ID and secret.

Required Permissions

The following permissions will need to be enabled for your Client ID and Secret:

api.organization

API Documentation

The Bitwarden API Documentation for retrieving users can be found here.

Contact Us

If you're having problems configuring an Integration, or if you've found something wrong in this document, please email us at [email protected] or suggest edits directly by selecting the Suggest Edits link located in the upper right hand corner of the documentation.