From 1bced97e0495023b2140396ec1370b3f93066c4d Mon Sep 17 00:00:00 2001 From: Miroslav Prasil Date: Mon, 3 Sep 2018 10:53:52 +0100 Subject: [PATCH 1/2] Add info on running over HTTP (documentation for #153) --- README.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/README.md b/README.md index 37918219..1447c807 100644 --- a/README.md +++ b/README.md @@ -48,6 +48,7 @@ _*Note, that this project is not associated with the [Bitwarden](https://bitward - [Changing user email](#changing-user-email) - [Creating organization](#creating-organization) - [Inviting users into organization](#inviting-users-into-organization) + - [Running on unencrypted connection](#running-on-unencrypted-connection) - [Get in touch](#get-in-touch) ## Features @@ -366,6 +367,12 @@ We use upstream Vault interface directly without any (significant) changes, this The users must already be registered on your server to invite them, because we can't send the invitation via email. The invited users won't get the invitation email, instead they will appear in the interface as if they already accepted the invitation. Organization admin then just needs to confirm them to be proper Organization members and to give them access to the shared secrets. +### Running on unencrypted connection + +It is strongly recommended to run bitwarden_rs service over HTTPS. However the server itself while supporting it does not strictly require such setup. This makes it a bit easier to spin up the service in cases where you can generally trust the connection (internal and secure network, access over VPN,..) or when you want to put the service behind HTTP proxy, that will do the encryption on the proxy end. + +Running over HTTP is still reasonably secure provided you use really strong master password and that you avoid using web Vault over connection that is vulnerable to MITM attacks where attacker could inject javascript into your interface. However some forms of 2FA might not work in this setup and [Vault doesn't work in this configuration in Chrome](https://github.com/bitwarden/web/issues/254). + ## Get in touch To ask an question, [raising an issue](https://github.com/dani-garcia/bitwarden_rs/issues/new) is fine, also please report any bugs spotted here. From 53e8f78af600faf8eb813a3364ac7c48353dc8fc Mon Sep 17 00:00:00 2001 From: Miroslav Prasil Date: Mon, 3 Sep 2018 10:59:59 +0100 Subject: [PATCH 2/2] Link to the https setup --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1447c807..358941a9 100644 --- a/README.md +++ b/README.md @@ -369,7 +369,7 @@ The users must already be registered on your server to invite them, because we c ### Running on unencrypted connection -It is strongly recommended to run bitwarden_rs service over HTTPS. However the server itself while supporting it does not strictly require such setup. This makes it a bit easier to spin up the service in cases where you can generally trust the connection (internal and secure network, access over VPN,..) or when you want to put the service behind HTTP proxy, that will do the encryption on the proxy end. +It is strongly recommended to run bitwarden_rs service over HTTPS. However the server itself while [supporting it](#enabling-https) does not strictly require such setup. This makes it a bit easier to spin up the service in cases where you can generally trust the connection (internal and secure network, access over VPN,..) or when you want to put the service behind HTTP proxy, that will do the encryption on the proxy end. Running over HTTP is still reasonably secure provided you use really strong master password and that you avoid using web Vault over connection that is vulnerable to MITM attacks where attacker could inject javascript into your interface. However some forms of 2FA might not work in this setup and [Vault doesn't work in this configuration in Chrome](https://github.com/bitwarden/web/issues/254).