自定义字段

对应的官方文档地址

自定义字段可在任何项目类型上使用，使您可以在密码库项目中存储额外的结构良好的数据字段。自定义字段保存为 Name:Value 对，它可以是这三种类型之一：

• 文本型：存储自由格式的输入（文本、数字等）的字段值

• 隐藏型：存储从视图中隐藏的自由格式输入的字段值（对于使用隐藏密码访问控制的组织特别有用）

• 布尔型：存储布尔值（真/假）的字段值

• 链接型：链接到项目的用户名或密码的字段值。指定正确的字段名称后，链接型自定义字段可用于解决浏览器扩展无法自动填充特定站点的用户名和密码的问题（了解更多）。

用于密钥的自定义字段

除了常见的网页服务输入（例如 PIN 和安全问题）外，自定义字段还可用于存储长度最多 5000 个字符的值，例如 RSA 4096 位 SSH 密钥。

自定义字段值的字符限制是根据加密后的字符数量来计算的。例如，一个 3383 个字符的 RSA-4096 私有 SSH 密钥在加密并存储在你的密码库中时将增长到约 4400 个字符。

创建自定义字段

可以在任何 Bitwarden 客户端中使用编辑项目面板中的自定义字段部分将自定义字段添加到密码库项目：

网页密码库中的自定义字段

自定义字段名称

指定的名称对于成功自动填充自定义字段很重要。对于浏览器扩展，您可以使用上下文菜单中的复制自定义字段名称选项快速获取正确的字段名称（在大多数情况下，通过右键单击表单元素）：

复制自定义字段名称

选择此上下文菜单选项将复制表单元素的 id、name、aria-label 或 placeholder 的值（按优先顺序）。

保存自定义字段后，您可以从浏览器扩展中自动填充它。

手动查找自定义字段名称

如果您不使用浏览器扩展，查找字段名称的最佳方法是使用 Web 浏览器的开发人员工具，如下面的示例所示：

浏览器扩展上下文菜单

1、在与登录项目的 URI 相匹配的网页上，右键点击你想要自动填充的字段，然后选择检查。该 HTML 元素将打开并在开发者控制台中高亮显示。

2、找到并复制元素 id（找到 id="xxx"，其中 xxx 是元素的 id 值）。

3、在相应的密码库项目的自定义字段部分，选择合适的字段类型，并选择 🞤新建自定义字段按钮。

选择自定义字段类型

4、将复制的元素 id 粘贴到名称字段中。

5、在值字段中指定要自动填充的所需信息（在上面的示例中为 PIN）。

自定义字段示例

6、保存此密码库项目。

保存自定义字段后，您可以从浏览器扩展中自动填充它。

更多关于自定义字段名称

优先顺序

如果您手动命名自定义字段，则应按优先顺序使用以下 HTML 表单元素属性/值之一：

1. HTML 表单元素的 id 属性

2. HTML 表单元素的 name 属性

3. HTML 表单元素的 aria-label 属性

4. HTML 表单元素的 placeholder 属性

匹配

字段名称的匹配是精确且不区分大小写的。例如，假如您的自定义字段的名称为 PIN：

• 提供自动填充：对于 pin、Pin、PIN 等

• 不提供自动填充：对于 pin2 或 mypin

前缀

在两种情况下，您可以通过使用前缀对匹配进行更多控制：

• CSV：使用 csv= 作为自定义字段名称的前缀，允许您指定多个名称来检索和比较以进行自动填充，例如 csv=pin,mypin,pincode。

• 正则表达式：使用 regex= 作为自定义字段的名称的前缀允许您在执行自动填充时执行正则表达式比较。例如，regex=^first.*name 将为 firstName、First_name 和 First Name 提供自动填充。