批发 CBDC 公用页和设置

使用常用应用程序页面配置面向客户的演示文稿、身份验证、服务连接以及账户和事务处理视图。

可供您使用的页面和导航选项取决于您分配的权限。

  1. 使用分配的用户帐户登录到应用程序。
  2. 使用导航面板可打开可供您的角色使用的页面。
  3. 选择我的账户可查看令牌和账户上下文、账户状态、余额、暂挂金额、每日限额和使用量、应用程序组、配置历史记录和状态历史记录。
  4. 要结束会话，请打开用户菜单，然后选择注销。

注销将清除应用程序会话。如果配置了身份提供者注销，则浏览器继续访问身份提供者的注销页。

管理员设置和定制

开始之前：以中央银行管理员身份登录。

  1. 打开配置文件菜单。
  2. 选择设置以打开设置页。
  3. 选择包含要更新的设置的区域：
    • 自定义：控制欢迎文本、颜色、图像、令牌和账户名称、组织名称和标识、事务处理标签、应用程序组标签和角色标签。
    • 应用程序配置：维护令牌、网络、验证、包装 API、智能合同、Wallet 和富历史记录服务设置。

注意：

自定义卡内的保存更改控件仅将值保存到设置页面草稿中。要发布草稿，请选择页面级别的应用更改。应用更改将保存完整的配置，并根据需要重新启动或重新部署应用程序。等待应用程序可用，然后重新登录，并验证受影响的页面。

对于本地开发，应用程序将应用程序拥有的配置存储在本地环境文件中。不要将客户端密钥、数据库身份证明、私钥、持有人令牌或客户 URL 放在文档、屏幕捕获或源控制中。

自定义登录页面

开始之前：以中央银行管理员身份登录，然后选择设置。

  1. 在自定义下，打开登录页面卡。
  2. 在 Welcome message（欢迎消息）或 Login Page Message（登录页消息）中输入登录消息。登录消息的长度最多为 300 个字符。
  3. 选择一个图像：
    • 选择内置映像以放大其预览。
    • 选择上载图像以选择不大于 80 KB 的 PNG、JPG、WEBP 或 SVG 文件。为了获得最佳结果，请使用横向图像。
    • 选择使用默认值可恢复内置映像。
  4. 选择保存更改以在设置草稿中保存卡的值。
  5. 选择关闭以返回到设置，然后选择页级别的应用更改。
  6. 应用程序重新启动后，打开登录页面并验证消息和映像。

更改应用程序背景颜色

开始之前：以中央银行管理员身份登录，然后选择设置。

  1. 在 Customizations（自定义）下，打开 Background Color（背景颜色）。
  2. 选择预设（默认、软蓝色、软茶、温沙或冷灰色），或打开定制颜色选择器以选择颜色。
  3. 查看卡中的即时预览。要恢复原始颜色，请选择使用默认值。
  4. 依次选择保存更改和关闭。
  5. 在 Setup（设置）页面上，选择 Apply Changes（应用更改）。
  6. 应用程序重新启动后，登录并验证应用程序页面上的背景颜色。

卡内预览不发布颜色。应用程序范围的更改仅在您选择应用更改后生效。

更改令牌和账户显示名称

开始之前：以中央银行管理员身份登录，然后选择设置。

  1. 在自定义下，选择令牌。
  2. 对于令牌显示名称，输入要在标题和与令牌相关的页面中显示的名称。
  3. 对于帐户显示名称，输入要在帐户部分和帐户详细信息中显示的名称。
  4. 选择保存更改以保存卡草稿，然后选择关闭。
  5. 在 Setup（设置）页面上，选择 Apply Changes（应用更改）。
  6. 应用程序重新启动后，登录并验证适用视图中的两个名称。

更改这些名称仅影响演示。它不会更改已部署的令牌或智能合同权限。

配置货币显示

