* Add article for importing data from password safe * Changed ordering to keep import articles grouped * Added link to "Import from Password Safe" article * Added link to CONTRIBUTING.md in README
6.4 KiB
layout, title, categories, featured, popular, tags, order
| layout | title | categories | featured | popular | tags | order | ||
|---|---|---|---|---|---|---|---|---|
| article | Encrypted Exports |
|
true | false |
|
08 |
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 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 %}
An Encrypted Export of the following plaintext login item:
{
...
"login": {
"username": "mylogin",
"password": "mypassword",
"totp": "otpauth://totp/my-secret-key"
},
...
Will look something like:
{
...
"login": {
"username": "9.dZwQ+b9Zasp98dnfp[g|dHZZ1p19783bn1KzkEsA=l52bcWB/w9unvCt2zE/kCwdpiubAOf104os}",
"password": "1o8y3oqsp8n8986HmW7qA=oiCZo872b3dbp0nzT/Pw=|A2lgso87bfDBCys049ano278ebdmTe4:",
"totp": "2CIUxtpo870B)*^GW2ta/xb0IYyepO(*&G(&BB84LZ5ByZxu0E9hTTs6PHg0=8q5DHEPU&bp9&*bns3EYgETXpiu9898sxO78l"
},
...
Create an Encrypted Export
Creating an Encrypted Export follows the [normal export procedure]({% 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:
- Select Tools from the top navigation bar.
- Select Export Vault from the left-hand Tools menu.
- On the Vault Export page, choose
.json (Encrypted)for the File Format. - Enter your Master Password and select the Export Vault button.
{% endcapture %} {{ web_vault | markdownify}}
Export from a Browser Extension
To create an encrypted export of your personal Vault data from a Browser Extension:
- Open the {% icon fa-cogs %} Settings tab.
- Scroll down to the Tools section and select the Export Vault option.
- On the Export Vault view, choose
.json (Encrypted)for the File Format. - Enter your Master Password and select Submit.
{% endcapture %} {{ browser_extension | markdownify}}
Export from Desktop
To create an encrypted export of your personal Vault data from a Desktop app:
- From the menu bar, navigate to File → Export Vault.
- In the Export Vault window, choose
.json (Encrypted)for the File Format. - Enter your Master Password and select the {% icon fa-download %} Download button.
{% endcapture %} {{ desktop_info | markdownify}}
Export from Mobile
To create an encrypted export of your personal Vault data from a Mobile app:
- Tap the {% icon fa-cogs %} Settings tab.
- Scroll down to the Tools section and tap the Export Vault option.
- On the Export Vault view, choose
.json (Encrypted)for the File Format. - Enter your Master Password and tap the Export Vault button.
{% endcapture %} {{ mobile_info | markdownify}}
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 encrypted_json, for example:
bw export my-master-password --output /users/me/documents/ --format encrypted_json
For more detail, see our [CLI documentation]({% link _articles/miscellaneous/cli.md %}).
{% endcapture %} {{ cli_info | markdownify}}
Import an Encrypted Export
Importing an Encrypted Export follows the [normal import procedure]({% link _articles/importing/import-data.md %}), which can only be done from the Web Vault{:target="_blank"}:
-
In the Web Vault, select Tools from the top navigation bar.
-
Select Import Data from the left-hand Tools menu.
-
From the format dropdown, choose Bitwarden (json).
{% callout success %}There is no import option specifically for Encrypted Exports. A handler will determine that the
.jsonfile is encrypted and attempt to decrypt the file using your [account's encryption key]({% link _articles/account/account-encryption-key.md %}).{% endcallout %} -
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 %}
-
Select the Import Data button to complete your import.