From 502b17c3af7db0d813573ccc4bddffc965a20fdf Mon Sep 17 00:00:00 2001 From: fred_the_tech_writer <69817454+fschillingeriv@users.noreply.github.com> Date: Mon, 25 Jan 2021 21:11:36 -0500 Subject: [PATCH] b.e. updates (#373) --- _articles/account/biometrics.md | 26 +++++++++++++++-------- _articles/getting-started/releasenotes.md | 23 +++++++++++--------- 2 files changed, 30 insertions(+), 19 deletions(-) diff --git a/_articles/account/biometrics.md b/_articles/account/biometrics.md index 4720d3b6..406b5f84 100644 --- a/_articles/account/biometrics.md +++ b/_articles/account/biometrics.md @@ -62,20 +62,28 @@ Once Biometric Unlock is enabled, a new button will be presented on the Unlock s ## Browser Extensions -{% callout warning %} -Version 1.48.0 of the browser extension enables Unlock with Biometrics, if you have at least version 2021-01-19 of the desktop app. - -Note that when your browser updates to this version, you may be asked to accept a new permission called "communicate with cooperating native applications" (in Chromium-based browsers), or "exchange messages with programs other than Firefox." If you don't accept this permission, the extension will remain disabled. - -This permission, also known as `nativeMessaging`, is safe to accept and enables the browser extension to communicate with the Bitwarden desktop app, which is required to enabled Unlock with Biometrics, as described in this section. -{% endcallout%} - -Biometric Unlock is supported for **Firefox** and **Chromium-based** (i.e. Chrome, Edge) Bitwarden Browser Extensions by integration with a native Bitwarden Desktop App. Through the Desktop App's access to Biometric APIs, Browser Extensions support Biometric Unlock: +Biometric Unlock is supported for **Chromium-based** (e.g. Chrome, Edge) Bitwarden Browser Extensions by integration with a native Bitwarden Desktop App (the Desktop App must also be running the latest version). Through the Desktop App's access to Biometric APIs, Browser Extensions support Biometric Unlock: - For **Windows**, via [Windows Hello](https://docs.microsoft.com/en-us/windows-hardware/design/device-experiences/windows-hello){:target="\_blank"} using PIN, Facial Recognition, or [other hardware that meets Windows Hello biometric requirements](https://docs.microsoft.com/en-us/windows-hardware/design/device-experiences/windows-hello-biometric-requirements){:target="\_blank"}. - For **macOS**, via [Touch ID](https://support.apple.com/en-us/HT207054){:target="\_blank"}. +{% callout note %} +**Biometric Unlock is currently not available for:** + +- Firefox Browser Extensions (keep tabs on the required up-stream enhancement to make `nativeMessaging` optional [here](https://bugzilla.mozilla.org/show_bug.cgi?id=1630415){:target="\_blank"}). +- Microsoft App Store Desktop Apps (a side-loaded Windows Desktop App, available at [bitwarden.com/download](https://bitwarden.com/download){:target="\_blank"} will work fine). +- Side-loaded MacOS Desktop Apps (an App Store Desktop app will work fine). + +In the cases of FireFox and the Microsoft App Store, this is due to native messaging limitations (see [Native Messaging Permissions](#native-messaging-permissions)). In all cases, Bitwarden team is investigating and will provide updates as things progress. +{% endcallout %} + The Bitwarden Desktop Application must be installed, logged in, and running in order to use Biometric Unlock in a Browser Extension. Additionally, you will need to [enable Biometric Unlock in the desktop app](#enable-biometric-unlock-in-desktop) before proceeding. +### Native Messaging Permissions + +When your Chromium-based Browser Extension updates to the version that supports Biometric Unlock (v1.48.0), you may be asked to accept a new permission for Bitwarden to `Communicate with cooperating native applications`. This permission is safe, but **optional**, and will enable the Browser Extension to communicate with the Bitwarden Desktop App, which is required to enable Biometric Unlock, as described above. + +Declining this permission will allow you to use v1.48.0 as normal, without Biometric Unlock functionality. + ### Enable Biometric Unlock for Browser Extensions Complete the following steps to enable Biometric Unlock in your Browser Extension: diff --git a/_articles/getting-started/releasenotes.md b/_articles/getting-started/releasenotes.md index 7cee74de..6b955f74 100644 --- a/_articles/getting-started/releasenotes.md +++ b/_articles/getting-started/releasenotes.md @@ -21,20 +21,23 @@ Bitwarden believes source code transparency is an absolute requirement for secur ## Release Announcements -{% callout info %} -**Unlock with Biometrics now works in browser extensions.** +**Dates on this page represent Cloud Server and Web releases.** Bitwarden incrementally updates each client application (Desktop, Browser Extension, Mobile, etc.) following the initial release date to ensure feature efficacy and stability. As a result, client applications should expect listed features following the initial release. -This is available from v1.48.0 of the browser extension, if you have at least version 2021-01-19 of the desktop app. +To be notified of Release Announcements, subscribe to the Bitwarden Status RSS feed: -Note that when your browser updates to this version, you may be asked to accept a new permission called "communicate with cooperating native applications," or "exchange messages with programs other than Firefox." This permission is safe to accept, and enables the browser extension to communicate with the Bitwarden desktop app, which is required to enabled Unlock with Biometrics. - -See the [documentation](https://bitwarden.com/help/article/biometrics/#browser-extensions) for more details on how to enable this feature. -{% endcallout %} +## 2021-01-19 Post-Release Update {% callout info %} -**Dates on this page represent Cloud Server and Web releases.** Bitwarden incrementally updates each client application (Desktop, Browser Extension, Mobile, etc.) following the initial release date to ensure feature efficacy and stability. +Biometric Unlock for Browser Extensions is available for **only Chromium-based browsers** (e.g. Chrome, Edge) with v1.48.0 of the Browser Extension, provided you have the latest version (2021-01-19) of the Desktop App. -As a result, client applications should expect listed features following the initial release. +When your Browser Extension updates to this version, you may be asked to accept a new permission for Bitwarden to `Communicate with cooperating native applications`. This permission is safe, but **optional**, and will enable the Browser Extension to communicate with the Bitwarden Desktop App, which is required to enable Biometric Unlock (see [here](https://bitwarden.com/help/article/biometrics/#browser-extensions) for details). Declining this permission will allow you to use v1.48.0 without Biometric Unlock functionality. + +**Biometric Unlock is currently not available for:** +- Firefox Browser Extensions (keep tabs on the required up-stream enhancement to make `nativeMessaging` optional [here](https://bugzilla.mozilla.org/show_bug.cgi?id=1630415){:target="\_blank"}). +- Microsoft App Store Desktop Apps (a side-loaded Windows Desktop App, available at [bitwarden.com/download](https://bitwarden.com/download){:target="\_blank"} will work fine). +- Side-loaded MacOS Desktop Apps (an App Store Desktop app will work fine). + +The Bitwarden team is investigating these and will provide updates as things progress. {% endcallout %} ## 2021-01-19 @@ -43,7 +46,7 @@ For the first major release of 2021, the Bitwarden team combined multiple major - **Encrypted Exports**: Personal users and Organizations can now export Vault data in an encrypted `.json` file (see [here]({% link _articles/importing/encrypted-export.md %}) for details). - **New Role**: A Custom role is now available to allow for granular control over user permissions (see [here](https://bitwarden.com/help/article/user-types-access-control/#custom-role) for details). - **New Enterprise Policy**: The Personal Ownership policy is now available for use by Enterprise Organization (see [here](https://bitwarden.com/help/article/policies/#personal-ownership) for details). -- **Biometric Unlock for Browser Extensions**: Using an integration with a native Desktop application, you can now use Biometric input to unlock Firefox and Chromium-based Browser Extensions (see [here](https://bitwarden.com/help/article/biometrics/#browser-extensions) for details). +- **Biometric Unlock for Browser Extensions**: Using an integration with a native Desktop application, you can now use Biometric input to unlock Chromium-based Browser Extensions (see [here](https://bitwarden.com/help/article/biometrics/#browser-extensions) for details). ## 2020-11-12 The latest release of Bitwarden adds SSO-related enhancements to all client applications, including: