RESTプロキシ・ノードの管理

このトピックでは、RESTプロキシの使用方法の理解、RESTプロキシへの登録の追加、およびRESTプロキシ・ノードの表示と編集に役立つ情報について説明します。

RESTプロキシの使用方法

RESTプロキシは、アプリケーション・アイデンティティをブロックチェーン・メンバーにマップします。これにより、ユーザーおよびアプリケーションはOracle Blockchain Platform REST APIをコールできます。

Oracle Blockchain Platformでは、ネイティブのHyperledger Fabric APIを使用するかわりに、RESTプロキシを使用してRESTネットワークと対話できます。ネイティブHyperledger Fabric APIを使用する場合は、ピアおよびオーダラに直接接続します。ただし、RESTプロキシを使用すると、RESTfulプロトコルを介してFabricチェーンコードの問合せや呼出しを行えます。

RESTプロキシへの登録の追加

RESTプロキシにHyperledger Fabric登録を追加できます。登録により、ユーザーは登録証明書なしでRESTプロキシをコールできます。

登録にユーザーを追加する場合は、そのユーザーがIDCSにすでに存在し、REST_USERロールに割り当てられている必要があります。

Blockchain Platformコンソールを使用して、新しい登録を追加し、IDCSユーザーをこれらの登録に関連付けます。登録は、IDCS内ではなくブロックチェーン・プラットフォーム内で完全に管理されます。

ユーザーによるRESTリソースへのアクセス方法の詳細は、『Oracle Blockchain Platform REST API』を参照してください。

Go to the console and select the Nodes tab.
ノード・タブで、登録の追加先のRESTプロキシ・ノードを特定し、このノードの「アクション」メニューをクリックします。
「登録の表示または管理」をクリックしてノードの現在の登録のリストを表示します。
現在の登録のリストが表示されます。このページから、既存の登録を削除したり、新しい登録を追加できます。
「新規登録の作成」を展開します。
「登録ID」フィールドに、追加する登録の名前を入力します。
登録IDに使用できるのは、英数字、ハイフン(-)およびアンダースコア(_)のみです。
オプションで、「ユーザーID」フィールドに、登録に関連付けるREST_USERロールを持つユーザーのIDを入力します。「登録」をクリックします。
「登録」をクリックすると、次のようになります。
- 登録が作成され、登録表に表示されます。
- 新しい登録は、ネットワーク内の各RESTプロキシ・ノードにコピーされます。
- ユーザーIDを指定した場合、そのIDは登録に関連付けられ、関連付けられたRESTユーザー・リストからは削除できません。ユーザーIDが有効なRESTユーザーでない場合は、エラーが返されます。
- ユーザーIDを指定した場合、生成された登録証明書には、username属性としてIDが含まれます。
- コロン(:)を含むユーザーIDは、基本認証を使用するREST APIコールではサポートされていません。
「関連付けられたRESTクライアント・ユーザー」ペインで、登録からユーザーを削除するなど、現在の登録に関連付けられているユーザーを表示および管理できます。
「新規ユーザーの関連付け」を展開して、別のユーザーを登録に追加します。REST_USERロールにすでに割り当てられているユーザーの電子メールまたはIDを入力します。「関連付け」をクリックします。

登録を作成してユーザーを関連付けた後、RESTを使用してブロックチェーン上でトランザクションを実行すると、ブロックの詳細にリストされているイニシエータが、元のデフォルト・ユーザーではなく新しい登録としてリストされます。

RESTプロキシ・ノードの構成の表示と編集

RESTプロキシ・ノードの構成により、ネットワーク上でのノードの挙動や動作が決まります。

ノードの構成を変更できます。ユーザー権限を付与されている場合は、ノードの構成設定を表示できます。「RESTプロキシ」ノードの属性を参照してください。

Go to the console and select the Nodes tab.
ノード・タブで、ノード表に移動し、構成情報が必要なRESTプロキシ・ノードを特定してノードのその他のアクション・ボタンをクリックします。
構成オプションは、権限によって決まります。管理者の場合、「構成の編集」を探してクリックします。ユーザーの場合、「表示」を探してクリックします。
構成ダイアログが表示されます。
管理者の場合は、ノードの提案待機時間(ミリ秒)、トランザクション待機時間(ミリ秒)、ログ・レベルおよびトランザクション・イベント・ロギングの各属性を必要に応じて変更します。
「送信」をクリックして構成の変更を保存するか、「X」をクリックして構成ダイアログを閉じます。

RESTプロキシ・ノードのヘルス情報の表示

RESTプロキシ・ノードのメトリックをチェックすると、ブロックチェーン・ネットワーク上でのノードの動作状況を確認できます。この情報は、パフォーマンス上の問題の発見および診断に役立ちます。

ヘルス・ペインには、パフォーマンス・メトリック(CPU使用率およびメモリー使用率)が表示されます。

Go to the console and select the Nodes tab.
ノード・タブで、ヘルス情報の表示対象のRESTプロキシ・ノードをクリックします。
ノード情報ページが表示されます。
ヘルス・ペインをクリックして、ノードのパフォーマンス・メトリックを表示します。
使用率が常に高い場合は、Oracle Supportに連絡してください。