开始之前：以中央银行管理员身份登录，然后选择设置。

  1. 在自定义下，选择货币。
  2. 查看 Token ID 字段以确认与显示设置关联的令牌。货币表示控件不会更改此标识符。
  3. 对于货币符号，从标准化 ISO 货币列表中选择一种货币。
  4. 对于数字格式，选择区域格式，确定千位分隔符和小数分隔符。选择数字格式还会加载其通常的符号位置。
  5. 查看 Decimal Places（小数位）字段。精度从所选标记加载，无法在此处更改。
  6. 对于货币符号位置，选择符号是出现在金额之前还是之后。
  7. 选中当前预览以验证货币符号、分隔符、小数位和符号位置。
  8. 选择 Save Changes（保存更改）和 Close（关闭），然后在 Setup（设置）页面上选择 Apply Changes（应用更改）。
  9. 应用程序重新启动后，登录并验证账户和事务处理视图中的货币值。

更新组织介绍和顺序

开始之前：以中央银行管理员身份登录，然后选择设置。组织必须已注册。

  1. 在自定义下，选择组织。
  2. 在组织选择器中，选择注册的组织。选择器将显示其名称和顺序。
  3. 查看已注册组织 ID 和序号字段。注册的 ID 为只读。序列 1 是为创建者保留的。
  4. 在显示名称中输入面向客户的新名称。根据需要更新序列。
  5. 如果更改了显示名称或顺序，请选择更新组织以将更改发送到组织注册表。
  6. 要自定义组织标识图像，请上载不大于 80 KB 的 PNG、JPG、WEBP 或 SVG 文件，或选择使用默认值。
  7. 选择保存更改以保存自定义草稿，然后选择关闭。
  8. 在 Setup（设置）页面上，选择 Apply Changes（应用更改）。
  9. 应用程序重新启动后，登录并验证组织卡、选择器、标题、帐户视图和显示组织顺序的列表中的组织名称、标识和顺序。

注册表维护组织的身份和顺序。更改显示名称不会替换其注册的组织 ID。使用更新组织控件进行的注册表更新不同于通过应用更改命令发布自定义草稿。

更改应用程序组标签

开始之前：以中央银行管理员身份登录，然后选择设置。

  1. 在自定义下，选择应用程序组。
  2. 在应用程序组选择器中，选择要自定义的组。
  3. 检查固定授权值。请勿更改基础授权映射。
  4. 对于显示标签，输入面向客户的组名称。
  5. 选择 Save Changes（保存更改）和 Close（关闭），然后在 Setup（设置）页面上选择 Apply Changes（应用更改）。
  6. 应用程序重新启动后，登录并验证标题、帐户行、选择器以及配置文件菜单中的标签。

更改标签不会影响用户权限、工作区访问权限、分类账角色或账户分配。

更改事务处理类型标签

开始之前：以中央银行管理员身份登录，然后选择设置。

  1. 在自定义下，选择事务处理标签。
  2. 在事务处理类型列表中，选择要自定义的事务处理映射。
  3. 查看 API 事务处理标签字段。此服务值是固定的。
  4. 对于 Display Label（显示标签），输入要向用户显示的标签。
  5. 选择 Save Changes（保存更改）和 Close（关闭），然后在 Setup（设置）页面上选择 Apply Changes（应用更改）。
  6. 应用程序重新启动后，登录并验证适用事务处理视图中的标签。

显示标签会更改，但 API 事务处理值不会更改。

更改令牌角色标签

开始之前：以中央银行管理员身份登录，然后选择设置。

  1. 在自定义下，选择角色。
  2. 在令牌角色列表中，选择要自定义的角色。
  3. 查看区块链使用的固定授权角色。请勿更改此值。
  4. 对于显示标签，输入面向客户的角色名称。
  5. 选择 Save Changes（保存更改）和 Close（关闭），然后在 Setup（设置）页面上选择 Apply Changes（应用更改）。
  6. 应用程序重新启动后，登录并验证帐户和配置文件视图中的标签。

更改标签不会授予、删除或以其他方式更改用户的区块链权限。

应用程序配置

应用程序配置维护应用程序使用的连接和运行时值。这些值通常由部署管理员提供。仅当相应的服务、合同、身份提供方或部署环境发生更改时才进行更改。

