Bitwarden
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.
Updated 5 months ago