ホールセールCBDC共通ページおよび設定

使用可能なページおよびナビゲーション・オプションは、割り当てられた権限によって異なります。

割り当てられたユーザー・アカウントを使用してアプリケーションにサイン・アウトします。
ナビゲーション・パネルを使用して、自分のロールで使用可能なページを開きます。
トークンとアカウントのコンテキスト、アカウント・ステータス、残高、保留金額、日次限度および使用状況、アプリケーション・グループ、構成履歴およびステータス履歴を確認するには、「My Account」を選択します。
セッションを終了するには、ユーザー・メニューを開き、「サインアウト」を選択します。

サインアウトすると、アプリケーションセッションがクリアされます。アイデンティティ・プロバイダのログアウトが構成されている場合、ブラウザはアイデンティティ・プロバイダのログアウト・ページに進みます。

管理者設定とカスタマイズ

開始する前に、中央銀行管理者としてサインインします。

プロファイル・メニューを開きます。
「設定」を選択して、「設定」ページを開きます。
更新する設定を含む領域を選択します。
- カスタマイズ:ようこそテキスト、色、イメージ、トークンおよびアカウント名、組織名とロゴ、トランザクション・ラベル、アプリケーション・グループ・ラベルおよびロール・ラベルを制御します。
- アプリケーション構成:トークン、ネットワーク、認証、ラッパーAPI、スマート・コントラクト、ウォレットおよび豊富な履歴サービス設定を保持します。

ノート:

カスタマイズ・カード内の「変更の保存」コントロールは、値を「設定」ページの下書きにのみ保存します。ドラフトを公開するには、ページ・レベルの「変更の適用」を選択します。変更を適用すると、完全な構成が保存され、必要に応じてアプリケーションが再起動または再デプロイされます。アプリケーションが使用可能になるまで待機し、再度サインインして、影響を受けるページを確認します。

ローカル開発の場合、アプリケーションはアプリケーション所有の構成をローカル環境ファイルに格納します。クライアント・シークレット、データベース資格証明、秘密キー、ベアラー・トークンまたはカスタマURLをドキュメント、スクリーン・キャプチャまたはソース・コントロールに配置しないでください。

ログイン・ページのパーソナライズ

開始する前に、中央銀行管理者としてサインインし、「設定」を選択します。

「カスタマイズ」で、「ログイン・ページ」カードを開きます。
「ようこそメッセージ」または「ログイン・ページ・メッセージ」にサインイン・メッセージを入力します。サインインメッセージの長さは最大300文字です。
イメージを選択してください:
- プレビューを拡大するには、組込みイメージを選択します。
- 80KB以下のPNG、JPG、WEBPまたはSVGファイルを選択するには、「イメージのアップロード」を選択します。最良の結果を得るには、横の画像を使用します。
- 組込みイメージをリストアするには、「デフォルトの使用」を選択します。
「変更の保存」を選択して、カードの値を「設定」ドラフトに保存します。
「閉じる」を選択して「設定」に戻り、ページ・レベルの「変更の適用」を選択します。
アプリケーションが再起動したら、サインイン・ページを開き、メッセージとイメージを確認します。

アプリケーションの背景色の変更

開始する前に、中央銀行管理者としてサインインし、「設定」を選択します。

「カスタマイズ」で、「背景色」を開きます。
プリセット(「デフォルト」、「ソフト・ブルー」、「ソフト・ティール」、「ウォーム・サンド」または「クール・グレー」)を選択するか、カスタム・カラー・ピッカーを開いて色を選択します。
カード内の即時プレビューを確認します。元の色を復元するには、「デフォルトを使用」を選択します。
「変更の保存」、「閉じる」の順に選択します。
「設定」ページで、「変更の適用」を選択します。
アプリケーションが再起動したら、サインインしてアプリケーション・ページの背景色を確認します。

カード内プレビューでは、カラーはパブリッシュされません。アプリケーション全体の変更は、「変更の適用」を選択した後にのみ有効になります。

トークンおよびアカウントの表示名の変更

開始する前に、中央銀行管理者としてサインインし、「設定」を選択します。

