> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 两步验证

> 设置、管理和恢复OneSignal账户的双重身份验证(2FA)，包括恢复代码、转移到新设备以及被锁定后重新获取访问权限。

## 概述

两步验证(2FA)通过在每次登录时要求来自身份验证器应用程序的有时效性的6位代码，为您的OneSignal账户增加一层安全保护。如果您失去对身份验证器应用程序的访问权限，可以使用一次性恢复代码登录并在新设备上重新配置2FA。

<Warning>
  请在您**长期控制的个人设备**上设置身份验证器——而非共享或临时测试设备。如果您失去对该设备和恢复代码的访问权限，您将被锁定在账户之外。
</Warning>

***

## 设置

### 下载身份验证器应用程序

在您的**个人**移动设备上安装以下身份验证器应用程序之一：

* **Google Authenticator**（推荐——支持[云备份](https://support.google.com/accounts/answer/1066447)）：[Android](https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2) | [iOS](https://apps.apple.com/us/app/google-authenticator/id388497605)
* **Microsoft Authenticator**：[Android](https://play.google.com/store/apps/details?id=com.azure.authenticator) | [iOS](https://apps.apple.com/us/app/microsoft-authenticator/id983156458)
* **Authy**（支持多设备同步）：[authy.com](https://authy.com/download/)

<Tip>
  选择支持**云备份或多设备同步**的应用程序（如启用了云备份的Google Authenticator）。这可以在您丢失或更换手机时保护您的账户。
</Tip>

### 启用两步验证

<Steps>
  <Step title="登录您的OneSignal账户">
    如果您被锁定，请参阅[丢失了设备或身份验证器应用程序？](#lost-your-device-or-authenticator-app)。
  </Step>

  <Step title="进入账户管理">
    导航到[账户管理](https://dashboard.onesignal.com/profile)或点击**您的邮箱下拉菜单 > 管理账户**。

    <Frame caption="账户管理">
      <img src="https://mintcdn.com/onesignal/D2iNXoUF4xP1r1nx/images/dashboard/manage-account.png?fit=max&auto=format&n=D2iNXoUF4xP1r1nx&q=85&s=4e8ecc46c28a193f9125931a778f4eed" width="1014" height="717" data-path="images/dashboard/manage-account.png" />
    </Frame>
  </Step>

  <Step title="启用或重新配置两步验证">
    滚动到**两步验证**部分，点击**启用**（如果已设置则点击**重新配置**）。

    <Frame caption="启用两步验证">
      <img src="https://mintcdn.com/onesignal/D2iNXoUF4xP1r1nx/images/dashboard/profile-2stepauth.png?fit=max&auto=format&n=D2iNXoUF4xP1r1nx&q=85&s=fdb47205733561592fe3e84b0deaa331" width="973" height="406" data-path="images/dashboard/profile-2stepauth.png" />
    </Frame>
  </Step>
</Steps>

### 设置您的身份验证器应用程序

<Steps>
  <Step title="扫描二维码或手动输入密钥">
    在"启用两步验证"设置屏幕上，使用您的身份验证器应用程序扫描二维码或手动输入**密钥**。

    <Frame caption="重新配置两步验证">
      <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/95e9933-Screenshot_2023-02-28_at_11.07.19.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=49bcc4af161b71f7fad4a4d3bd73cc32" width="1100" height="1236" data-path="images/docs/95e9933-Screenshot_2023-02-28_at_11.07.19.png" />
    </Frame>

    如果手动输入，请点击**添加账户**，选择"输入设置密钥"，并为其命名一个容易记住的名字，如`OneSignal_[您的邮箱]`。

    <Frame caption="重新配置两步验证">
      <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/fb03ac0-sample-add-auth-1.png?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=44cfc6176d9f5029ad2041022eb52961" width="340" height="198" data-path="images/docs/fb03ac0-sample-add-auth-1.png" />
    </Frame>

    <br />

    <Frame caption="重新配置两步验证">
      <img src="https://mintcdn.com/onesignal/YOTSrtBSoqdrJ37A/images/docs/4ef7cbd-sample-add-auth-2.png?fit=max&auto=format&n=YOTSrtBSoqdrJ37A&q=85&s=265994ad6c47c6d03a2185ba877c22b4" width="464" height="450" data-path="images/docs/4ef7cbd-sample-add-auth-2.png" />
    </Frame>
  </Step>

  <Step title="获取6位代码">
    应用程序现在将每30秒生成一个6位代码。
  </Step>

  <Step title="使用验证代码登录">
    * 在OneSignal中，输入身份验证应用程序中的当前6位代码。
    * 如果代码失败，等待30秒并尝试下一个代码。
    * 如果代码仍然失败，请检查您是否正确输入了密钥，然后重试。
  </Step>
</Steps>

***

## 恢复代码

成功设置后，OneSignal将显示**10个一次性恢复代码**。每个代码**只能使用一次**，在您失去对身份验证器应用程序的访问权限时用于登录。

<Warning>
  恢复代码在设置期间**仅显示一次**。请立即下载或复制，并将其存储在安全的位置（如密码管理器中）。如果您同时丢失了身份验证器设备和恢复代码，您需要[联系支持](#i-lost-my-recovery-codes-and-my-device)以重新获取访问权限。
</Warning>

<Frame caption="设置完成后立即下载您的恢复代码。">
  <img src="https://mintcdn.com/onesignal/Xl2NHJvxakrK4JbL/images/docs/ef0595c-Screenshot_2023-01-18_at_3.23.31_PM.png?fit=max&auto=format&n=Xl2NHJvxakrK4JbL&q=85&s=a8bb3e088721eae0277f01c44683fb51" width="579" height="557" data-path="images/docs/ef0595c-Screenshot_2023-01-18_at_3.23.31_PM.png" />
</Frame>

### 使用恢复代码登录

如果您无法访问身份验证器应用程序，请使用恢复代码登录：

1. 在OneSignal登录页面输入您的电子邮件和密码。
2. 在2FA验证屏幕上，选择使用恢复代码的选项。
3. 输入您保存的恢复代码之一。每个代码只能使用一次。使用后请将其从列表中划掉。

<Warning>
  使用恢复代码登录后，**请立即在您当前拥有的设备上重新配置2FA**。如果您持续使用恢复代码而不重新配置，代码最终会用完，届时您将被锁定在账户之外。请参阅[将2FA转移到新设备](#transfer-2fa-to-a-new-device)。
</Warning>

***

### 丢失了设备或身份验证器应用程序？

如果您不再拥有安装了身份验证器应用程序的设备，请根据您的情况选择对应的方案：

**如果您有恢复代码：**

<Steps>
  <Step title="使用恢复代码登录">
    按照[使用恢复代码登录](#log-in-with-a-recovery-code)中的步骤操作。
  </Step>

  <Step title="将2FA转移到您当前的设备">
    立即在您控制的设备上重新配置2FA。请参阅[将2FA转移到新设备](#transfer-2fa-to-a-new-device)。
  </Step>
</Steps>

**如果您丢失了恢复代码和设备：**

发送邮件至`support@onesignal.com`并**抄送一位可以验证您身份的团队成员**。如果您没有其他可以访问OneSignal应用程序的团队成员，支持团队将协助您进行替代验证。

***

## 将2FA转移到新设备

如果您在一个不再能访问的设备上设置了2FA（例如测试设备或旧手机），请在当前设备上重新配置：

<Steps>
  <Step title="登录您的OneSignal账户">
    使用您的身份验证器应用程序或[恢复代码](#log-in-with-a-recovery-code)登录。
  </Step>

  <Step title="进入账户管理">
    导航到[账户管理](https://dashboard.onesignal.com/profile)或点击**您的邮箱下拉菜单 > 管理账户**。
  </Step>

  <Step title="重新配置两步验证">
    滚动到**两步验证**部分，点击**重新配置**。
  </Step>

  <Step title="在新设备上设置身份验证器">
    使用当前设备上的身份验证器应用程序扫描新的二维码。有关详细信息，请参阅[设置您的身份验证器应用程序](#set-up-your-authenticator-app)。
  </Step>

  <Step title="保存新的恢复代码">
    OneSignal将生成新的10个恢复代码。之前的代码将失效。请立即保存这些新代码。
  </Step>
</Steps>

***

## 为所有团队成员强制启用2FA

在您的组织中强制执行两步验证：

<Steps>
  <Step title="您必须是组织管理员。">
    有关详细信息，请参阅[团队成员](./manage-team-members)。
  </Step>

  <Step title="导航到您的组织。">
    在左侧栏导航到[组织](https://dashboard.onesignal.com/organization)，并选择您的组织。
  </Step>

  <Step title="在团队成员 > 安全下，点击启用。">
    <Frame caption="组织范围内的2FA强制执行">
      <img src="https://mintcdn.com/onesignal/nO2bC5lVWj6NEfK6/images/dashboard/enable-2fa-org.png?fit=max&auto=format&n=nO2bC5lVWj6NEfK6&q=85&s=ad5949e79376bc8ae48d7322b38b6a12" width="3000" height="1228" data-path="images/dashboard/enable-2fa-org.png" />
    </Frame>
  </Step>

  <Step title="选择为所有用户要求两步验证，然后点击继续。">
    <Frame caption="为您应用程序的所有用户要求两步验证。">
      <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/1b138b3-Screenshot_2023-01-18_at_3.58.37_PM.png?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=aaed5a436f7f8a3270c1b7f31e7476e9" width="577" height="530" data-path="images/docs/1b138b3-Screenshot_2023-01-18_at_3.58.37_PM.png" />
    </Frame>
  </Step>
</Steps>

<Check>
  未来邀请用户加入组织或应用程序时，将要求用户在访问之前设置2FA。

  任何未使用2FA的用户在下次登录时将被要求设置2FA。
</Check>

***

## 禁用或重新配置2FA

<Warning>
  如果您的组织要求启用2FA，您就不能禁用它。如有需要，请联系您的[组织管理员](./manage-team-members)或`support@onesignal.com`。
</Warning>

按照[启用两步验证](#enable-2-step-authentication)的步骤操作，如果已启用，您将有禁用或重新配置的选项。

***

## 常见问题

### 我被锁定了——如何重新获取访问权限？

如果您有恢复代码，请使用一个[登录](#log-in-with-a-recovery-code)，然后立即[将2FA转移到当前设备](#transfer-2fa-to-a-new-device)。如果您已用完所有恢复代码或丢失了它们，请发送邮件至`support@onesignal.com`并**抄送一位可以验证您身份的团队成员**。

### 我丢失了恢复代码和设备

发送邮件至`support@onesignal.com`并**抄送一位可以验证您身份的团队成员**。如果您没有其他可以访问的团队成员，支持团队将协助您进行替代验证。

### 为什么每次登录都要求我输入恢复代码？

这意味着您的身份验证器应用程序不再为您的OneSignal账户生成有效代码——通常是因为应用程序在您不再拥有的设备上。每个恢复代码只能使用一次，因此最终会用完。要永久解决此问题，请在登录后[将2FA转移到您当前使用的设备](#transfer-2fa-to-a-new-device)。

### 为什么我无法登录或看到"配置OTP失败"？

请尝试：

* 等待下一个30秒代码周期
* 禁用浏览器扩展（AdBlock、CORS）
* 将`*.onesignal.com`添加到白名单
* 禁用Opera的"阻止跟踪器"
* 强制刷新
* 尝试其他浏览器

仍然有问题？发送邮件至`support@onesignal.com`并**抄送一位可以验证您身份的团队成员**。

### 我忘记了密码

[重置您的密码](https://dashboard.onesignal.com/password-reset)。密码重置与2FA无关——重置密码后，您仍然需要身份验证器应用程序或恢复代码才能登录。

### 我可以在OAuth下使用2FA吗？

可以。通过OAuth登录后按照相同的设置流程操作。

### 支持哪些身份验证器应用程序？

任何兼容TOTP的应用程序均可使用，包括Google Authenticator、Microsoft Authenticator、Authy、1Password和Bitwarden。请选择支持云备份或多设备同步的应用程序，以避免在更换手机时失去访问权限。

### OneSignal支持Okta吗？

支持，有两个选项：

1. 您的Okta管理员可以使用[安全Web身份验证(SWA)](https://help.okta.com/en/prod/Content/Topics/Apps/Apps_Overview_of_Managing_Apps_and_SSO.htm)将OneSignal添加为应用程序。请参阅[Okta上的OneSignal集成](https://www.okta.com/integrations/onesignal/)了解设置方法。OneSignal的2FA与Okta是独立的。
2. 联系我们的[销售团队](https://www.onesignal.com/contact)，根据您的方案讨论设置事宜。

### 登录方式图标的含义是什么？

<Frame caption="登录方式图标定义。">
  <img src="https://mintcdn.com/onesignal/9_Q1FZLh6C0BFLq-/images/docs/ca2fc2f-icons.png?fit=max&auto=format&n=9_Q1FZLh6C0BFLq-&q=85&s=85d3ebb31ee86122a2acfdc654798ae8" alt="登录方式图标" width="1114" height="680" data-path="images/docs/ca2fc2f-icons.png" />
</Frame>

***