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

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

RESTプロキシの使用方法

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

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

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

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

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

Blockchain Platformコンソールを使用して、新しい登録を追加し、IDCSユーザーをこれらの登録に関連付けます。登録はIDCS内ではなく、Blockchain Platform内で完全に管理されます。

ユーザーがRESTリソースにアクセスする方法については、Oracle Blockchain Platform REST APIに関する項を参照してください。

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

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

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

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

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

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