自定义字段

对应的官方文档地址

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

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

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

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

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

用于密钥的自定义字段

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

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

创建自定义字段

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

网页 App 中的自定义字段

自定义字段名称

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

复制自定义字段名称

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

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

手动查找自定义字段名称

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

浏览器扩展上下文菜单

1、在带有自定义字段的网页上，右键单击要自动填充的字段并选择检查。HTML 元素将打开并在开发人员控制台中突出显示。

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

3、在相关密码库项目的自定义字段部分，选择适当的字段类型，然后选择 ✚新增自定义字段按钮：

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

5、在值字段中指定需要自动填充的信息（在上例中为电话号码）。

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 提供自动填充。