bitwarden/help
1
0
Fork 0
mirror of https://github.com/bitwarden/help synced 2025-12-06 00:03:30 +00:00
Code Issues Releases Wiki Activity

Buncha Stuff (#612)

Browse Source 
* clarification on where to find legacy mac .dmg

* tip for update email address

* code vetting security faq

* /managing-items/ refactor

* two-step login 'remember me' duration

* small updates, including denoting purpose of the globe icon

* additional tip for deleting users in a self-host org!

* uri component pieces

* encryption key edit

* importing cleanup

* notes re: importing on file attachements
This commit is contained in:
fred_the_tech_writer
2021-05-24 15:19:07 -04:00
committed by GitHub
parent e5458c349a
commit 104000dd8b
25 changed files with 299 additions and 147 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
_articles/account/account-encryption-key.md
View File

@@ -26,9 +26,9 @@ When you rotate an encryption key, you **must immediately** log out of any logge
**Making changes in a session with a "stale" encryption key will cause data corruption that will make your data unrecoverable.**
#### Re-download any Encrypted Exports
#### Re-create any Encrypted Exports
If you're using [Encrypted Exports]({% link _articles/importing/encrypted-export.md %}) to store long-term secure backups, you should immediately re-download the encrypted export of your Vault data using the new encryption key.
If you're using [Encrypted Exports]({% link _articles/importing/encrypted-export.md %}) to store long-term secure backups, you should immediately re-create the encrypted export of your Vault data using the new encryption key.
Encrypted Exports use your encryption key to encrypt **and decrypt** your Vault data, meaning that a rotated encryption key will not be able to decrypt an export created with the "stale" (prior-to-rotation) key.

2
_articles/account/install-safari-app-extension.md
View File

@@ -12,7 +12,7 @@ Bitwarden's Safari Web Extension is a port of the prior *App Extension* designed
{% callout info %}
Due to changes by Apple, Safari limits Web Extension use to **only those obtained through Mac App Store downloads**. As of the [2021-03-11 Release]({% link _articles/getting-started/releasenotes.md %}), users will not be able to use a Bitwarden Safari Extension obtained through a `.dmg` installation from [bitwarden.com/download](https://bitwarden.com/download){:target="\_blank"} or any other non-App Store source.
**If you're using a Safari version prior to 14**, you can continue using a `.dmg` installation, which can be downloaded from [bitwarden.com/download](https://bitwarden.com/download){:target="\_blank"}. Keeping the `.dmg` outside of the Applications folder should allow you to simultaneously use both an older Safari Extension and the latest Desktop App.
**If you're using a Safari version prior to 14**, you can continue using a `.dmg` installation, which can be downloaded from [bitwarden.com/download](https://bitwarden.com/download){:target="\_blank"} by clicking **more desktop installation options >**. Keeping the `.dmg` outside of the Applications folder should allow you to simultaneously use both an older Safari Extension and the latest Desktop App.
{% endcallout %}
The Safari Web Extension has full feature parity to the prior App Extension. For developer detail on the difference between Safari Web Extensions and App Extensions, click [here](https://developer.apple.com/documentation/safariservices/safari_web_extensions/converting_a_safari_app_extension_to_a_safari_web_extension?language=objc).

168
_articles/account/managing-items.md
View File

@@ -8,64 +8,150 @@ tags: [account, items, import, delete, trash, clone]
order: 03
---
Effectively managing the items in your Vault is key to making sure that you secure and have seamless access to your information, and can safely share information with friends, family, teams, and colleagues.
Effectively managing the items in your Vault is key to making sure that you secure and have seamless access to your information, and can safely share information with friends, family, teams, and colleagues. There are 4 types of items you can store in your Vault; Logins, Cards, Identities, and Secure Notes:
Bitwarden can store 4 types of items in your Vault:
- [Logins](#logins)
- [Cards](#cards)
- [Identities](#identities)
- [Secure Notes](#secure-notes)
## Add a Vault Item
You can add items to your Vault from the Bitwarden [Web Vault](https://vault.bitwarden.com){:target="\_blank"} or any client application. Look for a {% icon fa-plus %} **Add** icon to add an item to your Vault. There are 4 types of items you can add to your Vault.
All item types can be given:
- A **Name** that makes them easily identifiable to you inside your Vault.
- **Notes** related to the item in a freeform text input.
- **Custom Fields** for inputs like security questions or PINs (for more information, see [Custom Fields]({% link _articles/features/custom-fields.md %})).
{% callout success %}
You can also import items into your Vault from a variety of password management solutions. For more information, see [Import Data to your Vault]({% link _articles/importing/import-data.md %}).
{% endcallout %}
<ul class="nav nav-tabs" id="myTab" role="tablist">
<li class="nav-item" id="tab" role="presentation">
<a class="nav-link active" id="logintab" data-bs-toggle="tab" data-target="#logins" role="tab" aria-controls="logins" aria-selected="true">Logins</a>
</li>
<li class="nav-item" id="tab" role="presentation">
<a class="nav-link" id="cardtab" data-bs-toggle="tab" data-target="#cards" role="tab" aria-controls="cards" aria-selected="false">Cards</a>
</li>
<li class="nav-item" id="tab" role="presentation">
<a class="nav-link" id="identitytab" data-bs-toggle="tab" data-target="#identity" role="tab" aria-controls="identity" aria-selected="false">Identities</a>
</li>
<li class="nav-item" id="tab" role="presentation">
<a class="nav-link" id="notetab" data-bs-toggle="tab" data-target="#notes" role="tab" aria-controls="notes" aria-selected="false">Secure Notes</a>
</li>
</ul>
<div class="tab-content" id="clientsContent">
<div class="tab-pane show active" id="logins" role="tabpanel" aria-labelledby="logintab">
{% capture logins %}
### Logins
Refer to the following screenshot for help understanding all the values available for Login items:
Login items are most often used to store username and password combinations, and support [TOTP seeds]({{site.baseurl}}/article/authenticator-keys/) for Premium users. Whatever plan you're on, we recommend giving every Login a [URI for easy auto-fill]({{site.baseurl}}/article/uri-match-detection):
{% image /manage-items/login-item.png Add a Login%}
{% image /manage-items/login-item.png Login Vault Item %}
{% endcapture %}
{{ logins | markdownify }}
</div>
<div class="tab-pane" id="cards" role="tabpanel" aria-labelledby="cardtab">
{% capture cards %}
### Cards
Refer to the following screenshot for help understanding all the values available for Card items:
Card items can be used to store credit or debit card information:
{% image /manage-items/card-item.png Add a Card%}
{% image /manage-items/card-item.png Card Vault Item %}
{% endcapture %}
{{ cards | markdownify }}
</div>
<div class="tab-pane" id="identity" role="tabpanel" aria-labelledby="identitytab">
{% capture identities %}
### Identities
Refer to the following screenshot for help understanding all the values available for Identity items:
Identities can be used to store billing info, mailing info, or anything else you might need to have access to when filling out online forms:
{% image /manage-items/identity-item.png Add an Identity %}
{% image /manage-items/identity-item.png Identity Vault Item %}
{% endcapture %}
{{ identities | markdownify }}
</div>
<div class="tab-pane" id="notes" role="tabpanel" aria-labelledby="notetab">
{% capture notes %}
### Secure Notes
Refer to the following screenshot for help understanding all the values available for Secure Note items:
Secure Notes can be used to store encrypted freeform text for anything you want protected:
{% image /manage-items/note-item.png Add a Note%}
{% image /manage-items/note-item.png Secure Note Vault Item %}
{% endcapture %}
{{ notes | markdownify }}
</div>
</div>
{% callout success %}
You can import items into your Vault from a variety of password management solutions. For more information, see [Import Data to your Vault]({% link _articles/importing/import-data.md %}).
{% endcallout %}
## Manage Vault Items
You can add, edit, and delete Vault items from any Bitwarden client application:
<ul class="nav nav-tabs" id="myTab" role="tablist">
<li class="nav-item" id="tab" role="presentation">
<a class="nav-link active" id="wvtab" data-bs-toggle="tab" data-target="#wv" role="tab" aria-controls="wv" aria-selected="true">Web Vault</a>
</li>
<li class="nav-item" id="tab" role="presentation">
<a class="nav-link" id="betab" data-bs-toggle="tab" data-target="#be" role="tab" aria-controls="be" aria-selected="false">Browser Extensions</a>
</li>
<li class="nav-item" id="tab" role="presentation">
<a class="nav-link" id="mobtab" data-bs-toggle="tab" data-target="#mob" role="tab" aria-controls="mob" aria-selected="false">Mobile</a>
</li>
<li class="nav-item" id="tab" role="presentation">
<a class="nav-link" id="desktab" data-bs-toggle="tab" data-target="#desk" role="tab" aria-controls="desk" aria-selected="false">Desktop</a>
</li>
<li class="nav-item" id="tab" role="presentation">
<a class="nav-link" id="clitab" data-bs-toggle="tab" data-target="#cli" role="tab" aria-controls="cli" aria-selected="false">CLI</a>
</li>
</ul>
<div class="tab-content" id="clientsContent">
<div class="tab-pane show active" id="wv" role="tabpanel" aria-labelledby="wvtab">
{% capture wv %}
### Web Vault
{% image /manage-items/manage-webvault.png Manage an Item %}
{% endcapture %}
{{ wv | markdownify }}
</div>
<div class="tab-pane" id="be" role="tabpanel" aria-labelledby="betab">
{% capture be_sync %}
### Browser Extensions
{% image /manage-items/manage-be.png Manage an Item %}
{% endcapture %}
{{ be_sync | markdownify }}
</div>
<div class="tab-pane" id="mob" role="tabpanel" aria-labelledby="mobtab">
{% capture mob_sync%}
### Mobile Apps
{% image /manage-items/manage-mobile-1.png Add or Open an Item %}
{% image /manage-items/manage-mobile-2.png Manage an Item %}
{% endcapture %}
{{ mob_sync | markdownify }}
</div>
<div class="tab-pane" id="desk" role="tabpanel" aria-labelledby="desktab">
{% capture desk_sync%}
### Desktop Apps
{% image /manage-items/manage-desktop.png Manage an Item %}
{% endcapture %}
{{ desk_sync | markdownify }}
</div>
<div class="tab-pane" id="cli" role="tabpanel" aria-labelledby="clitab">
{% capture cli_sync%}
### CLI
For more information, refer to our [CLI documentation]({% link _articles/miscellaneous/cli.md %}).
{% endcapture %}
{{ cli_sync | markdownify }}
</div>
</div>
### Folders and Favorites
Items in your personal Vault can be organized into Folders, or marked as Favorites. For more information, see [Folders]({% link _articles/features/folders.md %}) and [Favorites]({% link _articles/features/favorites.md %}).
## Delete a Vault Item
You can delete any Vault items directly from the [Web Vault](https://vault.bitwarden.com){:target="\_blank"} or from any client application:
- In the [Web Vault](https://vault.bitwarden.com){:target="\_blank"}, select **Delete** from the hover-over {% icon fa-cog %} **Gear** dropdown.
- On Mobile Applications, open the item and tap **Delete** in the {% icon fa-ellipsis-v %} **Menu**.
- On Desktop Applications and Browser Extensions, open the item and select the {% icon fa-trash %} **Delete** icon.
Before an item is deleted, you will be prompted to confirm deletion. Once confirmed, the item will be placed into the Trash.
Items in your Vault can be organized into Folders, or marked as Favorites. For more information, see [Folders]({% link _articles/features/folders.md %}) and [Favorites]({% link _articles/features/favorites.md %}).
### Items in the Trash
@@ -75,11 +161,11 @@ In the Trash, you can **Restore** an item to your Vault or **Permanently Delete*
{% image /manage-items/item-trash-restore-delete.png The Trash %}
## Share a Vault Item
## Share Vault Items
If you're a member of an Organization, you can share a Vault item with the other members of your Organization. For more information, see [Share Items to a Collection]({% link _articles/organizations/share-to-a-collection.md %}).
If you're a member of an [Organization]({{site.baseurl}}/article/about-organizations/), you can share Vault items with other members of your Organization. Learn more about [Organizations]({{site.baseurl}}/article/about-organizations/), [Collections]({{site.baseurl}}/article/about-collections), and [Sharing]({{site.baseurl}}/article/share-to-a-collection/).
## Clone a Vault Item
## Clone Vault Items
You can clone any Vault item that you have **Ownership** of, if you wish to create a duplicate of the item.

8
_articles/faqs/product-faqs.md
View File

@@ -25,16 +25,16 @@ This article contains Frequently Asked Questions (FAQs) about general Vault Mana
### Q: How do I change my email address?
**A:** You can change the email address attached to your account from the [Web Vault](https://vault.bitwarden.com){:target="\_blank"}:
**A:** To change the email address attached to your account:
1. In the Web Vault, select **Settings** from the top navigation bar.
1. Open the [Web Vault](https://vault.bitwarden.com){:target="\_blank"}, select **Settings** from the top navigation bar.
2. On the **My Account** page, find the **Change Email** section.
3. Enter your current **Master Password** to prove you have the authority to take this action, and specify the **New Email** you'd like to change to.
4. Select the **Change Email** button.
Bitwarden will email a verification code to the specified email address. Check your inbox for the code and enter it into the **Code** text input displayed in your Web Vault to finalize the change.
Bitwarden will email a verification code to the specified email address. Check your inbox for the code and enter it into the **Code** text input displayed in your Web Vault to finalize the change. If you don't receive the verification code, check your Spam folder. You can also whitelist `no-reply@bitwarden.com` to help ensure delivery in the future.
{% callout success %}If you don't receive the verification code from Bitwarden, check your Spam folder. You can also whitelist `no-reply@bitwarden.com` to help ensure delivery in the future.{% endcallout %}
{% callout success %}**If you have a paid subscription,** also [Contact Us](https://bitwarden.com/contact){:target="\_blank"} to let us know about the change so that we change your billing information.{% endcallout %}
When you change your email address, you should immediately logout of all Bitwarden client applications you use, and log back in with the new credentials. Sessions using a "stale" email address will eventually be logged out eventually.

4
_articles/faqs/security-faqs.md
View File

@@ -78,6 +78,10 @@ Bitwarden takes user security and privacy seriously. Bitwarden maintains secure,
**A:** See [Certificate Options]({% link _articles/hosting/certificates.md %}) for a complete list and instructions.
### Q: How does Bitwarden vet code changes?
**A:** Confidence in the security of our systems is of utmost important to Bitwarden. All proposed code changes are reviewed by one or more non-author members of the team before they can be merged into any codebase. All code goes through multiple test and QA environments prior to production. Bitwarden has implemented a SOC2 report to audit and validate our internal procedures. As mentioned in the report, our team is subject to rigorous background check and thorough interview processes. Bitwarden, being an open-source product, also welcomes peer-review of our code at any point. The team at Bitwarden strives to do everything we can to keep our users comfortable, and keeping their data secure. 
### Questions Regarding Specific Client Apps
### Q: What data does Bitwarden use from client applications?

4
_articles/features/uri-match-detection.md
View File

@@ -35,7 +35,9 @@ An easy way to obtain the proper URI for an Android app is to **use a web browse
## Match Detection Options
Each URI assigned to a Login item has an associated **Match Detection** option. This option determines when and whether Bitwarden will offer the Login as an available option for auto-fill.
Each URI assigned to a Login item has an associated **Match Detection** option. This option determines when and whether Bitwarden will offer the Login as an available option for auto-fill, typically determined by matching against specific component pieces. The following graphic breaks down component pieces of a URI:
{% image autofill/urlgraphic.png %}
### Default match detection

13
_articles/importing/import-data.md
View File

@@ -18,26 +18,27 @@ For a full list of supported import formats, see [What file formats does Bitward
- [Import from Google Chrome]({% link _articles/importing/import-from-chrome.md %})
- [Import from Password Safe]({% link _articles/importing/import-from-passwordsafe.md %})
## Import to your Personal Vault
Importing data to Bitwarden **can only be done from the** [**Web Vault**](https://vault.bitwarden.com){:target="\_blank"}.
{% callout success %}
**Not already signed up?** Choose from one of [Bitwarden's plans](https://bitwarden.com/pricing/business/){:target="\_blank"} and get started today:
<a role="button" class="btn btn-primary" href="https://vault.bitwarden.com/#/register" target="blank">Create Your Free Account</a>
{% endcallout %}
To import your data:
## Import to your Personal Vault
Importing data to Bitwarden **can only be done from the** [**Web Vault**](https://vault.bitwarden.com){:target="\_blank"}. To import your data:
1. In the Web Vault, select **Tools** from the top navigation bar.
2. Select **Import Data** from the left-hand Tools menu.
3. From the format dropdown, choose a **File Format** (see [What file formats does Bitwarden support for import?]({{site.baseurl}}/article/import-faqs/#q-what-file-formats-does-bitwarden-support-for-import)).
5. Select the **Choose File** button and add the file to import.
5. Select the **Choose File** button and add the file to import or **copy/paste** the contents of your file into the input box.
{% callout warning %}Import to Bitwarden can't check whether items in the file to import are duplicative of items in your Vault. This means that **importing multiple files will create duplicative** Vault items if an item is already in the Vault and in the file to import.{% endcallout %}
6. Select the **Import Data** button to complete your import.
7. After successful import, delete the import source file from your computer. This will protect you in the event your computer is compromised.
Currently, file attachments are not included in Bitwarden import operations and will need to be uploaded to your Vault manually. For more information, see [File Attachments]({{site.baseurl}}/article/attachments/#attach-a-file).
## Troubleshooting

20
_articles/importing/import-from-1password.md
View File

@@ -31,21 +31,19 @@ Complete the following steps to export data from the 1Password Desktop App:
## Import to Bitwarden
Complete the following steps to import data to your Bitwarden personal Vault (for help importing to an Organization Vault, see [Import Items to an Organization]({% link _articles/organizations/import-to-org.md %})):
Importing data to Bitwarden **can only be done from the** [**Web Vault**](https://vault.bitwarden.com){:target="\_blank"}. To import your data:
1. Log in to the [Web Vault](https://vault.bitwarden.com){:target="\_blank"}.
2. Select **Tools** from the top navigation bar.
3. Select **Import Data** from the left Tools menu.
4. Select one of the following from the format dropdown:
1. In the Web Vault, select **Tools** from the top navigation bar.
2. Select **Import Data** from the left-hand Tools menu.
3. From the format dropdown, choose one of the following **File Formats**:
- 1Password (1pif)
- 1Password 6 and 7 Windows (csv)
- 1Password 6 and 7 Mac (csv)
5. Select the **Browse...** button and add the file exported from 1Password.
5. Select the **Choose File** button and add the file to import or **copy/paste** the contents of your file into the input box.
{% callout warning %}Import to Bitwarden can't check whether items in the file to import are duplicative of items in your Vault. This means that **importing multiple files will create duplicative** Vault items if an item is already in the Vault and in the file to import.{% endcallout %}
6. Select the **Import Data** button to complete your import.
7. After successful import, delete the import source file from your computer. This will protect you in the event your computer is compromised.
{% callout warning %}
Importing data multiple times will create duplicates.
{% endcallout %}
Congratulations! You have just transferred your data from 1Password into Bitwarden.
Currently, file attachments are not included in Bitwarden import operations and will need to be uploaded to your Vault manually. For more information, see [File Attachments]({{site.baseurl}}/article/attachments/#attach-a-file).

67
_articles/importing/import-from-chrome.md
View File

@@ -10,19 +10,30 @@ order: 04
Use this article for help exporting data from Google Chrome and importing into Bitwarden.
{% callout info %}
The steps in this article can also be used with the following browsers:
- Opera
- Microsoft Edge (Chromium)
- Brave
- Vivaldi
{% callout success %}
The steps in this article can also be used with any Chromium-based browser, including Opera, Microsoft Edge (Chromium), Brave, and Vivaldi.
{% endcallout %}
## Export from Chrome
### From a Desktop
You can export Google Chrome data from a Desktop browser or a Mobile browser:
Complete the following steps to export passwords from Chrome on your Desktop:
<ul class="nav nav-tabs" id="myTab" role="tablist">
<li class="nav-item" role="presentation">
<a class="nav-link active" id="desktab" data-bs-toggle="tab" data-target="#desk" role="tab" aria-controls="desk" aria-selected="true">Chrome on Desktop</a>
</li>
<li class="nav-item" role="presentation">
<a class="nav-link" id="mobiletab" data-bs-toggle="tab" data-target="#mobile" role="tab" aria-controls="mobile" aria-selected="false">Chrome on Mobile</a>
</li>
</ul>
<div class="tab-content" id="clientsContent">
<div class="tab-pane show active" id="desk" role="tabpanel" aria-labelledby="desktab">
{% capture desktop %}
### Chrome on Desktop
To export passwords from Chrome on your Desktop:
1. Using the address bar, navigate to `chrome://settings/passwords`.
2. Select the {% icon fa-ellipsis-v %} menu button in the Saved Passwords section, and select **Export passwords...** from the dropdown.
@@ -31,13 +42,15 @@ Complete the following steps to export passwords from Chrome on your Desktop:
3. Specify a location to save your export to, and select **comma-separated values** from the **Format:** field.
4. Select **Save** to finish exporting from Chrome.
{% callout success %}
After you [import to Bitwarden](#import-to-bitwarden), make sure that you delete this exported file from your computer to ensure this information is secure in the event that your computer is compromised.
{% endcallout %}
{% endcapture %}
{{ desktop | markdownify }}
</div>
<div class="tab-pane" id="mobile" role="tabpanel" aria-labelledby="mobiletab">
{% capture mobile %}
### From a Mobile Device
### Chrome on Mobile
Complete the following steps to export passwords from Chrome on your Mobile Device:
To export passwords from Chrome on your Mobile Device:
1. Tap the {% icon fa-ellipsis-h %} menu button and tap **Settings**.
2. Tap **Passwords**.
@@ -46,23 +59,23 @@ Complete the following steps to export passwords from Chrome on your Mobile Devi
You may be prompted to enter your device PIN or a biometric for authorization.
4. Specify a location to save your export to.
{% callout success %}
After you [import to Bitwarden](#import-to-bitwarden), make sure that you delete this exported file from your computer to ensure this information is secure in the event that your computer is compromised.
{% endcallout %}
{% endcapture %}
{{ mobile | markdownify }}
</div>
</div>
## Import to Bitwarden
Complete the following steps to import data to your Bitwarden personal Vault (for help importing to an Organization Vault, see [Import Items to an Organization]({% link _articles/organizations/import-to-org.md %})):
Importing data to Bitwarden **can only be done from the** [**Web Vault**](https://vault.bitwarden.com){:target="\_blank"}. To import your data:
1. Log in to the [Web Vault](https://vault.bitwarden.com){:target="\_blank"}.
2. Select **Tools** from the top navigation bar.
3. Select **Import Data** from the left Tools menu.
4. Select **Chrome (csv)** from the format dropdown.
5. Select the **Browse...** button and add the file exported from Chrome.
1. In the Web Vault, select **Tools** from the top navigation bar.
2. Select **Import Data** from the left-hand Tools menu.
3. From the format dropdown, choose a **Chrome (csv)** (see [What file formats does Bitwarden support for import?]({{site.baseurl}}/article/import-faqs/#q-what-file-formats-does-bitwarden-support-for-import)).
5. Select the **Choose File** button and add the file to import or **copy/paste** the contents of your file into the input box.
{% callout warning %}Import to Bitwarden can't check whether items in the file to import are duplicative of items in your Vault. This means that **importing multiple files will create duplicative** Vault items if an item is already in the Vault and in the file to import.{% endcallout %}
6. Select the **Import Data** button to complete your import.
7. After successful import, delete the import source file from your computer. This will protect you in the event your computer is compromised.
{% callout warning %}
Importing data multiple times will create duplicates.
{% endcallout %}
Congratulations! You have just transferred your data from Chrome into Bitwarden.
Currently, file attachments are not included in Bitwarden import operations and will need to be uploaded to your Vault manually. For more information, see [File Attachments]({{site.baseurl}}/article/attachments/#attach-a-file).

66
_articles/importing/import-from-firefox.md
View File

@@ -12,9 +12,27 @@ Use this article for help exporting data from Firefox and importing into Bitward
## Export from Firefox
### From Latest Version of Firefox
Exporting from Firefox can look a little different depending on which version you're using, or if you're using a Firefox-based browser like Tor Browser or Waterfox:
Complete the following steps to export your logins from the latest version of Firefox:
<ul class="nav nav-tabs" id="myTab" role="tablist">
<li class="nav-item" role="presentation">
<a class="nav-link active" id="latesttab" data-bs-toggle="tab" data-target="#latest" role="tab" aria-controls="latest" aria-selected="true">Latest Version</a>
</li>
<li class="nav-item" role="presentation">
<a class="nav-link" id="oldertab" data-bs-toggle="tab" data-target="#older" role="tab" aria-controls="older" aria-selected="false">Older Versions</a>
</li>
<li class="nav-item" role="presentation">
<a class="nav-link" id="basedtab" data-bs-toggle="tab" data-target="#based" role="tab" aria-controls="based" aria-selected="false">Firefox-based</a>
</li>
</ul>
<div class="tab-content" id="clientsContent">
<div class="tab-pane show active" id="latest" role="tabpanel" aria-labelledby="latesttab">
{% capture latest %}
### Export from Latest Version
To export logins from the latest version of Firefox:
1. Using the address bar, navigate to `about:logins`
2. Select the {% icon fa-ellipsis-h %} menu button from the top right and select **Export Logins...** from the dropdown.
@@ -23,7 +41,13 @@ Complete the following steps to export your logins from the latest version of Fi
Firefox will export your logins as a `.csv`.
### From Older Versions of Firefox
{% endcapture %}
{{ latest | markdownify }}
</div>
<div class="tab-pane" id="older" role="tabpanel" aria-labelledby="oldertab">
{% capture older %}
### Export from Older Versions
Some older versions of Firefox do not support native export. Complete the following steps to export using an FF Password Exporter.
@@ -34,9 +58,15 @@ Some older versions of Firefox do not support native export. Complete the follow
3. Select the **Export Passwords** button.
4. Choose `.csv` for the file format, and save the file to your device.
### From Firefox-based Browsers
{% endcapture %}
{{ older | markdownify }}
</div>
<div class="tab-pane" id="based" role="tabpanel" aria-labelledby="basedtab">
{% capture based %}
Some Firefox-based browsers offer login export in a different location than vanilla Firefox. If exporting [From Latest Version of Firefox](#from-latest-version-of-firefox) doesn't work, try the following:
### Export from Firefox-based Browsers
Some Firefox-based browsers offer login export in a different location than vanilla Firefox. If the steps to import from the **Latest Version** don't work, try the following:
1. Using the address bar, navigate to `about:preferences#privacy`.
2. Click the **Saved Logins** button.
@@ -46,19 +76,23 @@ Some Firefox-based browsers offer login export in a different location than vani
Most Firefox-based browsers will export your logins as a `.csv`.
{% endcapture %}
{{ based | markdownify }}
</div>
</div>
## Import to Bitwarden
Complete the following steps to import data to your Bitwarden personal Vault (for help importing to an Organization Vault, see [Import Items to an Organization]({% link _articles/organizations/import-to-org.md %})):
Importing data to Bitwarden **can only be done from the** [**Web Vault**](https://vault.bitwarden.com){:target="\_blank"}. To import your data:
1. Log in to the [Web Vault](https://vault.bitwarden.com){:target="\_blank"}.
2. Select **Tools** from the top navigation bar.
3. Select **Import Data** from the left Tools menu.
4. Select **Firefox (csv)** from the format dropdown.
5. Select the **Browse...** button and add the file exported from Firefox.
1. In the Web Vault, select **Tools** from the top navigation bar.
2. Select **Import Data** from the left-hand Tools menu.
3. From the format dropdown, choose **Firefox (csv)**.
5. Select the **Choose File** button and add the file to import or **copy/paste** the contents of your file into the input box.
{% callout warning %}Import to Bitwarden can't check whether items in the file to import are duplicative of items in your Vault. This means that **importing multiple files will create duplicative** Vault items if an item is already in the Vault and in the file to import.{% endcallout %}
6. Select the **Import Data** button to complete your import.
7. After successful import, delete the import source file from your computer. This will protect you in the event your computer is compromised.
{% callout warning %}
Importing data multiple times will create duplicates.
{% endcallout %}
Congratulations! You have just transferred your data from Firefox into Bitwarden.
Currently, file attachments are not included in Bitwarden import operations and will need to be uploaded to your Vault manually. For more information, see [File Attachments]({{site.baseurl}}/article/attachments/#attach-a-file).

7
_articles/importing/import-from-lastpass.md
View File

@@ -85,12 +85,13 @@ Importing data to Bitwarden **can only be done from the** [**Web Vault**](https:
2. Select **Import Data** from the left-hand Tools menu.
3. From the format dropdown, choose **LastPass (csv)** from the File Format dropdown.
5. Paste the contents of your `.csv` export into the text box, or select the **Choose File** button and add the file to import.
4. Select the **Choose File** button and add the file to import or **copy/paste** the contents of your `.csv` into the input box.
{% callout warning %}Import to Bitwarden can't check whether items in the file to import are duplicative of items in your Vault. This means that **importing multiple files will create duplicative** Vault items if an item is already in the Vault and in the file to import.{% endcallout %}
6. Select the **Import Data** button to complete your import.
5. Select the **Import Data** button to complete your import.
6. After successful import, delete the source `.csv` file from your computer. This will protect you in the event your computer is compromised.
Currently, file attachments are not included in Bitwarden import operations and will need to be uploaded to your Vault manually. For more information, see [File Attachments]({% link _articles/features/attachments.md %}).
Currently, file attachments are not included in Bitwarden import operations and will need to be uploaded to your Vault manually. For more information, see [File Attachments]({{site.baseurl}}/article/attachments/#attach-a-file).
## Import Troubleshooting

21
_articles/importing/import-from-passwordsafe.md
View File

@@ -39,17 +39,16 @@ To prepare the exported file for import, please follow the instructions in this
## Import to Bitwarden
Complete the following steps to import data to your Bitwarden personal Vault (for help importing to an Organization Vault, see [Import Items to an Organization]({% link _articles/organizations/import-to-org.md %})):
Importing data to Bitwarden **can only be done from the** [**Web Vault**](https://vault.bitwarden.com){:target="\_blank"}. To import your data:
1. Log in to the [Web Vault](https://vault.bitwarden.com){:target="\_blank"}.
2. Select **Tools** from the top navigation bar.
3. Select **Import Data** from the left Tools menu.
4. Select **Bitwarden (csv)** from the format dropdown.
5. Select the **Browse...** button and select the file you prepared in a previous step.
1. In the Web Vault, select **Tools** from the top navigation bar.
2. Select **Import Data** from the left-hand Tools menu.
3. From the format dropdown, choose a **Bitwarden (csv)**.
5. Select the **Choose File** button and add the file to import or **copy/paste** the contents of your file into the input box.
{% callout warning %}Import to Bitwarden can't check whether items in the file to import are duplicative of items in your Vault. This means that **importing multiple files will create duplicative** Vault items if an item is already in the Vault and in the file to import.{% endcallout %}
6. Select the **Import Data** button to complete your import.
7. After successful import, delete the import source file from your computer. This will protect you in the event your computer is compromised.
{% callout warning %}
Importing data multiple times will create duplicates.
{% endcallout %}
Congratulations! You have just transferred your data from Password Safe into Bitwarden.
Currently, file attachments are not included in Bitwarden import operations and will need to be uploaded to your Vault manually. For more information, see [File Attachments]({{site.baseurl}}/article/attachments/#attach-a-file).

32
_articles/organizations/event-logs.md
View File

@@ -10,26 +10,21 @@ order: 13
## What are Event Logs?
Event Logs are timestamped records of everything that occurs within your Organization. Event Logs are accessible to users with the type **Admin** or **Owner** from the **Manage** tab of your Organization.
Event Logs are timestamped records of everything that occurs within your Organization. Event Logs are accessible to [Admins and Owners]({{site.baseurl}}/article/event-logs/) from the **Manage** tab of your Organization Vault:
{% image /organizations/event-logs-updated.png %}
{% image /organizations/event-logs-updated.png Event Logs %}
Events Logs are also accessible using Bitwarden's API for Organization Management. For more information, see [RESTful API for Organization Management](https://bitwarden.com/help/article/public-api/).
Events Logs are also accessible from the `/events` endpoint of the [Bitwarden Public API](https://bitwarden.com/help/article/public-api/).
## Events List
## Events
Event Logs record roughly 40 different types of events. In the Web Vault, the action catalogued by each event is described in plain text under the **Event** column.
Event Logs record roughly 40 different types of events. The Event Logs screen captures a **Timestamp** for the event, client app information including application type and IP (accessed by hoving over the {% icon fa-globe %} globe icon), the **User** connected to the event, and an **Event** description.
Each type of event is associated with `type` code (`1000`, `1001`, etc.) that identifies the action captured by the event. Event `type` codes are important to understand when accessing Event Logs via API. For more information, see [RESTful API for Organization Management](https://bitwarden.com/help/article/public-api/).
{% callout info %}
Each **Event** is associated with type code (`1000`, `1001`, etc.) that identifies the action captured by the event. Type codes are used by the [Bitwarden Public API](https://bitwarden.com/help/article/public-api/) to identify the action documented by an event.
{% endcallout %}
All Event types are documented below, with their corresponding `type` codes:
{% comment %}
Sources:
https://github.com/bitwarden/server/blob/master/src/Core/Enums/EventType.cs
https://github.com/bitwarden/web/blob/master/src/app/services/event.service.ts
https://github.com/bitwarden/web/blob/master/src/locales/en/messages.json
{% endcomment %}
All Event types are listed below, with their corresponding type codes:
### User Events
- Logged In. (`1000`)
@@ -81,9 +76,16 @@ https://github.com/bitwarden/web/blob/master/src/locales/en/messages.json
- Purged organization vault. (`1601`)
- Updated a Policy. (`1700`)
{% comment %}
Sources:
https://github.com/bitwarden/server/blob/master/src/Core/Enums/EventType.cs
https://github.com/bitwarden/web/blob/master/src/app/services/event.service.ts
https://github.com/bitwarden/web/blob/master/src/locales/en/messages.json
{% endcomment %}
## API Responses
Accessing Event Logs via API will return a response like the following. For more information, see [RESTful API for Organization Management](https://bitwarden.com/help/article/public-api/).
Accessing Event Logs from the `/events` endpoint of the [Bitwarden Public API](https://bitwarden.com/help/article/public-api/) will return a JSON response like the following:
```
{

12
_articles/organizations/managing-users.md
View File

@@ -95,7 +95,6 @@ Each fingerprint phrase is unique to its account, and ensures a final layer of o
To remove users from your Organization:
1. Login to your [Web Vault](https://vault.bitwarden.com){:target="\_blank"} and open your Organization.
2. In your Organization, open the **Manage** tab and select **People** from the left menu.
3. On the **People** screen, hover over the user you want to remove and select the gear dropdown.
@@ -103,8 +102,11 @@ To remove users from your Organization:
{% image organizations/org-people-options-updated-overlay.png Remove a user %}
Removing a user from an Organization **does not** delete their Bitwarden account. When a user is removed they can no longer access the Organization or any shared items and Collections, however they will still be able to login to Bitwarden using the established credentials and access to any Personal Vault items.
### Deleting User Accounts
{% callout success %}
If you're an Organization Owner or Admin removing a user with a `@yourcompany.com` email address, you can delete the Bitwarden account as long as you have access to the `@yourcompany.com` email inbox. For more information, see [Delete an Account Without Logging In](https://bitwarden.com/help/article/delete-your-account/#without-logging-in).
{% endcallout %}
**Removing a user from your Organization does not delete their Bitwarden account.** When a user is removed they can no longer access the Organization or any shared items and Collections, however they will still be able to login to Bitwarden using their existing Master Password and access any Personal Vault items.
Depending on the particulars of your implementation, you may be able to use one of the following methods to delete a Bitwarden user account that belongs to an offboarded user:
1. If you're self-hosting Bitwarden, an authorized admin can delete the account from the [System Administrator Portal]({{site.baseurl}}/article/admin-portal/).
2. If the account has an `@yourcompany.com` email address that your company controls, you can use the [delete without logging in](https://vault.bitwarden.com/#/recover-delete){:target="\_blank"} tool and confirm deletion within the `@yourcompany.com` inbox. For more information, see [Delete an Account Without Logging In](https://bitwarden.com/help/article/delete-your-account/#without-logging-in).

4
_articles/two-step-login/setup-two-step-login-authenticator.md
View File

@@ -46,9 +46,9 @@ The following assumes that **Authenticator** is your [highest-priority enabled m
1. Log in to your Bitwarden Vault on any app and enter your Email Address and Master Password.
You will be prompted to **Enter the 6 digit verification code from your authenticator app**.
2. Open your authenticator app and find the 6 digit verification code for your Bitwarden Vault. Enter this code on the Vault login screen.
2. Open your authenticator app and find the 6 digit verification code for your Bitwarden Vault. Enter this code on the Vault login screen. Typically, verification codes will change every 30 seconds.
Typically, verification codes will change every 30 seconds.
{% callout success %}Check the **Remember Me** box to remember your device for 30 days. Remembering your device will mean you won't be required to complete your Two-step Login step.{% endcallout %}
3. Select **Continue** to finish logging in.
You will not be required to complete your secondary Two-step Login step to **Unlock** your Vault once logged in. For help configuring Log Out vs. Lock behavior, see [Vault Timeout Options]({% link _articles/account/vault-timeout.md %}).

2
_articles/two-step-login/setup-two-step-login-duo.md
View File

@@ -129,4 +129,6 @@ The following assumes that **Duo** is your [highest-priority enabled method](htt
- Approving the **Duo Push** request from your registered device.
- Finding the 6 digit verification code in your **Duo Mobile** app or **SMS** messages, and enter the code on the Vault login screen.
{% callout success %}Check the **Remember Me** box to remember your device for 30 days. Remembering your device will mean you won't be required to complete your Two-step Login step.{% endcallout %}
You will not be required to complete your secondary Two-step Login step to **Unlock** your Vault once logged in. For help configuring Log Out vs. Lock behavior, see [Vault Timeout Options]({% link _articles/account/vault-timeout.md %}).

2
_articles/two-step-login/setup-two-step-login-email.md
View File

@@ -45,6 +45,8 @@ The following assumes that **Email** is your [highest-priority enabled method](h
You will be prompted to **Enter the 6 digit verification code that was emailed to your configured email**.
2. Check your inbox for the 6 digit verification code. Enter this code on the Vault login screen.
{% callout success %}Check the **Remember Me** box to remember your device for 30 days. Remembering your device will mean you won't be required to complete your Two-step Login step.{% endcallout %}
3. Select **Continue** to finish logging in.
You will not be required to complete your secondary Two-step Login step to **Unlock** your Vault once logged in. For help configuring Log Out vs. Lock behavior, see [Vault Timeout Options]({% link _articles/account/vault-timeout.md %}).

4
_articles/two-step-login/setup-two-step-login-fido.md
View File

@@ -67,4 +67,8 @@ The following assumes that **FIDO2 WebAuthn** is your [highest-priority enabled
{% image two-step/u2f/fido2.png %}
{% callout success %}
Check the **Remember Me** box to remember your device for 30 days. Remembering your device will mean you won't be required to complete your Two-step Login step.
{% endcallout %}
You will not be required to complete your secondary Two-step Login setup to **Unlock** your Vault once logged in. For help configuring Log Out vs. Lock behavior, see [Vault Timeout Options]({% link _articles/account/vault-timeout.md %}).

4
_articles/two-step-login/setup-two-step-login-yubikey.md
View File

@@ -54,11 +54,13 @@ The following assumes that **YubiKey** is your [highest-priority enabled method]
{% image two-step/yubikey/using-yubi.png %}
{% callout success %}Check the **Remember Me** box to remember your device for 30 days. Remembering your device will mean you won't be required to complete your Two-step Login step.{% endcallout %}
**If you're using a non-NFC YubiKey on a Mobile Device:**
1. Plug your YubiKey into the device.
2. Tap **Cancel** to end the NFC prompt.
{% image two-step.yubikey/nonfc.png %}
{% image two-step/yubikey/nonfc.png %}
3. Tap the text input field, denoted by a gray underline.
4. Tap or press your YubiKey button to insert your code.

BIN
images/autofill/urlgraphic.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 18 KiB

BIN
images/manage-items/manage-be.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 183 KiB

BIN
images/manage-items/manage-desktop.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 170 KiB

BIN
images/manage-items/manage-mobile-1.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.4 MiB

BIN
images/manage-items/manage-mobile-2.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 594 KiB

BIN
images/manage-items/manage-webvault.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 221 KiB