Wholesale CBDC 通用頁面與設定值

使用通用應用程式頁面來設定面向客戶的簡報、驗證、服務連線，以及帳戶和交易檢視。

您可以使用的頁面和導覽選項，視您指派的權限而定。

1. 使用您指派的使用者帳戶登入應用程式。
2. 您可以使用導覽面板來開啟可供您的角色使用的頁面。
3. 選取我的帳戶即可複查權杖和帳戶相關資訊環境、帳戶狀態、餘額、保留金額、每日限額和使用狀況、應用程式群組、組態歷史記錄以及狀態歷史記錄。
4. 若要結束階段作業，請開啟使用者功能表，然後選取登出。

登出會清除應用程式階段作業。如果已設定身分識別提供者登出，瀏覽器會繼續前往身分識別提供者的登出頁面。

管理員設定和自訂

開始之前：以中央銀行管理員身分登入。

1. 開啟設定檔功能表。
2. 選取設定值以開啟設定頁面。
3. 選取包含要更新設定值的區域：
   • 自訂：控制歡迎文字、顏色、影像、變數替代字與帳戶名稱、組織名稱與標誌、交易標籤、應用程式群組標籤及角色標籤。
   • 應用程式組態：維護權杖、網路、認證、包裝函式 API、智能合約、公事包以及豐富的歷史記錄服務設定值。

備註：

自訂卡內的儲存變更控制項只會儲存值至設定頁面草稿。若要發布草稿，請選取頁面層級的套用變更。套用變更會儲存完整的組態，並視需要重新啟動或重新建置應用程式。請等待應用程式變成可用狀態、重新登入，然後驗證受影響的頁面。

對於本機開發，應用程式會將應用程式擁有的組態儲存在本機環境檔案中。請勿將從屬端加密密碼、資料庫證明資料、私密金鑰、持有者記號或客戶 URL 放在文件、畫面擷取或來源控制中。

自訂登入頁面

開始之前：以中央銀行管理員身分登入，然後選取設定值。

1. 在自訂下，開啟登入頁面卡。
2. 在歡迎訊息或登入頁面訊息中輸入登入訊息。登入訊息的長度上限為 300 個字元。
3. 選擇一個影像：
   • 選擇內建的影像來放大預覽 。
   • 選取上傳影像以選擇不超過 80 KB 的 PNG、JPG、WEBP 或 SVG 檔案。若要取得最佳結果，請使用橫向影像。
   • 選取使用預設值可回復內建影像。
4. 選取儲存變更以將卡片的值儲存在設定草稿中。
5. 選取關閉以返回設定，然後選取頁面層級的套用變更。
6. 應用程式重新啟動後，請開啟登入頁面並驗證訊息和影像。

變更應用程式背景顏色

開始之前：以中央銀行管理員身分登入，然後選取設定值。

1. 在自訂下，開啟背景顏色。
2. 選擇預設 ( 預設、軟藍、軟藍、暖沙或冷灰色 )，或開啟自訂顏色選取器以選擇顏色。
3. 檢閱卡片中的立即預覽。若要還原原始顏色，請選取使用預設值。
4. 選取儲存變更，然後關閉。
5. 在設定頁面上，選取套用變更。
6. 應用程式重新啟動後，請登入並驗證應用程式頁面上的背景顏色。

卡內預覽不會發布顏色。整個應用程式的變更只有在您選取套用變更後才會生效。

變更變數替代字與帳戶顯示名稱

開始之前：以中央銀行管理員身分登入，然後選取設定值。

1. 在自訂下，選取記號。
2. 在記號顯示名稱中，輸入要在標頭和記號相關頁面中顯示的名稱。
3. 在帳戶顯示名稱中，輸入帳戶區段和帳戶詳細資料中要顯示的名稱。
4. 選取儲存變更以儲存卡片草稿，然後選取關閉。
5. 在設定頁面上，選取套用變更。
6. 應用程式重新啟動後，請登入並驗證適用檢視中的兩個名稱。

變更這些名稱只會影響簡報。它不會變更已部署的權杖或智慧合約權限。

設定幣別顯示

開始之前：以中央銀行管理員身分登入，然後選取設定值。