在编辑应用程序配置之前，记录这些值所属的部署。向部署管理员确认替换值，并屏蔽所有密钥。当密钥字段已包含屏蔽值时，如果应保留现有密钥，则将其留空。

配置应用程序设置

开始之前：以中央银行管理员身份登录，然后选择设置。确认部署的运行时值。

  1. 在应用程序配置下，找到应用程序设置。
  2. 对于 Token ID（令牌 ID），输入或验证 Besu 部署期间提供的令牌标识符。ID 选择用于余额、转移、发放、报废和账户视图的令牌。
  3. 查看 Network 字段。此发行版使用 Besu。分类账运行时由部署修复。
  4. 对于受保护环境，将连接安全性设置为 HTTPS。仅当有意为 HTTP 配置本地部署时才使用 HTTP。
  5. 将 Debug Mode 设置为 Off 以供正常使用。临时启用它，仅诊断受控测试或支持问题。调试将验证和后端请求详细信息添加到服务器日志。
  6. 查看设置，然后选择应用更改。
  7. 等待应用程序重新启动，重新登录，并验证适用的令牌和账户操作。

配置验证设置

身份提供者在部署或 Oracle Blockchain Platform 安装过程中进行配置。在设置页上选择登录方法不会创建帐户或更改提供者的多因素验证 (multi-factor authentication，MFA) 策略。

  1. 以中央银行管理员身份登录并打开设置。
  2. 在应用程序配置下，找到 Authentication 。
  3. 对于登录方法，选择为部署配置的方法：LDAP 或 OpenID Connect (OIDC)。
  4. 如果选择 OpenID Connect，请在应用配置之前完成以下部分中的 OIDC 设置。
  5. 完成适用的字段后，选择应用更改，等待重新启动，并测试新的登录。

配置 OpenID Connect 设置

开始之前：获取应用程序部署的 OIDC 发布者元数据和客户机注册值。仅当选择 OpenID Connect 作为登录方法时，才会显示以下字段。

  1. 对于 Issuer URL ，输入身份提供者提供的可信发布者。根据提供方的 OIDC 搜索元数据进行验证。批发 CBDC 应用程序使用此授权来搜索授权、令牌、注销和签名密钥端点，并验证令牌发布者。请勿使用从其他环境复制的应用程序 URL、令牌端点 URL 或发布者。
  2. 对于客户端 ID ，输入为此部署的 URL 创建的批发 CBDC 应用程序的客户端 ID 或应用程序 ID。
  3. 当客户机注册需要时，在屏蔽的 Client Secret 字段中输入身份证明。如果现有密钥应保持不变，请将其编辑字段留空。
  4. 对于 Redirect URI ，输入在身份提供者注册的确切回调地址。对于默认本地端口，请使用 http://localhost:3000/api/auth/oidc/callback。方案、主机、端口和路径必须全部匹配。使用其他本地端口时注册相应的 URI。
  5. 对于 Post-Logout Redirect URI ，在提供程序注销后输入注册的浏览器目标。对于默认本地设置，请使用 http://localhost:3000/ 或其他显式注册的本地注销后页面。将此 URI 与登录回调分开注册。
  6. 对于范围，输入以空格分隔的范围。正常基线为 openid profile email。仅当部署需要时才添加特定于提供方的范围。
  7. 对于用户 ID 索赔，输入其值与包装 API 和分类账账户数据使用的用户 ID 完全匹配的索赔。常规本地默认值为 preferred_username；仅当身份提供者和应用程序数据一致地使用时，才使用其他声明。
  8. 复查所有值，然后在设置页上选择应用更改。
  9. 等待应用程序重新启动，然后注销并重新登录。确认回调成功，正确加载 wallet，以及所需的账户和角色权限可用。

OpenID Connect 术语

