---
title: QR 码
description: 直接在 IDCloud 门户中启用验证流程中的 QR 码显示,让您的客户可以在桌面端开始流程,在移动端继续完成。
canonical: https://developer.unico.io/zh-CN/dual-api/product-guide/portal-idcloud/settings/qr-code
locale: zh-CN
generated_by: markdown-export
---

**QR 码**功能让您的客户可以在电脑上开始身份验证,并**在移动端继续完成**。启用后,流程会
在桌面端界面上显示一个 QR 码;客户用手机摄像头对准它,即可在手机上继续完成该流程。

在此界面上,您可以开启或关闭该显示功能,无需提交工单。

:::info
**适用对象:** 用户在桌面端开始流程且需要摄像头进行采集的客户。

**终端用户的变化:** 用户不必再被困在没有摄像头或摄像头效果不佳的设备上,而是可以转到
移动端继续完成,移动端通常拥有更好的摄像头。

**查找位置:** IDCloud 门户 → 侧边栏**设置** → **QR 码**选项卡。
:::

在此界面出现之前,启用该功能需要 Unico 运营团队进行人工操作。现在只需一个开关即可完成。

## 开始之前

### 访问权限

您的用户账号需要拥有**管理员**或**配置员**权限配置。如果 QR 码选项卡没有显示,请联系
您的账户管理员。

### 配置的生效方式

| | |
| :- | :- |
| **立即生效** | 没有保存按钮。开关会在您点击的瞬间应用更改。 |
| **环境相互独立** | 预发布门户仅影响 UAT 环境;生产门户仅影响生产环境。在其中一个环境中启用不会同时启用另一个环境。 |
| **生效时间** | 适用于更改之后启动的流程。已在进行中的流程将按原方式继续。 |
| **变更日志** | 每次更改都会记录相应的用户和时间戳。该界面不显示此类历史记录——它保存在门户日志中。 |

### 启用前需要了解的内容

QR 码流程本身**已经存在且不会改变**:此界面控制的仅仅是是否显示该流程。您无法在此处
配置外观、有效期或 QR 码的行为。

建议先在**预发布环境**中启用并完整体验一次流程,然后再在生产环境中开启——这并非因为
配置复杂,而是为了让您的支持团队熟悉客户将会看到的界面。

## 分步说明

### 步骤 1 —— 打开 QR 码选项卡

在 IDCloud 门户中,点击侧边栏中的**齿轮图标(设置)**,然后选择**QR 码**选项卡。

该界面显示一张卡片,**验证流程中的 QR 码**,其中带有**在流程中启用 QR 码**开关。开关
的位置显示当前状态:开启表示流程已经在显示 QR 码。

![QR 码选项卡,齿轮图标已高亮显示](/img/product-guide/qr-code/en/01-qr-code-tab.png)

*"验证流程中的 QR 码"卡片及启用开关。*

### 步骤 2 —— 打开或关闭开关

点击**在流程中启用 QR 码**开关。

更改会立即生效,门户会显示通知以确认操作成功——如果出现问题,则显示错误提示。**没有
保存按钮,也没有生效前的确认步骤。**

**点击前请检查所处环境。** 由于更改会立即生效且没有确认步骤,建议在操作开关之前先确认
您所在的是预发布门户还是生产门户。在生产环境中误操作开启该功能,会立即影响到您真实客户
的流程。

如果通知显示错误,则状态未发生更改。请重试;如果问题持续存在,请联系支持团队。

![已开启的"在流程中启用 QR 码"开关](/img/product-guide/qr-code/en/02-qr-code-enabled.png)

*已开启的开关,以及门户的确认反馈信息。*

### 步骤 3 —— 在真实流程中进行验证

从桌面端启动一个流程,并确认 QR 码是否显示出来。

**请进行真实验证,而不仅仅是操作开关。** 开关只能确认配置已保存,并不能证明流程正如您
预期那样显示了 QR 码。完整体验一次流程,是唯一能回答这个问题的测试方式——而且这比提交
工单所花费的时间更少。

## 常见问题

**我已经启用了该功能,但流程中没有显示 QR 码。** 请检查三点:您是否在正确环境的门户中
进行了更改(预发布环境仅影响 UAT)、您测试的流程是否是在更改**之后**启动的,以及您是否
从桌面端访问——QR 码的作用是将流程转移到移动端,因此对于已经在移动端的用户,它不会显示。

**该更改会应用到已经在运行的流程吗?** 不会。它仅适用于更改之后启动的流程。

**我在预发布环境中启用了该功能。这也会应用到生产环境吗?** 不会。每个门户仅影响其自身
的环境。您需要在生产门户中重复该更改操作。

**我有多个分支。启用该功能会应用到所有分支吗?** 请先与 Unico 支持团队确认该行为,不要
自行假设。当前界面不提供分支选择功能,跨租户和跨分支的应用范围取决于您账户的配置。

**我不小心禁用了该功能,该如何重新开启?** 再次点击开关即可。该效果在两个方向上都是
立即生效的,不会丢失任何内容——该设置只是开或关的状态。

**要使用 QR 码,我需要在集成中做任何更改吗?** 不需要。该流程已经存在于产品中;此界面
只控制是否显示该流程。

**是谁启用了该功能,以及何时启用的?** 该更改会被记录,但界面不显示此类历史记录。要
查询,请联系 Unico 支持团队。

**我可以配置 QR 码的外观或有效期吗?** 不可以。唯一可用的设置就是开启或关闭该功能。

## 快速参考

```text
IDCloud 门户
 └─ 设置(侧边栏齿轮图标)
     └─ QR 码选项卡
         └─ 验证流程中的 QR 码
             └─ 在流程中启用 QR 码 ... 开/关

立即生效,无需保存按钮 · UAT 与生产环境相互独立 · 适用于更改之后启动的流程
```