# 从 iOS App 自动填充

{% hint style="success" %}
对应的[官方文档地址](https://bitwarden.com/help/article/auto-fill-ios/)
{% endhint %}

Bitwarden 可以自动填充您的密码和通行密钥，以便您可以无缝登录网站和 App，同时维护强大而安全的密码。自动填充功能通过检测与您登录的服务相匹配的密码库项目，以减少了您在登录过程中的复制和粘贴操作。

移动端自动填充当前不支持自定义字段和拆分登录工作流程（当用户名和密码字段显示在独立的界面上时）。

## 设置自动填充 <a href="#setup-auto-fill" id="setup-auto-fill"></a>

{% hint style="info" %}
大多数自动填充方式要求登录项目具有[分配的网站 URI](https://help.ppgg.in/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)。
{% endhint %}

iOS 上有几种不同的自动填充方式：

* **键盘自动填充**：（推荐）使用此选项可以在任何 iOS App（包括网页浏览器）中通过一个键盘按钮或上滑提示来使用 Bitwarden 自动填充。
* **浏览器 App 扩展自动填充**：使用此选项仅可以在网页浏览器 App（例如 Safari）中通过分享菜单来使用 Bitwarden 自动填充。
* **长按文本字段自动填充**：使用此选项可在更多位置从 Bitwarden 自动填充。

{% hint style="success" %}
如果设备的[密码库超时行为](https://help.ppgg.in/account/log-in-and-unlock/vault-timeout-options#vault-timeout-action)设置为**注销**，并且您仅启用了需要 NFC（例如带 NFC 的 YubiKey）的[两步登录方式](https://help.ppgg.in/docs/account/two-step-login/setup-two-step-login/two-step-login-methods)，则当前无法在 iOS 上使用自动填充，因为 iOS 不允许 NFC 输入中断自动填充工作流。

要么将您的密码库超时行为改为**锁定**，要么启用另一种两步登录方式。
{% endhint %}

{% hint style="info" %}
如果您使用的 Argon2id 的 KDF 内存值高于 48 MB，则每次启动 iOS 自动填充或通过共享表单创建新的 Send 时，都会显示警告对话框。要避免出现此消息，参阅在[此处](https://help.ppgg.in/security/encryption/encryption-key-derivation#argon2id)调整 Argon2id 设置或启用[生物识别解锁](https://help.ppgg.in/account/log-in-and-unlock/more-unlock-options/unlocking-with-biometrics#enable-unlock-with-biometrics)。
{% endhint %}

### 键盘自动填充 <a href="#keyboard-auto-fill" id="keyboard-auto-fill"></a>

要在 iOS 上激活键盘自动填充密码，请完成以下步骤。这也将激活用于通行密钥自动填充的上滑菜单：

1、在您的设备上打开 iOS **️设置**，然后选点击**通用**。

2、点击**自动填充与密码**。&#x20;

3、打开**自动填充密码和通行密钥**开关，然后从**自动填充自：**&#x5217;表中打开 **Bitwarden**：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/5jxVP3WslH4ppIdFq9viqX/613fbbb9eacbb14f56c0fbcee17bc9a1/2025-01-22_11-00-15.png?w=352&#x26;fm=avif" alt=""><figcaption><p>iOS 上设置自动填充</p></figcaption></figure></div>

{% hint style="success" %}
我们强烈建议在**自动填充自：**&#x5217;表中禁用任何其他自动填充服务（例如钥匙串）。
{% endhint %}

接下来，测试一下自动填充以确保其可以正常工作：

1、打开一个您当前未登录的 App 或网站。

2、在登录界面点击用户名或密码字段。键盘将上滑出一个匹配的登录 (`my_username`) 或 **🔑密码**按钮：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/vQG8BTWlHg2AQxBlXe4S3/63f2a5e9c32c2f38b29ec0ab0af24d57/autofill-ios.jpeg?w=932&#x26;fm=avif" alt=""><figcaption><p>iOS 上的自动填充</p></figcaption></figure></div>

3、如果显示一个[匹配的登录](https://help.ppgg.in/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)，请点击以自动填充。如果显示 **🔑密码**按钮，请点击它浏览您的密码库以搜索要使用的登录项目。如果显示 **🔑密码**按钮，可能是因为您的密码库中没有具有[匹配 URI](https://help.ppgg.in/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill) 的项目。

{% hint style="info" %}
遇到 `Biometric unlock disabled pending verification of master password`（生物识别解锁已禁用，等待验证主密码） 消息吗？了解[该怎么做](https://help.ppgg.in/docs/password-manager/auto-fill-faqs#q-what-do-i-do-about-biometric-unlock-disabled-pending-verification-of-master-password)。
{% endhint %}

### 浏览器 App 扩展自动填充 <a href="#browser-app-extension-auto-fill" id="browser-app-extension-auto-fill"></a>

要启用 iOS 上的浏览器 App 扩展自动填充：

1、打开 Bitwarden iOS  App 然后点击 **⚙️设置**。

2、点击**自动填充**。

3、在自动填充部分点击 **App 扩展**选项。&#x20;

4、点击**启用 App 扩展**按钮。&#x20;

5、从上滑出的分享菜单中，点击 **Bitwarden**。&#x20;

绿色的`扩展已激活！`消息指示已成功激活此选项。

然后测试一下 App 扩展以确保其可以正常工作：

1、打开您设备的网页浏览器，然后导航到一个您当前未登录的网站。

2、点击**分享**图标。

3、向下滚动并点击 **Bitwarden** 选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/3Icxd3YqcXjBrjHVAeluwm/8be732b1ed2adebfd0a7af00f7150a97/extension.png?w=311&#x26;fm=avif" alt=""><figcaption><p>共享菜单中的 Bitwarden</p></figcaption></figure></div>

{% hint style="info" %}
如果您启用了[使用生物识别解锁](https://help.ppgg.in/docs/account/log-in-and-unlock/more-unlock-options/unlocking-with-biometrics)，则首次点击此选项时，将提示您验证您的主密码。
{% endhint %}

4、Bitwarden 界面将在您的设备上向上滑出，并列出此网站的[匹配登录项目](https://help.ppgg.in/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)。点击该项目以自动填充。

{% hint style="success" %}
如果未列出登录项目，则可能是因为您的密码库中没有与 [URI 匹配](https://help.ppgg.in/docs/password-manager/autofill/troubleshoot-autofill/forming-uris-for-autofill)的项目。
{% endhint %}

### 长按文本字段自动填充 <a href="#long-press-a-text-field" id="long-press-a-text-field"></a>

通过长按任何文本字段，可以从 Bitwarden 自动填充数据，前提是键盘自动填充选项已激活：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/77glhnjH87Z6PKscElWtZy/f9229264859577c0490cf423237f8502/2025-01-22_11-05-33.png?w=359&#x26;fm=avif" alt=""><figcaption><p>iOS 上长按文本字段</p></figcaption></figure></div>

## 自动填充期间切换账户 <a href="#switch-accounts-during-autofill" id="switch-accounts-during-autofill"></a>

如果您[登录了多个账户](https://help.ppgg.in/docs/account/log-in-and-unlock/more-log-in-options/account-switching)，您的移动 App 将默认尝试自动填充当前活动账户的凭据。在自动填充过程中，您可以通过轻按头像气泡来切换账户。

## 使用通行密钥 <a href="#using-passkeys" id="using-passkeys"></a>

### 设置 Bitwarden 以使用通行密钥 <a href="#setup-bitwarden-for-use-with-passkeys" id="setup-bitwarden-for-use-with-passkeys"></a>

自动填充通行密钥（包括 Bitwarden 提示创建新的通行密钥）需要 iOS 17.0 或更高版本。

要使用下述功能：

1、打开 iOS **设置** App。

2、导航至**密码** → **密码选项**。

3、打开以下选项：

* 打开**自动填充密码和通行密钥**。
* 在**密码和通行密钥来源：** 列表中打开 **Bitwarden**。

### 创建通行密钥 <a href="#create-a-passkey" id="create-a-passkey"></a>

在网站或 App 上创建新的通行密钥时，iOS App 将提示您存储此通行密钥：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6rccoaRtUBbEnUjQxfSTNi/d033196df75950bae5bd7a20e8a7edd2/passkey-ios-1__1_.png?w=500&#x26;fm=avif" alt=""><figcaption><p>创建通行密钥</p></figcaption></figure></div>

选择**继续**。

{% hint style="info" %}
如果您不想将此通行密钥存储在 Bitwarden 中，请选择**其他选项**，或者选择**其他登录选项**以使用未存储在 Bitwarden 中的通行密钥登录。
{% endhint %}

如果该服务已存在一个通行密钥，Bitwarden 将允许您通过选择 **➕**&#x56FE;标以创建一个新的项目来保存新的通行密钥，或覆盖现有的通行密钥：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/6L5s6XBFjvaaEiDZ68m00Q/a130745c2276068fd0be066a47a34684/passkey-ios-2__1_.png?w=500&#x26;fm=avif" alt=""><figcaption><p>保存或覆盖通行密钥</p></figcaption></figure></div>

{% hint style="info" %}
每个登录项目只能保存一个通行密钥。如果一个凭证保存在多个地方，例如作为两个登录项目分别保存在个人密码库和组织密码库中，则每个登录项目都可以保存不同的通行密钥。
{% endhint %}

### 使用存储在 Bitwarden 中的通行密钥登录 <a href="#sign-in-using-a-passkey-stored-in-bitwarden" id="sign-in-using-a-passkey-stored-in-bitwarden"></a>

要使用 Bitwarden 中存储的密钥，请在网站上启动通行密钥登录。移动 App 将提供使用存储在 Bitwarden 密码库中的通行密钥登录的选项：

<div align="left" data-with-frame="true"><figure><img src="https://bitwarden.com/assets/b6fY5o4CBxhW4ZjDIpanR/56ffdbf1ff93b7387be273bc7df15e6b/passkey-ios-3__1_.png?w=500&#x26;fm=avif" alt=""><figcaption><p>使用通行密钥登录</p></figcaption></figure></div>

选择**继续**。

{% hint style="info" %}
如果您不想将此通行密钥存储在 Bitwarden 中，请选择**其他选项**，或者选择**其他登录选项**以使用未存储在 Bitwarden 中的通行密钥登录。
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.ppgg.in/docs/password-manager/autofill/autofill-from/autofill-from-ios.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.