1
0
mirror of https://github.com/bitwarden/help synced 2025-12-27 05:33:14 +00:00

Release Updates (#474)

* Send Staging (#447)

* - js for in-page tabs
- send category early drafts of articles
- send images

* fix scrolling on tab

* send web vault

* mobile image

* redone 'receive send' article

* send from browser ext & mobile

* send work

* improvements to 'about'

* send additions

* so much send

* lotsa send

* all send all the time

* ain't nothin but a send thang

* cli

* send cli

* simple cli sends in /create-send/

* simple disable & delete in /send-lifespan/

* send desktop screenshots

* send final cleanup

* cli final cleanup

* send edits

* fix

* send final touches

* fixed links & non-send updates

* new import message documentation, several import articles condensed to use tabs, U2F support for Edge, excluded domains article, remove in innacurate note on emergency accesss

* Firefox Attachment Workflow + Date Picker for custom timestamps

* safari attach file Send req

* excluded domains addition

* fix tab titles

* release notes

* unlock articles

* link to status feed

* small typos

* test

* updated release notes

* lastpass article form fill rewrites

* import to org & personal clarifications

* send self-hosting, safari web extension edits, and release notes
This commit is contained in:
fred_the_tech_writer
2021-03-11 11:58:16 -05:00
committed by GitHub
parent 7b16aceea1
commit 535ea72847
69 changed files with 1600 additions and 425 deletions

View File

@@ -8,10 +8,10 @@ tags: [import]
order: 07
---
Encrypted Exports provide a secure long-term storage option for Vault data backups. Vault data is encrypted using your account's Encryption Key.
Vault data can be [exported]({% link _articles/account/export-your-data.md %}) in an encrypted JSON file. These exports are encrypted using your [account's encryption key]({% link _articles/account/account-encryption-key.md %}), which are generated on account creation and unique to each Bitwarden user account.
{% callout warning %}
[Rotating your account's encryption key]({% link _articles/account/account-encryption-key.md %}) will render an Encrypted Export impossible to decrypt. **If you rotate your account encryption key, replace the old backup with one that uses the new encryption key.**
[Rotating your account's encryption key]({% link _articles/account/account-encryption-key.md %}) will render an Encrypted Export impossible to decrypt. **If you rotate your account encryption key, replace any old files with new one that use the new encryption key.**
Account Encryption Keys are unique to each Bitwarden user account, so you won't be able to import an Encrypted Export into a different account.
{% endcallout %}
@@ -42,29 +42,113 @@ Will look something like:
## Create an Encrypted Export
Downloading an Encrypted Export follows the same procedure as downloading a plaintext `.csv` or `.json` export:
Creating an Encrypted Export follows the [normal export procedure]({% link _articles/account/export-your-data.md %}):
1. In the [Web Vault](https://vault.bitwarden.com){:target="\_blank"}, select **Tools** from the top navigation bar.
3. Select **Export Vault** from the left-hand Tools menu.
4. On the Export Vault page:
- Select **.json (Encrypted)** from the **File Format** dropdown.
- Enter your **Master Password**.
5. Select the **Export Vault** button to download your Vault Export. You will be prompted to specify a location for download.
<ul class="nav nav-tabs" id="myTab" role="tablist">
<li class="nav-item" role="presentation">
<a class="nav-link active" id="wvtab" data-target="#webvault" role="tab" aria-controls="webvault" aria-selected="true">Web Vault</a>
</li>
<li class="nav-item" role="presentation">
<a class="nav-link" id="betab" data-target="#browserextension" role="tab" aria-controls="browserextension" aria-selected="false">Browser Extension</a>
</li>
<li class="nav-item" role="presentation">
<a class="nav-link" id="desktab" data-target="#desktop" role="tab" aria-controls="desktop" aria-selected="false">Desktop</a>
</li>
<li class="nav-item" role="presentation">
<a class="nav-link" id="mobtab" data-target="#mobile" role="tab" aria-controls="mobile" aria-selected="false">Mobile</a>
</li>
<li class="nav-item" role="presentation">
<a class="nav-link" id="clitab" 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="webvault" role="tabpanel" aria-labelledby="wvtab">
{% capture web_vault %}
For help downloading an Encrypted Export from any other client application, see [Export Vault Data]({% link _articles/account/export-your-data.md %}).
#### Export from the Web Vault
To create an encrypted export of your personal Vault data from the Web Vault:
1. Select **Tools** from the top navigation bar.
2. Select **Export Vault** from the left-hand Tools menu.
3. On the Vault Export page, choose `.json (Encrypted)` for the **File Format**.
4. Enter your **Master Password** and select the **Export Vault** button.
{% endcapture %}
{{ web_vault | markdownify}}
</div>
<div class="tab-pane" id="browserextension" role="tabpanel" aria-labelledby="betab">
{% capture browser_extension %}
#### Export from a Browser Extension
To create an encrypted export of your personal Vault data from a Browser Extension:
1. Open the {% icon fa-cogs %} **Settings** tab.
2. Scroll down to the **Tools** section and select the **Export Vault** option.
3. On the Export Vault view, choose `.json (Encrypted)` for the **File Format**.
4. Enter your **Master Password** and select **Submit**.
{% endcapture %}
{{ browser_extension | markdownify}}
</div>
<div class="tab-pane" id="desktop" role="tabpanel" aria-labelledby="desktab">
{% capture desktop_info %}
#### Export from Desktop
To create an encrypted export of your personal Vault data from a Desktop app:
1. From the menu bar, navigate to **File** &rarr; **Export Vault**.
2. In the Export Vault window, choose `.json (Encrypted)` for the **File Format**.
3. Enter your **Master Password** and select the {% icon fa-download %} **Download** button.
{% endcapture %}
{{ desktop_info | markdownify}}
</div>
<div class="tab-pane" id="mobile" role="tabpanel" aria-labelledby="mobtab">
{% capture mobile_info %}
#### Export from Mobile
To create an encrypted export of your personal Vault data from a Mobile app:
1. Tap the {% icon fa-cogs %} **Settings** tab.
2. Scroll down to the **Tools** section and tap the **Export Vault** option.
3. On the Export Vault view, choose `.json (Encrypted)` for the **File Format**.
4. Enter your **Master Password** and tap the **Export Vault** button.
{% endcapture %}
{{ mobile_info | markdownify}}
</div>
<div class="tab-pane" id="cli" role="tabpanel" aria-labelledby="cliab">
{% capture cli_info %}
#### Export from the CLI
To create an encrypted export of your personal Vault data from the CLI, use the `export` command with the specified option `--format json_encrypted`, for example:
```
bw export my-master-password --output /users/me/documents/ --format json_encrypted
```
For more detail, see our [CLI documentation]({% link _articles/miscellaneous/cli.md %}).
{% endcapture %}
{{ cli_info | markdownify}}
</div>
</div>
## Import an Encrypted Export
Importing an Encrypted Export following the same procedure as importing a plaintext `.csv` or `.json` file:
Importing an Encrypted Export follows the [normal import procedure]({% link _articles/importing/import-data.md %}), which can **only be done from the** [**Web Vault**](https://vault.bitwarden.com){:target="\_blank"}:
1. In the [Web Vault](https://vault.bitwarden.com){:target="\_blank"}, select **Tools** from the top navigation bar.
1. In the Web Vault, select **Tools** from the top navigation bar.
2. Select **Import Data** from the left-hand Tools menu.
3. Select **Bitwarden (json)** as the format of your file to import.
3. From the format dropdown, choose **Bitwarden (json)**.
{% callout success %}There is no import option specifically for Encrypted Exports. A handler will determine that the `.json` file is encrypted and decrypt using your account encryption key.{% endcallout %}
5. Select the **Browse** button and add your file.
{% callout success %}There is no import option specifically for Encrypted Exports. A handler will determine that the `.json` file is encrypted and attempt to decrypt the file using your [account's encryption key]({% link _articles/account/account-encryption-key.md %}).{% endcallout %}
5. Select the **Choose File** button and add the file to import.
{% 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.
{% callout warning %}
Importing data multiple times will create duplicates.
{% endcallout %}

View File

@@ -8,120 +8,52 @@ tags: [import]
order: 01
---
Bitwarden provides a data import tool for easy migration from any password management solution to your personal Vault or Organization Vault (see [Import Data to an Organization]({% link _articles/organizations/import-to-org.md %})).
Bitwarden provides a data import tool for easy migration from any password management solution to your personal Vault or Organization Vault. You can also use the data import tool to import from one Bitwarden Vault to another, or to import a Bitwarden [Encrypted Export]({% link _articles/importing/encrypted-export.md %}).
You can also use the data import tool to import from one Bitwarden Vault to another, or to import a backup [Encrypted Export]({% link _articles/importing/encrypted-export.md %}).
Bitwarden supports a large array of formats for import, including those used by the most popular password management solutions:
For a full list of supported import formats, see [What file formats does Bitwarden support for import?]({{site.baseurl}}/article/send-faqs/#q-what-file-formats-does-bitwarden-support-for-import), or use one of these articles for importing from the most popular solutions:
- [Import from LastPass]({% link _articles/importing/import-from-lastpass.md %})
- [Import from 1Password]({% link _articles/importing/import-from-1password.md %})
- [Import from Firefox]({% link _articles/importing/import-from-firefox.md %})
- [Import from Google Chrome]({% link _articles/importing/import-from-chrome.md %})
For a full list of supported formats, see [Supported Formats](#supported-formats).
## Import to your Personal Vault
To import your data into a personal Vault:
Importing data to Bitwarden **can only be done from the** [**Web Vault**](https://vault.bitwarden.com){:target="\_blank"}.
1. Log in to the [Web Vault](https://vault.bitwarden.com){:target="\_blank"}. Not already signed up? [Select a Bitwarden plan to get started.](https://bitwarden.com/pricing/business/)
2. Select **Tools** from the top navigation bar.
3. Select **Import Data** from the left Tools menu.
4. Select the format of your file to import from the dropdown menu.
{% callout success %}
**Not already signed up?** Choose from one of [Bitwarden's plans](https://bitwarden.com/pricing/business/){:target="\_blank"} and get started today:
{% callout success%}If you're importing an [Encrypted Export]({% link _articles/importing/encrypted-export.md %}), select `.json` as you would if it were plaintext. A handler will determine that the file is encrypted and decrypt using your [account encryption key](https://bitwarden.com/help/article//change-your-master-password/#rotating-your-accounts-encryption-key).{% endcallout %}
5. Select the **Browse** button and add your file.
6. Select the **Import Data** button to complete your import.
{% callout warning %}
Importing data multiple times will create duplicates.
<a role="button" class="btn btn-primary" href="https://vault.bitwarden.com/#/register" target="blank">Create Your Free Account</a>
{% endcallout %}
## Length-related Import Errors
To import your data:
The following error messages, typically received when attempting to import a `.csv`, indicate that a field in your import file exceeds the allowed **encrypted** character limit for that field type:
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/send-faqs/#q-what-file-formats-does-bitwarden-support-for-import)).
{% image /importing/ciphererrors.png Cipher errors in the Web Vault%}
5. Select the **Choose File** button and add the file to import.
These error messages contain 3 pieces of pertinent data:
- `Ciphers[X]` indicates the index number where the offending item is located.
- `The field <field>` indicates the field name which is causing the offense.
- `length of <limit> characters` indicates the character limit allowed for that field.
{% 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.
{% callout note %}On import to Bitwarden, the character count of any given field is increased due to encryption, meaning that an 8000-character `note` field in your `.csv` will scale to 10,000+ characters when it comes into contact with Bitwarden, triggering this error. As a rule of thumb, character counts will grow between 30-50% when encrypted.{% endcallout %}
## Troubleshooting
To solve this issue:
### Length-related Import Errors
1. Open the `.csv` file you're attempting to import in a text editor or spreadsheet program.
2. Locate the offending item at `index[X]`. The value of `X` references a `.csv` index number, so depending on the program you use to edit your file it may not map perfectly to a spreadsheet Row or Line number.
The following error messages, typically received when attempting to import a `.csv`, indicate that an item in your import file has a specified value that exceeds the allowed **encrypted** character limit for its field type:
In many cases, you'll need to adjust for `.csv` header rows, which are not counted in many spreadsheet programs. It can also help to use field name (`yyyy`) and perceived character length as context clues.
{% image /importing/ciphererror_2021.png Cipher errors in the Web Vault%}
{% callout success %}If you've having trouble locating the offending item using the data provided in the error, it may help to focus first on notes as these are frequently the cause of this error.{% endcallout %}
3. Remove the offending item from your import file, or reduce the character count. When reducing the character count, remember that limits are placed on **encrypted** counts, not pre-encryption counts. As a rule of thumb, character counts will grow between 30-50% when Bitwarden attempts to encrypt a field on import.
To solve this issue, open the `.csv` file in a text editor or spreadsheet program and **remove** or **reduce the character count** of the offending item. Bitwarden won't import your `.csv` file until it is free of offenses. The contents of the error messages contain several pieces of pertinent data to help you identify the offending item. For example, in the above example:
## Supported Formats
- `[1]` identifies the index number where the offending item is located, adjusted to match row numbering in *most* spreadsheet programs.
- `[Login]` identifies the Vault item `type` of the offending item.
- `"Facebook"` identifies the `name` of the offending item.
- `Notes` indicates the field (column) where the character limit is exceeded.
- `10000` indicates the character limit allowed for that field (column).
The following formats are supported out-of-the-box:
{% callout success %}On import to Bitwarden, the character count of any given field is increased due to encryption, meaning that an 8000-character `Notes` field in your `.csv` will scale to 10,000+ characters when it comes into contact with Bitwarden, triggering this error. As a rule of thumb, character counts will grow between 30-50% when encrypted.{% endcallout %}
{% callout info %}
If your format is not listed below, manually [condition a Bitwarden .csv or .json]({% link _articles/importing/condition-bitwarden-import.md %}).
{% endcallout %}
- [1Password (1pif)]({% link _articles/importing/import-from-1password.md %})
- [1Password 6 &amp; 7 Windows (.sv)]({% link _articles/importing/import-from-1password.md %})
- [1Password 6 &amp; 7 Mac (csv)]({% link _articles/importing/import-from-1password.md %})
- Ascendo DataVault (csv)
- Avast Passwords (csv)
- Avira (json)
- BlackBerry Password Keeper (csv)
- Blur (csv)
- [Brave (csv)]({% link _articles/importing/import-from-chrome.md %})
- [Chrome (csv)]({% link _articles/importing/import-from-chrome.md %})
- Clipperz (html)
- Codebook (csv)
- Dashlane (json)
- Encryptr (csv)
- Enpass (csv)
- Enpass (json)
- [Firefox (csv)]({% link _articles/importing/import-from-firefox.md %})
- F-Secure KEY (fsk)
- GNOME Passwords and Keys/Seahorse (json)
- Kaspersky Password Manager (txt)
- KeePass 2 (xml)
- KeePassX (csv)
- Keeper (csv)
- [LastPass (csv)]({% link _articles/importing/import-from-lastpass.md %})
- LogMeOnce (csv)
- Meldium (csv)
- mSecure (csv)
- Myki (csv)
- [Microsoft Edge (Chromium) (csv)]({% link _articles/importing/import-from-chrome.md %})
- [Opera (csv)]({% link _articles/importing/import-from-chrome.md %})
- Padlock (csv)
- Passbolt (csv)
- PassKeep (csv)
- Passman (json)
- Passpack (csv)
- Password Agent (csv)
- Password Boss (json)
- Password Dragon (xml)
- Password Safe (xml)
- PasswordWallet (txt)
- RememBear (csv)
- RoboForm (csv)
- SafeInCloud (xml)
- SaferPass (csv)
- SecureSafe (csv)
- SplashID (csv)
- Sticky Password (xml)
- True Key (csv)
- Universal Password Manager (csv)
- [Vivaldi (csv)]({% link _articles/importing/import-from-chrome.md %})
- Yoti (csv)
- Zoho Vault (csv)
#### Ready to get started?
<a role="button" class="btn btn-primary" href="https://vault.bitwarden.com/#/register">Create Your Free Account</a>
If you continue to have trouble locating the offending item using the data provided in the error, it may help to focus first on notes as these are frequently the cause of this error.

View File

@@ -12,7 +12,28 @@ Use this article for help exporting data from LastPass and importing into Bitwar
## Export from LastPass
Complete the following steps to export data from the [LastPass Web Vault](https://lastpass.com/){:target="\_blank"}:
You can export your data from LastPass from their Web Vault or from a LastPass Browser Extension:
{% callout info %}
A previous version of this article stated that you [needed to use the Browser Extension](https://support.logmeininc.com/lastpass/help/how-do-i-nbsp-export-my-lastpass-form-fill-profiles){:target="\_blank"} to export **Form Fills** (e.g. Addresses and Payment Cards), however testing by Bitwarden's Customer Success team found that using either LastPass application to download a standard **LastPass CSV** will include Form Fills in your export.
{% endcallout %}
<ul class="nav nav-tabs" id="myTab" role="tablist">
<li class="nav-item" role="presentation">
<a class="nav-link active" id="webtab" data-bs-toggle="tab" data-target="#web" role="tab" aria-controls="browsertab" aria-selected="true">LastPass Web Vault</a>
</li>
<li class="nav-item" role="presentation">
<a class="nav-link" id="browsertab" data-bs-toggle="tab" data-target="#browser" role="tab" aria-controls="browsertab" aria-selected="false">LastPass Browser Extension</a>
</li>
</ul>
<div class="tab-content" id="clientsContent">
<div class="tab-pane show active" id="web" role="tabpanel" aria-labelledby="webtab">
{% capture and_gs %}
#### From the LastPass Web Vault
To export your data from the LastPass Web Vault:
1. Select the {% icon fa-rocket %} **Advanced Options** option on the left sidebar:
@@ -31,11 +52,17 @@ Complete the following steps to export data from the [LastPass Web Vault](https:
If you observe this bug in your exported data, use a text editor to find and replace all altered values before importing into Bitwarden.
{% endcallout %}
### Export with Form Fills
{% endcapture %}
{{ and_gs | markdownify }}
</div>
<div class="tab-pane" id="browser" role="tabpanel" aria-labelledby="browsertab">
{% capture ios_gs %}
**Exports from the Web Vault will not include form fills.** To export form fill data from LastPass, you must do so from the Browser Extension:
#### From a LastPass Browser Extension
1. In the Browser Extension, navigate to **Account Options** &rarr; **Advanced** &rarr; **Export** &rarr; **Form Fills**:
To export your data from a LastPass Browser Extension:
1. In the Browser Extension, navigate to **Account Options** &rarr; **Advanced** &rarr; **Export** &rarr; **LastPass CSV File**:
{% image /importing/lp-be.png Export from Browser Extension %}
2. Enter your Master Password to validate the export attempt.
@@ -44,49 +71,46 @@ If you observe this bug in your exported data, use a text editor to find and rep
{% image lastpass-copy.png LastPass Export %}
4. If your Vault data was printed to the screen, highlight the text and copy and paste it into a new `export.csv` file.
{% endcapture %}
{{ ios_gs | 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:
If you want to store File Attachments in your Bitwarden Vault, please be aware that these are currently 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 %}).
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 **LastPass (csv)** from the File Format dropdown.
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 **LastPass (csv)** from the format dropdown.
5. Select the **Browse...** button and add the file exported from LastPass.
6. Select the **Import Data** button to complete your import.
5. Select the **Choose File** button and add the file to import.
{% callout warning %}
Importing data multiple times will create duplicates.
{% endcallout %}
{% 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.
Congratulations! You have just transferred your data from LastPass 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]({% link _articles/features/attachments.md %}).
## Import Troubleshooting
### Character Limit Error
### Length-related Import Errors
The following error messages, typically received when attempting to import a `.csv`, indicate that a field in your import file exceeds the allowed **encrypted** character limit for that field type:
The following error messages, typically received when attempting to import a `.csv`, indicate that an item in your import file has a specified value that exceeds the allowed **encrypted** character limit for its field type:
{% image /importing/ciphererrors.png Cipher errors in the Web Vault%}
{% image /importing/ciphererror_2021.png Cipher errors in the Web Vault%}
These error messages contain 3 pieces of pertinent data:
- `Ciphers[X]` indicates the index number where the offending item is located.
- `The field <field>` indicates the field name which is causing the offense.
- `length of <limit> characters` indicates the character limit allowed for that field.
To solve this issue, open the `.csv` file in a text editor or spreadsheet program and **remove** or **reduce the character count** of the offending item. Bitwarden won't import your `.csv` file until it is free of offenses. The contents of the error messages contain several pieces of pertinent data to help you identify the offending item. For example, in the above example:
{% callout note %}On import to Bitwarden, the character count of any given field is increased due to encryption, meaning that an 8000-character `note` field in your `.csv` will scale to 10,000+ characters when it comes into contact with Bitwarden, triggering this error. As a rule of thumb, character counts will grow between 30-50% when encrypted.{% endcallout %}
- `[1]` identifies the index number where the offending item is located, adjusted to match row numbering in *most* spreadsheet programs.
- `[Login]` identifies the Vault item `type` of the offending item.
- `"Facebook"` identifies the `name` of the offending item.
- `Notes` indicates the field (column) where the character limit is exceeded.
- `10000` indicates the character limit allowed for that field (column).
To solve this issue:
{% callout success %}On import to Bitwarden, the character count of any given field is increased due to encryption, meaning that an 8000-character `Notes` field in your `.csv` will scale to 10,000+ characters when it comes into contact with Bitwarden, triggering this error. As a rule of thumb, character counts will grow between 30-50% when encrypted.{% endcallout %}
1. Open the `.csv` file you're attempting to import in a text editor or spreadsheet program.
2. Locate the offending item at `index[X]`. The value of `X` references a `.csv` index number, so depending on the program you use to edit your file it may not map perfectly to a spreadsheet Row or Line number.
In many cases, you'll need to adjust for `.csv` header rows, which are not counted in many spreadsheet programs. It can also help to use field name (`yyyy`) and perceived character length as context clues.
{% callout success %}If you're having trouble locating the offending item using the data provided in the error, it may help to focus first on notes as these are frequently the cause of this error.{% endcallout %}
3. Remove the offending item from your import file, or reduce the character count. When reducing the character count, remember that limits are placed on **encrypted** counts, not pre-encryption counts. As a rule of thumb, character counts will grow between 30-50% when Bitwarden attempts to encrypt a field on import.
If you continue to have trouble locating the offending item using the data provided in the error, it may help to focus first on notes as these are frequently the cause of this error.
### Maximum Collections Error
@@ -113,5 +137,5 @@ https://github.com/login,login,password,,,Github,Productivity Tools,0
```
down to:
```
https://github.com/login,test,test,,,Github,0
https://github.com/login,login,password,,,Github,0
```