mirror of
https://github.com/bitwarden/help
synced 2025-12-06 00:03:30 +00:00
* initial commit
* adding quotes for the array error
* Create Gemfile
* Create Gemfile.lock
* add .nvmrc and .node-version
* removed /article from URL
* update links to work with netlify
* more fixed links
* link fixes
* update bad links
* Update netlify.toml
toml test for redirects
* article redirect
* link fixes
* Update index.html
* Update netlify.toml
* Update _config.yml
* Update netlify.toml
* Update netlify.toml
* Update netlify.toml
* Update netlify.toml
* Update netlify.toml
* add article back into URL for launch
* Update netlify.toml
* Update netlify.toml
* add order to categories front matter
* Update netlify.toml
* update
* sidemenu update
* Revert "sidemenu update"
This reverts commit 5441c3d35c.
* update order prop
* Navbar updates per Gary and compiler warnings
* font/style tweaks
* Update sidebar.html
* Stage Release Documentation (#739)
* initial drafts
* rewrite Custom Fields article to prioritize new context-menu option & better organize ancillary information
* edit
* edit
* Custom Field Context Menu & CAPTCHA item in release notes
* SSO relink event
* update rn
* small edits
* improve release notes titles
* fix side menu
* Edits courtest of mportune!
* update order
* link fixes
* link cleanup
* image updates and a link
* fix trailing slash
Co-authored-by: DanHillesheim <79476558+DanHillesheim@users.noreply.github.com>
155 lines
6.4 KiB
Markdown
155 lines
6.4 KiB
Markdown
---
|
|
layout: article
|
|
title: Encrypted Exports
|
|
categories: [import-export]
|
|
featured: true
|
|
popular: false
|
|
tags: [import]
|
|
order: "08"
|
|
---
|
|
|
|
Vault data can be [exported]({{site.baseurl}}/article/export-your-data/) in an encrypted JSON file. These exports are encrypted using your [account's encryption key]({{site.baseurl}}/article/account-encryption-key/), which are generated on account creation and unique to each Bitwarden user account.
|
|
|
|
{% callout warning %}
|
|
[Rotating your account's encryption key]({{site.baseurl}}/article/account-encryption-key/) 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]({{site.baseurl}}/article/export-your-data/):
|
|
|
|
<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 %}
|
|
|
|
#### 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** → **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 encrypted_json`, for example:
|
|
|
|
```
|
|
bw export my-master-password --output /users/me/documents/ --format encrypted_json
|
|
```
|
|
|
|
For more detail, see our [CLI documentation]({{site.baseurl}}/article/cli/).
|
|
|
|
{% endcapture %}
|
|
{{ cli_info | markdownify}}
|
|
</div>
|
|
</div>
|
|
|
|
## Import an Encrypted Export
|
|
|
|
Importing an Encrypted Export follows the [normal import procedure]({{site.baseurl}}/article/import-data/), which can **only be done from the** [**Web Vault**](https://vault.bitwarden.com){:target="\_blank"}:
|
|
|
|
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 **Bitwarden (json)**.
|
|
|
|
{% 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]({{site.baseurl}}/article/account-encryption-key/).{% 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.
|