1. 在自訂下，選取幣別。
2. 複查記號 ID 欄位，確認與顯示設定值關聯的記號。幣別呈現控制項不會變更此識別碼。
3. 對於幣別符號，請從標準化的 ISO 幣別清單中選取幣別。
4. 針對數字格式，選擇區域格式，以決定千位數與小數分隔符號。選取數字格式也會載入其常用的符號位置。
5. 複查小數位數欄位。精確度是從選取的記號載入，因此無法在此處變更。
6. 在貨幣符號位置中，選擇該符號要出現在金額之前或之後。
7. 勾選目前預覽以驗證幣別符號、分隔符號、小數位數及符號位置。
8. 選取儲存變更與關閉，然後在設定頁面上選取套用變更。
9. 應用程式重新啟動後，請登入並驗證帳戶與交易檢視中的貨幣值。

更新組織呈現與序號

開始之前：以中央銀行管理員身分登入，然後選取設定值。組織必須已註冊。

1. 在自訂下，選取組織。
2. 在組織選取器中，選擇已註冊的組織。選取器會顯示其名稱和順序。
3. 複查已登錄的組織 ID 與順序欄位。註冊的 ID 是唯讀的。順序 1 已保留給創始人使用。
4. 在顯示名稱中輸入新的面向客戶名稱。視需要更新順序。
5. 如果顯示名稱或順序已變更，請選取更新組織以傳送變更至組織登錄。
6. 若要自訂組織標誌影像，請上傳不超過 80 KB 的 PNG、JPG、WEBP 或 SVG 檔案，或選取使用預設值。
7. 選取儲存變更以儲存自訂草稿，然後選取關閉。
8. 在設定頁面上，選取套用變更。
9. 應用程式重新啟動後，請登入並驗證組織卡、選取器、表頭、客戶檢視及顯示組織訂單清單中的組織名稱、標誌及順序。

登錄會維護組織的識別與順序。變更顯示名稱並不會取代其註冊的組織 ID。使用更新組織控制項所做的登錄更新，與透過套用變更命令發布自訂草稿不同。

變更應用程式群組標籤

開始之前：以中央銀行管理員身分登入，然後選取設定值。

1. 在自訂下，選取應用程式群組。
2. 在應用程式群組選取器中，選擇要自訂的群組。
3. 複查固定授權值。請勿變更基礎授權對應。
4. 在顯示標籤中，輸入面向客戶的群組名稱。
5. 選取儲存變更與關閉，然後在設定頁面上選取套用變更。
6. 應用程式重新啟動後，請登入並驗證標頭、帳戶列、選取器和設定檔功能表中的標籤。

變更標籤不會影響使用者權限、工作區存取權、分類帳角色或帳戶指派。

變更交易型態標籤

開始之前：以中央銀行管理員身分登入，然後選取設定值。

1. 在自訂下，選取交易標籤。
2. 在交易類型清單中，選取要自訂的交易對應。
3. 請複查 API 交易標籤欄位。此服務值為固定。
4. 在顯示標籤中，輸入要對使用者顯示的標籤。
5. 選取儲存變更與關閉，然後在設定頁面上選取套用變更。
6. 應用程式重新啟動後，請登入並在適用的交易檢視中驗證標籤。

顯示標籤會變更，但 API 交易值則不會變更。

變更權杖角色標籤

開始之前：以中央銀行管理員身分登入，然後選取設定值。

1. 在自訂下，選取角色。
2. 在記號角色清單中，選擇要自訂的角色。
3. 複查區塊鏈所使用的固定授權角色。請勿變更此值。
4. 在顯示標籤中，輸入面向客戶的角色名稱。
5. 選取儲存變更與關閉，然後在設定頁面上選取套用變更。
6. 應用程式重新啟動後，請登入並驗證帳戶與資料檔檢視中的標籤。

變更標籤並不會授予、移除或變更使用者的區塊鏈權限。

應用程式組態

應用程式組態會維護應用程式使用的連線和執行時期值。這些值通常由部署管理員提供。僅在對應的服務、合約、身分識別提供者或部署環境變更時才變更。

編輯應用程式組態之前，請先記錄值所屬的部署。與部署管理員確認取代值，並讓所有加密密碼保持遮罩。如果加密密碼欄位已經包含遮罩值，請將它留白。

設定應用程式設定值

開始之前：以中央銀行管理員身分登入，然後選取設定值。確認部署的執行時期值。