「カスタマイズ」で、「トークン」を選択します。
「トークン表示名」に、ヘッダーおよびトークン関連ページに表示する名前を入力します。
「アカウント表示名」に、アカウント・セクションおよびアカウント詳細に表示する名前を入力します。
「変更の保存」を選択してカード・ドラフトを保存し、「閉じる」を選択します。
「設定」ページで、「変更の適用」を選択します。
アプリケーションが再起動したら、サインインして、該当するビューで両方の名前を確認します。

これらの名前の変更は、プレゼンテーションにのみ影響します。デプロイされたトークンまたはスマート・コントラクトの権限は変更されません。

通貨表示の構成

開始する前に、中央銀行管理者としてサインインし、「設定」を選択します。

「カスタマイズ」で、「通貨」を選択します。
「トークンID」フィールドを確認して、表示設定に関連付けられたトークンを確認します。通貨表示コントロールでは、この識別子は変更されません。
「通貨記号」で、標準化されたISO通貨リストから通貨を選択します。
「数値書式」で、3桁区切りと小数点区切りを指定する地域書式を選択します。数値書式を選択すると、通常の記号の位置もロードされます。
「小数点以下の桁数」フィールドを確認します。選択したトークンから精度がロードされ、ここでは変更できません。
「通貨記号の位置」で、金額の前後に記号を表示するかどうかを選択します。
通貨記号、セパレータ、小数点、記号の位置を確認するには、「現在のプレビュー」を選択します。
「変更の保存」および「閉じる」を選択し、「設定」ページで「変更の適用」を選択します。
アプリケーションが再起動したら、サインインして、勘定科目ビューおよびトランザクション・ビューで金額値を確認します。

組織プレゼンテーションおよび順序の更新

開始する前に、中央銀行管理者としてサインインし、「設定」を選択します。組織はすでに登録されている必要があります。

「カスタマイズ」で、「組織」を選択します。
組織セレクタで、登録済組織を選択します。セレクタには、その名前と順序が表示されます。
「Registered Organization ID」および「Sequence」フィールドを確認します。登録済IDは読取り専用です。順序1は、ファウンダ用に予約されています。
「表示名」に新しい顧客対応の名前を入力します。必要に応じて順序を更新します。
表示名または順序が変更された場合は、「組織の更新」を選択して、変更を組織レジストリに送信します。
組織ロゴ・イメージをカスタマイズするには、80KB以下のPNG、JPG、WEBPまたはSVGファイルをアップロードするか、「デフォルトの使用」を選択します。
「変更の保存」を選択してカスタマイズ・ドラフトを保存し、「閉じる」を選択します。
「設定」ページで、「変更の適用」を選択します。
アプリケーションが再起動したら、サインインして、組織カード、セレクタ、ヘッダー、アカウント・ビューおよび組織順序を示すリスト内の組織名、ロゴおよび順序を確認します。

レジストリでは、組織のIDと順序が管理されます。表示名を変更しても、登録されている組織IDは置換されません。「組織の更新」コントロールを使用して行われたレジストリの更新は、「変更の適用」コマンドを使用してカスタマイズ・ドラフトを公開することとは異なります。

アプリケーション・グループ・ラベルの変更

開始する前に、中央銀行管理者としてサインインし、「設定」を選択します。

「カスタマイズ」で、「アプリケーション・グループ」を選択します。
「アプリケーション・グループ」セレクタで、カスタマイズするグループを選択します。
固定承認の値を確認します。基礎となる認可マッピングは変更しないでください。
「ラベルの表示」に、顧客対応グループ名を入力します。
「変更の保存」および「閉じる」を選択し、「設定」ページで「変更の適用」を選択します。
アプリケーションが再起動したら、サインインして、ヘッダー、アカウント行、セレクタおよびプロファイル・メニューのラベルを確認します。

ラベルを変更しても、ユーザー権限、ワークスペース・アクセス、元帳ロールまたは勘定科目割当には影響しません。

取引タイプ・ラベルの変更

開始する前に、中央銀行管理者としてサインインし、「設定」を選択します。

「カスタマイズ」で、「トランザクション・ラベル」を選択します。
「トランザクション・タイプ」リストで、カスタマイズするトランザクション・マッピングを選択します。
「APIトランザクション・ラベル」フィールドを確認します。このサービス値は固定です。
「ラベルを表示」に、ユーザーに表示するラベルを入力します
「変更の保存」および「閉じる」を選択し、「設定」ページで「変更の適用」を選択します。
アプリケーションが再起動したら、サインインして、該当するトランザクション・ビューでラベルを確認します。

