Bitwarden Directory Connector is a desktop application designed to synchronize Bitwarden enterprise organizations with existing user directories. This tool enables seamless integration between Bitwarden and popular directory services such as Active Directory, LDAP-based systems, Microsoft Entra ID, G Suite (Google), and Okta.
Key Features:
Cross-directory support for widely used platforms like Active Directory and Okta.
Command-line interface (CLI) tool for advanced configuration and automation.
Compatibility with Windows, macOS, and Linux distributions.
Detailed documentation and self-help resources available to guide users through setup and management.
Secure synchronization of user accounts and groups between directories.
Ideal for IT administrators managing large organizations, Bitwarden Directory Connector streamlines the process of integrating Bitwarden with existing directory services. This integration ensures consistent user access management and reduces manual configuration efforts. The application can be installed via winget, making it easy to deploy across supported operating systems.
README
Bitwarden Directory Connector
The Bitwarden Directory Connector is a desktop application used to sync your Bitwarden enterprise organization to an existing directory of users and groups.
Supported directories:
Active Directory
Any other LDAP-based directory
Microsoft Entra ID
G Suite (Google)
Okta
The application is written using Electron with Angular and installs on Windows, macOS, and Linux distributions.
Command-line Interface
A command-line interface tool is also available for the Bitwarden Directory Connector. The Directory Connector CLI (bwdc) is written with TypeScript and Node.js and can also be run on Windows, macOS, and Linux distributions.
CLI Documentation
The Bitwarden Directory Connector CLI is self-documented with --help content and examples for every command. You should start exploring the CLI by using the global --help option:
bwdc --help
This option will list all available commands that you can use with the Directory Connector CLI.
Additionally, you can run the --help option on a specific command to learn more about it:
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 windows-build-tools through . See more at .
npm install
npm run reset # Only necessary if you have previously run the CLI app
npm run rebuild
npm run electron
Run the CLI
npm install
npm run reset # Only necessary if you have previously run the desktop app
npm run build:cli:watch
You can then run commands from the ./build-cli folder:
node ./build-cli/bwdc.js --help
We're Hiring!
Interested in contributing in a big way? Consider joining our team! We're hiring for many positions. Please take a look at our Careers page to see what opportunities are currently open as well as what it's like to work at Bitwarden.
Contribute
Code contributions are welcome! Please commit any pull requests against the master branch. Learn more about how to contribute by reading the CONTRIBUTING.md file.
Security audits and feedback are welcome. Please open an issue or email us privately if the report is sensitive in nature. You can read our security policy in the SECURITY.md file.
Prettier
We recently migrated to using Prettier as code formatter. All previous branches will need to updated to avoid large merge conflicts using the following steps:
Check out your local Branch
Run git merge 225073aa335d33ad905877b68336a9288e89ea10
Resolve any merge conflicts, commit.
Run npm run prettier
Commit
Run git merge -Xours 096196fcd512944d1c3d9c007647a1319b032639
Push
Git blame
We also recommend that you configure git to ignore the prettier revision using:
