从自定义文件导入

对应的官方文档地址

本文介绍了如何格式化 .csv 和 .json 文件以导入 Bitwarden。其格式与 Bitwarden 密码库导出相同。要选择文件类型和格式，请确定目标密码库以及需要导入的项目类型：

• 基于您要导入到个人密码库还是导入到组织密码库来格式化文件。

• Bitwarden .csv 文件仅包含登录和安全笔记。如果您还需要处理身份和支付卡，请使用 .json 文件。

虽然某些项目类型无法导入，但您仍可将其添加到密码库：

• 将文件附件单独上传到新的密码库。

• 在新的密码库中重新创建 Send。

调整 .csv

个人密码库 .csv

⬇️下载示例 csv 文件

创建具有如下标头作为第一行的 UTF-8 编码的纯文本文件：

folder,favorite,type,name,notes,fields,reprompt,login_uri,login_username,login_password,login_totp

示例：

folder,favorite,type,name,notes,fields,reprompt,login_uri,login_username,login_password,login_totp
Social,1,login,Twitter,,,0,twitter.com,[email protected],password123,
,,login,EVGA,,,,https://www.evga.com/support/login.asp,[email protected],fakepassword,TOTPSEED123
,,login,My Bank,Bank PIN is 1234,"PIN: 1234",,https://www.wellsfargo.com/home.jhtml,john.smith,password123456,
,,note,My Note,"This is a secure note.",,,,,

导入此文件时，请选择 Bitwarden (csv) 作为您的文件格式。

组织密码库 .csv

⬇️下载示例 csv 文件

创建具有如下标头作为第一行的 UTF-8 编码的纯文本文件：

collections,type,name,notes,fields,reprompt,login_uri,login_username,login_password,login_totp

示例：

collections,type,name,notes,fields,reprompt,login_uri,login_username,login_password,login_totp
"Social,Marketing",login,Twitter,,,0,twitter.com,[email protected],password123,
"Finance",login,My Bank,"Bank PIN is 1234","PIN: 1234",0,https://www.wellsfargo.com/home.jhtml,john.smith,password123456,
"Finance",login,EVGA,,,0,https://www.evga.com/support/login.asp,[email protected],fakepassword,TOTPSEED123
"Finance",note,My Note,"This is a secure note.",,0,,,

如果您要对包含嵌套集合的 .csv 文件进行调整，请为每个不包含任何项目的集合创建专用条目，例如：

collections,type,name,notes,fields,reprompt,login_uri,login_username,login_password,login_totp
Parent Collection,,,,,,,,,,
Parent Collection/First Child Collection,,,,,,,,,,
Parent Collection/First Child Collection/Second Child Collection,login,Shared Credential,,,,https://website.com,username,password,,

导入此文件时，请选择 Bitwarden (csv) 作为您的文件格式。

最少要求值

您可能没有上述格式中显示的所有值的数据，但他们大多数是可选的。为了让 Bitwarden .csv 导入器能正常工作，您只需为每个对象提供以下值即可：

folder,favorite,type,name,notes,fields,reprompt,login_uri,login_username,login_password,login_totp
,,login,Login Name,,,,,,
,,note,Secure Note Name,,,,,,

调整 .json

个人密码库 .json

⬇️下载示例 json 文件

创建如下格式的 UTF-8 编码的纯文本文件：

{
  "folders": [
    {
      "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "name": "Folder Name"
    },
    ...
  ],
  "items": [
    {
    "passwordHistory": [
        {
          "lastUsedDate": "YYYY-MM-00T00:00:00.000Z",
          "password": "passwordValue"
        }
    ],
    "revisionDate": "YYYY-MM-00T00:00:00.000Z",
    "creationDate": "YYYY-MM-00T00:00:00.000Z",
    "deletedDate": null,    
    "id": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
    "organizationId": null,
    "folderId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "type": 1,
    "reprompt": 0,
    "name": "My Gmail Login",
    "notes": "This is my gmail login for import.",
    "favorite": false,
    "fields": [
        {
          "name": "custom-field-1",
          "value": "custom-field-value",
          "type": 0
        },
        ...
      ],
      "login": {
        "uris": [
          {
            "match": null,
            "uri": "https://mail.google.com"
          }
        ],
        "username": "[email protected]",
        "password": "myaccountpassword",
        "totp": otpauth://totp/my-secret-key
      },
      "collectionIds": null
    },
    ...
  ]
}