OpenID Connect
一种登录协议，其中身份提供者在批发 CBDC 应用程序创建应用程序会话之前验证返回的身份时验证用户。
身份提供者
用于维护用户帐户、密码、登录页面和 MFA 策略的服务。批发 CBDC 应用程序不接收用户的密码。
授权代码
用户登录后发送到已注册回调的短暂值。批发 CBDC 应用程序后端将其交换为令牌。
PKCE
代码交换的证明密钥浏览器重定向流中的保护，有助于防止被拦截的授权代码被其他客户机使用。
访问令牌
后端用于获取或授权对配置的下游服务的访问权限的短生命周期身份证明。请勿将其复制到文档或支持消息中。
声明
验证的标记中包含的身份属性，例如用户 ID、电子邮件或组。用户 ID 声明设置标识映射到批发 CBDC 应用程序用户的属性。
MFA
当身份提供者的策略需要额外验证时，由其执行的多因素验证。更改批发 CBDC 应用程序的设置字段不会在提供程序中启用 MFA。

本地 OIDC 登录流

  1. 用户打开本地批发 CBDC 应用程序并启动登录过程。
  2. 批发 CBDC 应用程序使用发布者、客户机 ID 和请求的范围将浏览器重定向到配置的身份提供者。
  3. 身份提供者对用户进行验证，并在其策略需要时执行 MFA。
  4. 提供程序使用授权代码将浏览器重定向到完全注册的重定向 URI 。
  5. 批发 CBDC 应用程序后端交换令牌的代码、验证验证响应、读取配置的用户 ID 声明并创建应用程序会话。
  6. 应用程序将加载用户的合格 wallet、组织、账户和角色上下文。
  7. 用户注销时，批发 CBDC 应用程序会在受支持时调用提供程序注销，并将浏览器发送到注册的 Post-Logout Redirect URI 。

验证本地设置的身份提供者注册

开始之前：获取对身份提供者应用程序注册和批发 CBDC 应用程序设置页值的访问权限。

  1. 验证配置的 issuer 是否与提供方的 OIDC 发布者和搜索元数据匹配。
  2. 验证本地批发 CBDC 应用程序后端是否支持注册的 client type 和客户机验证方法。
  3. 验证 redirect URI 是否与默认本地端口的 http://localhost:3000/api/auth/oidc/callback 完全匹配，或者是否与另一个端口的正确注册 URI 完全匹配。
  4. 验证 post-logout redirect URI 是否已单独注册并与配置的地址（例如 http://localhost:3000/）匹配。
  5. 验证提供程序是否返回配置的 scopes 和选定的 User ID Claim 。
  6. 验证身份提供者中是否存在该用户，该用户属于预期组，并且可以完成配置的 MFA 策略。
  7. 在批发 CBDC 应用程序的设置页上应用匹配值，等待应用程序重新启动，然后重新登录以验证回调、Wallet、帐户和角色上下文。

配置 Wrapper API

包装器将 Web 应用连接到 Oracle Blockchain Platform 服务和部署的账本集成。

开始之前：以中央银行管理员身份登录，选择设置，然后获取目标部署的端点和身份证明。

  1. 在应用程序配置下，找到包装 API 配置。
  2. 对于服务端点，输入部署提供的服务端点。
  3. 对于包装 API URL ，输入用于账户、标记、组织、Wallet 和事务处理操作的可访问的包装基本 URL。
  4. 对于访问令牌 URL ，输入配置的服务验证提供的令牌端点。
  5. 对于 OBP 实例客户端 ID ，输入为此 Oracle Blockchain Platform 实例创建的客户端标识符。
  6. 必要时，在屏蔽的 OBP 实例客户端密钥字段中输入新凭证。将其留空以保留现有密钥。请勿在文档、屏幕捕获、源控制或支持消息中公开密钥。
  7. 验证端点、标识符和身份证明是否属于同一部署，然后选择应用更改。
  8. 应用程序重新启动后，登录并验证 wallet 加载、账户加载、读取操作和允许的事务处理。

配置智能合同地址

开始之前：请向部署管理员确认部署的 Besu 合同地址。

  1. 以中央银行管理员身份登录并打开设置。
  2. 在应用程序配置下，找到智能合同配置。
  3. 对于账户合同地址，输入提供账户注册、状态、限制、角色以及其他与账户相关的分类账操作的已部署合同。
  4. 对于令牌合同地址，输入用于令牌余额、发放、转移、暂挂、报废和相关令牌操作的已部署合同。
  5. 确认两个地址都属于与应用程序相同的 Besu 部署，然后选择应用更改。
  6. 应用程序重新启动后，登录并验证预期的账户信息、余额、角色和事务处理结果。