1. 在應用程式組態下，尋找應用程式設定值。
2. 對於權杖 ID ，請輸入或驗證 Besu 部署期間提供的權杖 ID。ID 會選取用於餘額、轉帳、核發、處分及科目檢視的變數替代字。
3. 檢閱網路欄位。這個版本使用 Besu。分類帳執行時期已由部署修正。
4. 將安全環境的連線安全設為 HTTPS。只有在為 HTTP 刻意設定本機部署時，才使用 HTTP。
5. 將除錯模式設為關閉以供一般使用。請暫時啟用以診斷受控制的測試或支援問題。除錯會將驗證和後端要求詳細資訊新增至伺服器日誌。
6. 複查設定值並選取套用變更。
7. 等待應用程式重新啟動，請重新登入，然後驗證適用的權杖和帳戶作業。

設定認證設定值

身分識別提供者是在部署或 Oracle Blockchain Platform 安裝時設定。在設定頁面上選取登入方法並不會建立帳戶或變更提供者的多重因素認證 (MFA) 原則。

1. 以中央銀行管理員身分登入，然後開啟設定值。
2. 在應用程式組態底下，尋找認證。
3. 針對登入方法，選取為部署設定的方法：LDAP 或 OpenID Connect (OIDC)。
4. 如果您選取 OpenID Connect，請先完成下列小節中的 OIDC 設定值，再套用組態。
5. 完成適用的欄位之後，請選取套用變更、等待重新啟動，然後測試全新的登入。

設定 OpenID Connect 設定

開始之前：取得應用程式部署的 OIDC 發出者描述資料和從屬端註冊值。只有在選取 OpenID Connect 作為登入方法時，才會顯示下列欄位。

1. 針對發照者 URL ，輸入身分識別提供者所提供的信任發照者。根據提供者的 OIDC 尋找描述資料進行驗證。Wholesale CBDC 應用程式會使用此授權來尋找授權、權杖、登出及簽署金鑰端點，以及驗證權杖發照者。請勿使用從其他環境複製的應用程式 URL、記號端點 URL 或發照者。
2. 對於用戶端 ID ，請輸入為此部署 URL 建立之批發 CBDC 應用程式的用戶端或應用程式 ID。
3. 當從屬端註冊要求時，請在遮罩的從屬端加密密碼欄位中輸入證明資料。如果現有的加密密碼維持不變，請將其編輯欄位留白。
4. 若為重新導向 URI ，請輸入在身分識別提供者註冊的完全回呼位址。對於預設本機連接埠，請使用 http://localhost:3000/api/auth/oidc/callback。配置、主機、連接埠和路徑必須全部相符。使用其他本機連接埠時註冊對應的 URI。
5. 若為登出後重新導向 URI ，請在提供者登出後輸入已註冊的瀏覽器目的地。若為預設本機設定，請使用 http://localhost:3000/ 或其他明確註冊的本機登出後頁面。請分別註冊此 URI 與登入回呼。
6. 在範圍中，輸入以空格區隔的範圍。一般基準線為 openid profile email。只有在部署需要時才新增提供者特定範圍。
7. 針對使用者 ID 宣告，輸入其值完全符合包裝程式 API 與分類帳科目資料所使用之使用者 ID 的宣告。一般本機預設值為 preferred_username；只有在身分識別提供者和應用程式資料一致使用時，才使用其他宣告。
8. 複查所有值，然後在設定頁面上選取套用變更。
9. 請等待應用程式重新啟動，然後登出並重新登入。確認回呼成功、正確的公事包載入，以及預期的帳戶和角色權限都可供使用。

OpenID Connect 術語

OpenID Connect

身分識別提供者在批發 CBDC 應用程式建立應用程式階段作業之前驗證傳回的身分識別時，用來認證使用者的登入協定。

身分識別提供者

維護使用者帳戶、密碼、登入頁面及 MFA 原則的服務。Wholesale CBDC 應用程式不會收到使用者的密碼。

授權代碼

使用者登入後，傳送給已註冊回電的簡短存留值。批發 CBDC 應用程式後端會交換記號。

PKCE

程式碼交換的證明金鑰。瀏覽器重導流程中的保護，可協助防止其他從屬端使用攔截的授權碼。