表示ラベルは変更されますが、APIトランザクション値は変更されません。

トークン・ロール・ラベルの変更

開始する前に、中央銀行管理者としてサインインし、「設定」を選択します。

「カスタマイズ」で、「ロール」を選択します。
「トークン・ロール」リストで、カスタマイズするロールを選択します。
ブロックチェーンで使用される固定認可ロールを確認します。この値は変更しないでください。
「ラベルの表示」に、顧客対応ロール名を入力します。
「変更の保存」および「閉じる」を選択し、「設定」ページで「変更の適用」を選択します。
アプリケーションが再起動したら、サインインして、アカウント・ビューおよびプロファイル・ビューでラベルを確認します。

ラベルを変更しても、ユーザーのブロックチェーン権限は付与、削除または変更されません。

アプリケーション構成

アプリケーション構成では、アプリケーションで使用される接続およびランタイム値が保持されます。これらの値は通常、デプロイメント管理者によって提供されます。対応するサービス、契約、アイデンティティ・プロバイダまたはデプロイメント環境が変更された場合のみ、それらを変更します。

アプリケーション構成を編集する前に、値が属するデプロイメントを記録します。置換値をデプロイメント管理者に確認し、すべてのシークレットをマスクしたままにします。シークレット・フィールドにすでにマスクされた値が含まれている場合は、既存のシークレットを保持する場合は空白のままにします。

アプリケーション設定の構成

開始する前に、中央銀行管理者としてサインインし、「設定」を選択します。デプロイメントのランタイム値を確認します。

「アプリケーション構成」で、「アプリケーション設定」を見つけます。
「トークンID」で、Besuデプロイメント中に指定されたトークン識別子を入力または確認します。IDは、残高、振替、発行、除・売却および勘定科目ビューに使用されるトークンを選択します。
「Network」フィールドを確認します。このリリースはBesuを使用しています。元帳ランタイムはデプロイメントによって固定されます。
保護された環境では、「接続セキュリティ」をHTTPSに設定します。ローカル・デプロイメントがHTTPに対して意図的に構成されている場合のみ、HTTPを使用します。
通常の使用には、「デバッグ・モード」を「オフ」に設定します。これは、制御されたテストまたはサポートの問題を診断するためにのみ一時的に有効にします。デバッグにより、認証およびバック・エンド・リクエストの詳細がサーバー・ログに追加されます。
設定を確認し、「変更の適用」を選択します。
アプリケーションが再起動するまで待機し、再度サインインして、該当するトークンおよびアカウント操作を確認します。

認証設定の構成

アイデンティティ・プロバイダは、デプロイメントまたはOracle Blockchain Platformインストールの一部として構成されます。「設定」ページでサインイン方法を選択すると、アカウントの作成やプロバイダのマルチファクタ認証(MFA)ポリシーの変更は行われません。

中央銀行管理者としてサインインし、「設定」を開きます。
「アプリケーション構成」で、「認証」を見つけます。
「サインイン・メソッド」で、デプロイメント用に構成されたメソッド(LDAPまたはOpenID Connect (OIDC))を選択します。
OpenID Connectを選択した場合は、構成を適用する前に、次の項のOIDC設定を完了します。
該当するフィールドに入力した後、「変更の適用」を選択し、再起動を待ってから、新しいサインインをテストします。

OpenID Connect設定の構成

開始する前に、アプリケーション・デプロイメントのOIDC発行者メタデータおよびクライアント登録値を取得します。次のフィールドは、サインイン方法として「OpenID Connect」が選択されている場合にのみ表示されます。

