The Bitwarden Directory Connector is a a desktop application used to sync your Bitwarden enterprise organization to an existing directory of users and groups.
Directory Connector receives fewer updates than the main clients. To reduce maintenance costs, it
Node.js v18 (LTS)
Windows users: To compile the native node modules used in the app you will need the Visual C++ toolset, available through the standard Visual Studio installer (recommended) or by installing
npm. See more at Compiling native Addon modules.
Clone the repository:
git clone https://github.com/bitwarden/directory-connector.git
Install the dependencies:
Run the app:
npm run electron
npm run build:cli:watch
You can then run commands from the
node ./bwdc.js --help
# Test sync
node ./bwdc.js test
# Real sync
node bwdc.js sync
Syncing from a directory service
To properly test Directory Connector, you'll need a directory to sync. We have instructions for setting up:
These are both LDAP directory services. If you need to test another type, you should be able to find a platform offering a free tier of that service.
If you need to test Active Directory (not Azure AD), contact the Integration Engineering team for remote access to a test AD instance.