存取權杖

後端用於取得或授權存取已設定下游服務的短期證明資料。請勿將其複製到文件或支援訊息中。

宣告

驗證記號中包含的識別屬性，例如使用者 ID、電子郵件或群組。使用者 ID 宣告設定會識別對應至批發 CBDC 應用程式使用者的屬性。

MFA

身分識別提供者原則需要額外驗證時所執行的多重因素認證。變更批發 CBDC 應用程式設定欄位不會對提供者啟用 MFA。

本機 OIDC 登入流程

1. 使用者開啟本端批發 CBDC 應用程式，並開始登入程序。
2. Wholesale CBDC 應用程式會使用發照者、用戶端 ID 及要求的範圍，將瀏覽器重新導向至已設定的身分識別提供者。
3. 身分識別提供者會認證使用者，並在其原則需要時執行 MFA。
4. 提供者會將瀏覽器重新導向至完全註冊的重新導向 URI (含授權代碼)。
5. Wholesale CBDC 應用程式後端會交換記號的代碼、驗證認證回應、讀取已設定的使用者 ID 宣告，以及建立應用程式階段作業。
6. 應用程式會載入使用者的適用公事包、組織、帳戶以及角色相關資訊環境。
7. 當使用者登出時，批發 CBDC 應用程式會在支援時呼叫提供者登出，並將瀏覽器傳送至已註冊的登出後重新導向 URI 。

驗證本機設定的身分識別提供者註冊

開始之前：取得身分識別提供者應用程式註冊與批發 CBDC 應用程式設定頁面值的存取權。

1. 確定設定的發照者符合提供者的 OIDC 發照者和尋找描述資料。
2. 確認本機批發 CBDC 應用程式後端支援已註冊的用戶端類型和用戶端驗證方法。
3. 請確認 redirect URI 與預設本機連接埠的 http://localhost:3000/api/auth/oidc/callback 完全相符，或另一個連接埠的正確註冊 URI。
4. 確認 post-logout 重新導向 URI 是個別註冊的，且符合設定的位址，例如 http://localhost:3000/。
5. 確定提供者傳回設定的範圍和選取的使用者 ID 宣告。
6. 確定身分識別提供者中存在的使用者屬於預期的群組，而且可以完成設定的 MFA 原則。
7. 在批發 CBDC 應用程式設定頁面上套用比對值，等待應用程式重新啟動，然後再次登入以驗證回呼、公事包、帳戶及角色內容。

設定包裝程式 API

包裝程式會將 Web 應用程式連線至 Oracle Blockchain Platform 服務和部署的分類帳整合。

開始之前：以中央銀行管理員身分登入，選取設定值，然後取得目標部署的端點和證明資料。

1. 在應用程式組態底下，尋找包裝程式 API 組態。
2. 針對服務端點，輸入部署所提供的服務端點。
3. 在包裝函式 API URL 中，輸入用於帳戶、權杖、組織、公事包及交易作業的可存取包裝函式基礎 URL。
4. 在存取記號 URL 中，輸入已設定服務驗證所提供的記號端點。
5. 在 OBP 執行處理從屬端 ID 中，輸入為此 Oracle Blockchain Platform 執行處理建立的從屬端 ID。
6. 必要時，請在遮罩的 OBP 執行處理從屬端加密密碼欄位中輸入新的證明資料。將它留白即可保留現有的加密密碼。請勿在文件、畫面擷取、來源控制或支援訊息中顯示加密密碼。
7. 確認端點、ID 和證明資料屬於相同的部署，然後選取套用變更。
8. 應用程式重新啟動之後，請登入並驗證公事包載入、帳戶載入、讀取作業以及允許的交易。

設定智慧型合約地址

開始之前：使用部署管理員確認部署的 Besu 合約地址。

1. 以中央銀行管理員身分登入，然後開啟設定值。
2. 在應用程式組態下，尋找智慧型合約組態。
3. 對於帳戶合約地址，輸入提供帳戶登錄、狀態、限制、角色和其他帳戶相關分類帳作業的已部署合約。
4. 針對權杖合約地址，輸入用於權杖餘額、核發、移轉、保留、處分及相關權杖作業的已部署合約。
5. 確認兩個位址都屬於與應用程式相同的 Besu 部署，然後選取套用變更。
6. 應用程式重新啟動後，請登入並確認預期的帳戶資訊、餘額、角色及交易結果。