「発行者URL」に、アイデンティティ・プロバイダによって提供される信頼できる発行者を入力します。プロバイダのOIDC検出メタデータに対して検証します。卸売CBDCアプリケーションでは、この権限を使用して、認可、トークン、ログアウトおよび署名キー・エンドポイントを検出し、トークン発行者を検証します。アプリケーションURL、トークン・エンドポイントURL、または別の環境からコピーされた発行者は使用しないでください。
「クライアントID」に、このデプロイメントのURL用に作成された卸売CBDCアプリケーションのクライアントIDまたはアプリケーションIDを入力します。
クライアント登録で必要な場合は、マスクされた「クライアント・シークレット」フィールドに資格証明を入力します。既存のシークレットを変更しない場合は、編集フィールドを空白のままにします。
「リダイレクトURI」に、アイデンティティ・プロバイダに登録されている正確なコールバック・アドレスを入力します。デフォルトのローカル・ポートには、http://localhost:3000/api/auth/oidc/callbackを使用します。スキーム、ホスト、ポートおよびパスはすべて一致する必要があります。別のローカル・ポートを使用する場合は、対応するURIを登録します。
「ログアウト後のリダイレクトURI」に、プロバイダ・ログアウト後の登録済ブラウザの宛先を入力します。デフォルトのローカル設定では、http://localhost:3000/または明示的に登録された別のローカル・ポスト・ログアウト・ページを使用します。このURIは、サインイン・コールバックとは別に登録します。
「スコープ」には、スコープをスペースで区切って入力します。通常のベースラインはopenid profile emailです。デプロイメントで必要な場合にのみ、プロバイダ固有のスコープを追加します。
「ユーザーID要求」に、ラッパーAPIおよび元帳勘定科目データで使用されるユーザーIDと値が完全に一致する要求を入力します。通常のローカル・デフォルトはpreferred_usernameです。アイデンティティ・プロバイダとアプリケーション・データが一貫して使用する場合にのみ、別の要求を使用します。
すべての値を確認し、「設定」ページで「変更の適用」を選択します。
アプリケーションが再起動するのを待ってから、サインアウトしてから再びサインインしてください。コールバックが成功し、正しいウォレット・ロードが行われ、予想されるアカウント権限とペルソナ権限が使用可能であることを確認します。

OpenID Connectの用語

OpenID接続: 卸売CBDCアプリケーションが、アプリケーション・セッションを作成する前に返されたアイデンティティを検証する際に、アイデンティティ・プロバイダがユーザーを認証するサインイン・プロトコル。
アイデンティティ・プロバイダ: ユーザー・アカウント、パスワード、サインイン・ページおよびMFAポリシーを保持するサービス。卸売CBDCアプリケーションは、ユーザーのパスワードを受信しません。
認可コード: ユーザーがサインインした後に、登録済コールバックに送信される存続期間の短い値。卸売CBDCアプリケーション・バック・エンドは、トークンと交換します。
PKCE: コード交換用のプルーフ・キー。インターセプトされた認可コードが別のクライアントによって使用されないようにするブラウザ・リダイレクト・フローの保護。
アクセス・トークン: 構成済ダウンストリーム・サービスへのアクセスを取得または認可するためにバック・エンドで使用される短命資格証明。ドキュメントまたはサポート・メッセージにコピーしないでください。
クレーム: 検証済トークンに含まれるアイデンティティ属性(ユーザーID、電子メール、グループなど)。「ユーザーID請求」設定は、卸売CBDCアプリケーション・ユーザーにマップする属性を識別します。
MFA: ポリシーで追加の検証が必要な場合に、アイデンティティ・プロバイダによって実行される多要素認証。卸売CBDCアプリケーションの「設定」フィールドを変更しても、プロバイダのMFAは有効になりません。

ローカルOIDCサインイン・フロー

ユーザーは、ローカルの卸売CBDCアプリケーションを開き、サインイン・プロセスを開始します。
卸売CBDCアプリケーションは、発行者、クライアントIDおよびリクエストされたスコープを使用して、ブラウザを構成済アイデンティティ・プロバイダにリダイレクトします。
アイデンティティ・プロバイダはユーザーを認証し、ポリシーで必要なときにMFAを実行します。
プロバイダは、認可コードで正確に登録されたリダイレクトURIにブラウザをリダイレクトします。
卸売CBDCアプリケーション・バック・エンドでは、コードがトークンと交換され、認証レスポンスが検証され、構成されたユーザーIDクレームが読み取られ、アプリケーション・セッションが作成されます。
アプリケーションによって、ユーザーの適格なウォレット、組織、アカウントおよびロール・コンテキストがロードされます。
ユーザーがサインアウトすると、卸売CBDCアプリケーションはサポートされたときにプロバイダ・ログアウトを起動し、登録済のログアウト後のリダイレクトURIにブラウザを送信します。