导入此文件时，请选择 Bitwarden (json) 作为您的文件格式。

组织密码库 .json

⬇️下载示例 json 文件

创建如下格式的 UTF-8 编码的纯文本文件：

{
  "collections": [
    {
      "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "organizationId": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
      "name": "My Collection",
      "externalId": null
    },
    ...
  ],
  "items": [
    {
      "passwordHistory": [
        {
          "lastUsedDate": "YYYY-MM-00T00:00:00.000Z",
          "password": "passwordValue"
        }
      ],
    "revisionDate": "YYYY-MM-00T00:00:00.000Z",
    "creationDate": "YYYY-MM-00T00:00:00.000Z",
    "deletedDate": null,
    "id": "vvvvvvvv-vvvv-vvvv-vvvv-vvvvvvvvvvvv",
    "organizationId": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
    "folderId": "zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz",
    "type": 1,
    "reprompt": 1,
    "name": "Our Shared Login",
    "notes": "A login for sharing",
    "favorite": false,
    "fields": [
        {
          "name": "custom-field-1",
          "value": "custom-field-value",
          "type": 0
        },
        ...
      ],
      "login": {
        "uris": [
          {
            "match": null,
            "uri": "https://mail.google.com"
          }
        ],
        "username": "[email protected]",
        "password": "myaccountpassword",
        "totp": otpauth://totp/my-secret-key
      },
      "collectionIds": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    },
    ...
  ]
}

导入此文件时，请选择 Bitwarden (json) 作为您的文件格式。

导入到现有集合

通过适当调整组织的 .json 文件，可以将新的登录项目导入到预先存在的集合中。

下面的示例演示了将单个项目导入到预先存在的集合中的正确格式。请注意，您需要：

• 获取组织 ID 和集合 ID。这些可以通过导航到网页 App 的集合，然后从地址栏中提取（例如 https://vault.bitwarden.com/#/organizations/<organizationId>/vault?collectionId=<collectionId> ）。

• 定义一个 "collections": [] 数组，其中包含预先存在的集合的数据，包括组织 ID 和集合 ID（见上文）及其名称。只要这 3 个数据点匹配，导入时就不会创建新的集合，而是将文件中的项目导入到预先存在的集合中。

{
  "encrypted": false,
  "collections": [
    {
      "id": "b8e6df17-5143-495e-92b2-aff700f48ecd",
      "organizationId": "55d8fa8c-32bb-47d7-a789-af8710f5eb99",
      "name": "My Existing Collection",
      "externalId": null
    }
  ],
  "folders": [],
  "items": [
    {
      "id": "2f27f8f8-c980-47f4-829a-aff801415845",
      "organizationId": "55d8fa8c-32bb-47d7-a789-af8710f5eb99",
      "folderId": null,
      "type": 1,
      "reprompt": 0,
      "name": "Item to Import",
      "notes": "A login item for sharing.",
      "favorite": false,
      "login": {
        "uris": [
          {
            "match": null,
            "uri": "https://mail.google.com"
          }
        ],
        "username": "my_username",
        "password": "my_password",
        "totp": null
      },
      "collectionIds": ["b8e6df17-5143-495e-92b2-aff700f48ecd"]
    }
  ]
}

最少要求键值对

您可能没有上述格式中显示的所有键值对的数据，但他们大多数是可选的。为了让 Bitwarden .json 导入器能正常工作，您只需要为每个对象提供以下键值对即可：

{
  "items": [
    {
    "type": 1,
    "name": "Login Item's Name",
    "login": {}                         
  },
  {
    "type": 2,
    "name": "Secure Note Item's Name",
    "secureNote": {}                     
  },
  {
    "type": 3,
    "name": "Card Item's Name",
    "card": {}                         
  },
  {
    "type": 4,
    "name": "Identity Item's Name",
    "identity": {}                     
  }
  ]
}

"login":、"secureNote":、"card": 以及 "identity": 对象可以作为空对象导入，但是我们建议使用尽可能多的数据来调整文件。

导入到 Bitwarden

准备好 .csv 或 .json 文件后，就可以将其导入个人密码库或组织密码库了。从文件格式列表中选择 Bitwarden (csv) 或 Bitwarden (json)。