A tool for syncing a directory (AD, LDAP, Azure, G Suite, Okta) to an organization.

bitwarden typescript angular electron directory active-directory ldap okta gsuite azure-ad

Kyle Spearrin 0d8b942ad4 npm audit fix		5 years ago
.github	adding the build assets for the rc branch (#98 )	5 years ago
.vscode	Lock lowdb file (#95 )	5 years ago
jslib@78d40d9f18	Bump jslib (#108 )	5 years ago
resources	disable-library-validation entitlement	6 years ago
scripts	Migrate to gh actions (#89 )	5 years ago
src	Bump jslib (#108 )	5 years ago
src-cli	Update electron to 11.1.1 (#85 )	5 years ago
.editorconfig	settings configuration	8 years ago
.gitattributes	stub out projects for the solution	9 years ago
.gitignore	notarize directory connector	6 years ago
.gitmodules	stub out electron app	8 years ago
CONTRIBUTING.md	stub out directory services	8 years ago
ISSUE_TEMPLATE.md	stub out directory services	8 years ago
LICENSE.txt	stub out directory services	8 years ago
README.md	Update README.md	5 years ago
SECURITY.md	Uppercase Bitwarden	8 years ago
gulpfile.js	update gulp to 4.0.0	7 years ago
package-lock.json	npm audit fix	5 years ago
package.json	update libs	5 years ago
tsconfig.json	add allowSyntheticDefaultImports in tsconfig	5 years ago
tslint.json	Update to commander 7 (#94 )	5 years ago
webfonts.list	switch to gulp file to get google fonts	7 years ago
webpack.cli.js	stub out cli for directory connector	7 years ago
webpack.main.js	update jslib	7 years ago
webpack.renderer.js	update webpack to use MiniCssExtractPlugin	6 years ago

README.md

Bitwarden Directory Connector

The Bitwarden Directory Connector is a 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
Azure Active Directory
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:

bwdc test --help
bwdc config --help

Detailed Documentation

We provide detailed documentation and examples for using the Directory Connector CLI in our help center at https://help.bitwarden.com/article/directory-sync/#command-line-interface.

Build/Run

Requirements

Node.js
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 npm. See more at Compiling native Addon modules.

Run the app

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

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.