ローカル設定のアイデンティティ・プロバイダ登録の検証

開始する前に: アイデンティティ・プロバイダ・アプリケーションの登録および卸売CBDCアプリケーションの「設定」ページ値へのアクセスを取得します。

構成されたissuerがプロバイダのOIDC発行者および検出メタデータと一致することを確認します。
登録されたクライアント・タイプおよびクライアント認証方法が、ローカルの卸売CBDCアプリケーション・バックエンドでサポートされていることを確認します。
リダイレクトURIがデフォルトのローカル・ポートのhttp://localhost:3000/api/auth/oidc/callbackまたは別のポートの正しく登録されたURIと完全に一致することを確認します。
post-logoutリダイレクトURIが個別に登録され、構成されたアドレス(http://localhost:3000/など)と一致していることを確認します。
プロバイダが構成済のスコープおよび選択したユーザーIDクレームを返すことを確認します。
ユーザーがアイデンティティ・プロバイダに存在し、予想されるグループに属し、構成済のMFAポリシーを完了できることを確認します。
卸売CBDCアプリケーションの「設定」ページで一致する値を適用し、アプリケーションが再起動するのを待ってから再度サインインして、コールバック、ウォレット、アカウントおよびロール・コンテキストを検証します。

Wrapper APIの設定

ラッパーは、WebアプリケーションをOracle Blockchain Platformサービスに接続し、デプロイされた台帳統合に接続します。

開始する前に: 中央銀行管理者としてサインインし、「設定」を選択して、ターゲット・デプロイメントのエンドポイントおよび資格証明を取得します。

「アプリケーション構成」で、「ラッパーAPI構成」を見つけます。
「サービス・エンドポイント」に、デプロイメントによって提供されるサービス・エンドポイントを入力します。
「ラッパーAPI URL」に、アカウント、トークン、組織、ウォレットおよびトランザクション操作に使用するアクセス可能なラッパー・ベースURLを入力します。
「アクセス・トークンURL」に、構成済サービス認証によって提供されるトークン・エンドポイントを入力します。
「OBPインスタンスのクライアントID」に、このOracle Blockchain Platformインスタンスに対して作成されたクライアント識別子を入力します。
必要に応じて、マスクされた「OBPインスタンス・クライアント・シークレット」フィールドに新しい資格証明を入力します。既存のシークレットを保持する場合は、空白のままにします。ドキュメント、スクリーンキャプチャ、ソースコントロール、またはサポートメッセージにシークレットを公開しないでください。
エンドポイント、識別子および資格証明が同じデプロイメントに属していることを確認し、「変更の適用」を選択します。
アプリケーションが再起動したら、サインインしてウォレットのロード、アカウントのロード、読取り操作および許可されたトランザクションを確認します。

スマート契約住所の構成

開始する前に、デプロイメント管理者とデプロイメントのBesu契約アドレスを確認します。

中央銀行管理者としてサインインし、「設定」を開きます。
「アプリケーション構成」で、「スマート・コントラクト構成」を見つけます。
「アカウント契約住所」に、アカウント登録、ステータス、制限、ロールおよびその他のアカウント関連元帳操作を提供するデプロイ済契約を入力します。
「トークン契約住所」に、トークン残高、発行、振替、保留、除・売却および関連するトークン操作に使用される配置済契約を入力します。
両方のアドレスがアプリケーションと同じBesuデプロイメントに属していることを確認し、「変更の適用」を選択します。
アプリケーションが再起動したら、サインインして、予想される勘定科目情報、残高、ロールおよびトランザクション結果を確認します。

別の環境からコピーされた契約住所は使用しないでください。不一致の契約により、間違った勘定科目、残高、ロールまたはトランザクション・データを返している間にアプリケーションが接続しているように見える場合があります。

Walletサービス設定の構成

開始する前に: ターゲット・デプロイメントのウォレット・サービスの詳細を取得します。

中央銀行管理者としてサインインし、「設定」を開きます。
「アプリケーション構成」で、「Wallet構成」を見つけます。
「Wallet API URL」に、認証済ユーザーが使用可能なウォレットのロードに使用するサービスURLを入力します。
「組織ID」に、ウォレットのロードおよび組織へのアカウント作成のスコープを設定するためにウォレット・サービスで使用される識別子を入力します。
「Wallet Service Instance ID」に、選択した組織およびユーザー・コンテキストを所有するサービス・インスタンスを入力します。
すべての値がデプロイメントと一致することを確認し、「変更の適用」を選択します。
アプリケーションの再起動後、再度サインインし、予想される組織のウォレットがロードされていることを確認します。ユーザーが適格ウォレットまたはCBDCアカウントを持っていない場合、アプリケーションは該当するペルソナのサインイン・プロセスを停止できます。

リッチ履歴データベースの構成

リッチ履歴では、構成されたORDSサービスを使用して、Besuアカウントおよび履歴読取りをサポートします。

開始する前に、ターゲット・デプロイメントのORDS OAuth構成を取得します。

中央銀行管理者としてサインインし、「設定」を開きます。
「アプリケーション構成」で、「リッチ履歴データベース構成」を見つけます。
「ORDS OAuthトークンURL」に、バックエンドがサービス・トークンを取得するORDSエンドポイントを入力します。
「ORDSクライアントID」に、サービス・トークン・リクエストに使用されるクライアント識別子を入力します。
資格証明を変更する必要がある場合は、マスクされたORDSクライアント・シークレット・フィールドに入力します。格納されているシークレットを保持する場合は、フィールドを空白のままにします。
設定を確認し、「変更の適用」を選択します。
アプリケーションが再起動したら、再度サインインして、アカウント読取りとトランザクション履歴読取りを確認します。

バックエンドはORDSサービス・トークンを取得し、Besuアカウントおよび履歴読取りのラッパーに送信します。ORDSベアラー・トークンをブラウザに公開したり、カスタマ・ドキュメントにコピーしないでください。

構成変更の適用および検証

開始する前に、中央銀行管理者としてサインインします。

「設定」ページで設定を変更します。
URL、識別子、スマート・コントラクト・アドレスおよびマスクされたシークレット・フィールドを確認します。すべての値が同じデプロイメントに属し、既存の資格証明が意図せず置換またはクリアされていないことを確認します。
カスタマイズ・カードが変更されたら、その「変更の保存」を選択してカード・ドラフトを保存します。
ページ・レベルの「変更の適用」コントロールを選択します。完全な構成が保存され、必要なアプリケーションの再起動またはロールアウトが開始されます。
アプリケーションが再度使用可能になったら、サインインします。
認証、ウォレットのロード、勘定科目ロード、残高、読取り履歴および影響を受けるペルソナ・アクションを確認します。

表示名とラベルの変更は、表示にのみ影響します。契約アドレス、組織ID、ウォレット・サービス・インスタンス、認証設定、ラッパー値またはORDS資格証明を変更すると、すべてのペルソナに影響を及ぼす可能性があり、デプロイメント変更管理手順に従う必要があります。

マイ・アカウント

「My Account」ページには、サインイン時に選択したウォレットおよびアカウントに関する情報が表示されます。

承認されたアカウントでログインします。
ナビゲーション・パネルで「My Account」を選択します。
アカウントIDまたは住所、ユーザー、組織、トークン詳細、アカウント・ステータス、残高および保留金額をレビューします。
ロールで許可されている日次トランザクションの使用状況と制限、アプリケーション・グループ、構成履歴およびステータス履歴をレビューします。

トランザクションおよび監査レコードのレビュー

「トランザクション」ページを使用して、履歴を検索し、サインインしたコンテキストで使用可能な詳細を検査します。監査者は、認可された監査ワークスペースを使用することもできます。

サインインし、ナビゲーション・パネルから「トランザクション」を開きます。
トランザクション識別子、トランザクション・タイプ、組織またはユーザー、アカウントまたは相手方テキスト、目的またはメモ、金額、残高、日付などの適用可能なフィルタを使用して、使用可能な履歴を検索します。フィルタの可用性はデータによって異なります。
照合トランザクションをレビューし、エントリをオープンして詳細を検査します。
監査ワークスペースの認証済/auditページを開きます。
必要な監査データおよび割り当てられた監査者ロールに応じて、「システム監査」または「組織監査」を選択します。