请勿使用从其他环境复制的合同地址。不匹配的合同可能会使应用程序在返回错误的账户、余额、角色或事务处理数据时看起来已连接。

配置 Wallet 服务设置

开始之前：获取目标部署的 wallet 服务详细信息。

  1. 以中央银行管理员身份登录并打开设置。
  2. 在应用程序配置下，找到 Wallet 配置。
  3. 对于 Wallet API URL ，输入用于加载可供已验证用户使用的钱包的服务 URL。
  4. 对于组织 ID ，输入 wallet 服务用于将 wallet 加载和账户创建范围到组织的标识符。
  5. 对于 Wallet 服务实例 ID ，输入拥有所选组织和用户上下文的服务实例。
  6. 确认所有值都与部署匹配，然后选择应用更改。
  7. 应用程序重新启动后，再次登录并验证预期组织的钱包是否已加载。如果用户没有符合条件的 Wallet 或 CBDC 账户，则应用程序可以停止适用角色的登录过程。

配置丰富历史记录数据库

丰富的历史记录使用配置的 ORDS 服务来支持 Besu 帐户和历史记录读取。

开始之前：获取目标部署的 ORDS OAuth 配置。

  1. 以中央银行管理员身份登录并打开设置。
  2. 在应用程序配置下，找到丰富的历史记录数据库配置。
  3. 对于 ORDS OAuth Token URL ，输入后端获取其服务令牌的 ORDS 端点。
  4. 对于 ORDS Client ID ，输入用于服务令牌请求的客户机标识符。
  5. 如果凭证必须更改，请在屏蔽的 ORDS Client Secret 字段中输入该凭证。将字段留空以保留存储的密钥。
  6. 查看设置，然后选择应用更改。
  7. 应用程序重新启动后，重新登录并验证账户已读和事务处理历史记录已读。

后端获取 ORDS 服务令牌并将其发送到包装器以进行 Besu 帐户和历史记录读取。请勿向浏览器公开 ORDS 持有人令牌，或将其复制到客户文档中。

应用并验证配置更改

开始之前：以中央银行管理员身份登录。

  1. 更改设置页上的设置。
  2. 查看 URL、标识符、智能合同地址和屏蔽的密钥字段。确认所有值都属于同一部署，并且尚未无意中替换或清除现有身份证明。
  3. 修改自定义卡后，选择其保存更改以保存卡草稿。
  4. 选择页级别的应用更改控件。将保存完整的配置，并开始所需的应用程序重新启动或部署。
  5. 当应用程序再次可用时，请登录。
  6. 验证身份验证、钱包加载、账户加载、余额、历史记录读取以及受影响的角色操作。

显示名称和标签更改仅影响表示形式。对合同地址、组织 ID、Wallet 服务实例、验证设置、包装值或 ORDS 身份证明所做的更改会影响所有角色，并且必须遵循部署更改控制过程。

我的客户

我的帐户页显示登录时选择的 wallet 和帐户的信息。

  1. 使用授权账户登录。
  2. 在导航面板上，选择我的帐户。
  3. 检查账户 ID 或地址、用户、组织、令牌详细信息、账户状态、余额和暂挂金额。
  4. 查看您的角色允许的每日事务处理使用量和限制、应用程序组、配置历史记录和状态历史记录。

复核事务处理和审计记录

使用事务处理页可以搜索历史记录并检查可用于登录上下文的详细信息。审计人员还可以使用其授权的审计工作区。

  1. 从导航面板登录并打开事务处理。
  2. 使用适用的筛选器搜索可用历史记录，例如事务处理标识符、事务处理类型、组织或用户、账户或对手方文本、目的或通知单、金额、余额或日期。筛选可用性取决于数据。
  3. 复核匹配事务处理并打开条目以检查其详细信息。
  4. 打开审计员工作区的已验证 /audit 页面。
  5. 根据所需的审计数据以及分配给您的审计者角色，选择系统审计或组织审计。