From 9fa30a6cbaf35f8156dfa1a99ffb9e24b0434e0f Mon Sep 17 00:00:00 2001 From: Ian Date: Mon, 15 Apr 2019 10:32:54 -0700 Subject: [PATCH] Add LDAP instructions --- Syncing-users-from-LDAP.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 Syncing-users-from-LDAP.md diff --git a/Syncing-users-from-LDAP.md b/Syncing-users-from-LDAP.md new file mode 100644 index 0000000..7889ef4 --- /dev/null +++ b/Syncing-users-from-LDAP.md @@ -0,0 +1,11 @@ +# Syncing users from LDAP + +LDAP integration is performed using a small service that queries LDAP and invites users to your Bitwarden instance. This service is uncreatively named [bitwarden_rs_ldap](https://github.com/ViViDboarder/bitwarden_rs_ldap). + +It is not yet distributed as a binary, but there is an available Docker image [vividboarder/bitwarden_rs_ldap](https://hub.docker.com/r/vividboarder/bitwarden_rs_ldap). + +Before deploying, you must [enable your bitwarden_rs admin page](https://github.com/dani-garcia/bitwarden_rs/wiki/Enabling-admin-page). This is enables the API that the LDAP sync service will use to invite users. The `ADMIN_TOKEN` that you set will be used when configuring the LDAP sync service. You must also be sure to [**not** disable the invitation](https://github.com/dani-garcia/bitwarden_rs/wiki/Disable-invitations) capability. To verify this, double check that the environment variable `INVITATIONS_ALLOWED` is not set to `false`. + +It is also recommended to [enable email sending](https://github.com/dani-garcia/bitwarden_rs/wiki/SMTP-configuration) from your Bitwarden instance so that your users will be notified they can make an account. If you do not, they will still be able to register if they use their LDAP email address, but you will have to inform them on your own. + +With these steps done, you can configure and deploy the LDAP sync service. The most up-to-date instructions are to be found on the service [Readme](https://github.com/ViViDboarder/bitwarden_rs_ldap) itself, but it will involve creating the `config.toml` file with the connection info for your bitwarden_rs instance, your LDAP instance, as well as the LDAP query you'd like to use to find users. \ No newline at end of file