請勿使用從其他環境複製的合約地址。當傳回不正確的科目、餘額、角色或交易資料時，不相符的合約可能會讓應用程式似乎連線。

設定公事包服務設定值

開始之前：取得目標部署的公事包服務詳細資訊。

1. 以中央銀行管理員身分登入，然後開啟設定值。
2. 在應用程式組態底下，尋找公事包組態。
3. 在公事包 API URL 中，輸入用來載入已認證使用者可用的公事包的服務 URL。
4. 在組織 ID 中，輸入公事包服務用來將公事包載入範圍和建立帳戶範圍設定為組織的 ID。
5. 在公事包服務執行處理 ID 中，輸入擁有所選組織和使用者相關資訊環境的服務執行處理。
6. 確認所有值都符合部署，然後選取套用變更。
7. 應用程式重新啟動後，請再次登入並確認預期組織的公事包是否已載入。如果使用者沒有適用的錢包或 CBDC 帳戶，則應用程式可以停止適用角色的登入程序。

設定豐富歷史記錄資料庫

豐富歷史記錄使用已設定的 ORDS 服務來支援 Besu 帳戶與歷史記錄讀取。

開始之前：取得目標建置的 ORDS OAuth 組態。

1. 以中央銀行管理員身分登入，然後開啟設定值。
2. 在應用程式組態下，尋找 Rich History Database 組態。
3. 若為 ORDS OAuth 記號 URL ，請輸入後端取得其服務記號的 ORDS 端點。
4. 在 ORDS 從屬端 ID 中，輸入用於服務記號要求的從屬端 ID。
5. 如果證明資料必須變更，請將它輸入遮罩的 ORDS 從屬端密碼欄位中。將欄位留白以保留儲存的加密密碼。
6. 複查設定值並選取套用變更。
7. 應用程式重新啟動後，請再次登入並確認已讀取帳戶和交易歷史記錄。

後端會取得 ORDS 服務記號，並將其傳送至 Besu 帳戶和歷史記錄讀取的包裝程式。請勿將 ORDS Bearer 權杖公開給瀏覽器，或將其複製到客戶文件中。

套用並驗證組態變更

開始之前：以中央銀行管理員身分登入。

1. 變更設定頁面上的設定。
2. 複查 URL、識別碼、智能合約地址及遮罩密碼欄位。確認所有值都屬於相同的部署，且現有證明資料未被意外取代或清除。
3. 修改自訂卡時，選取其儲存變更以儲存卡片草稿。
4. 選取頁面層次的套用變更控制項。系統會儲存完整的組態，並開始重新啟動或推出所需的應用程式。
5. 當應用程式可再次使用時，請登入。
6. 驗證認證、公事包載入、帳戶載入、餘額、已讀取歷史記錄以及受影響的角色動作。

顯示名稱和標籤變更只會影響簡報。變更合約位址、組織 ID、公事包服務執行處理、認證設定值、包裝函式值或 ORDS 證明資料會影響所有角色，而且必須遵循建置變更控制程序。

我的帳戶

我的帳戶頁面會顯示登入時所選取之公事包和帳戶的資訊。

1. 使用授權的帳戶登入。
2. 在導覽面板上，選取我的帳戶。
3. 複查帳戶 ID 或地址、使用者、組織、變數替代字明細、帳戶狀態、餘額及保留金額。
4. 複查您的角色所允許的每日交易使用量與限額、應用程式群組、組態歷史記錄及狀態歷史記錄。

複查交易與稽核記錄

使用交易頁面可搜尋歷史記錄，並檢查已登入相關資訊環境可用的詳細資訊。稽核者也可以使用其授權的稽核工作區。

1. 從導覽面板登入並開啟交易。
2. 使用適用的篩選條件搜尋可用的歷史記錄，例如交易識別碼、交易類型、組織或使用者、帳戶或交易對方文字、目的或備忘錄、金額、餘額或日期。篩選可用性取決於資料。
3. 複查配對交易並開啟項目以檢查其明細。
4. 開啟稽核者工作區的已認證 /audit 頁面。
5. 選取系統稽核或組織稽核，視您需要的稽核資料以及指派給您的稽核者角色而定。