ピアリザベーションの使用

ピアリザベーションを使用すると、rippledサーバーが予約とマッチしたピアからの通信を常に受け入れるように設定できます。このページでは、ピアリザベーションを使用して2台のサーバー間のピアツーピア通信を、各サーバーの管理者の協力のもと一貫して維持する方法について説明します。

ピアリザベーションは、2台のサーバーが異なる組織によって運用されていて、着信接続を受信するサーバーが、多くのピアを持つハブサーバーである場合に特に便利です。分かりやすいように、これらの手順では次の用語を使用します。

  • ストックサーバーは発信接続を行うサーバーです。このサーバーは、ハブサーバー上のピアリザベーションを 使用 します。
  • ハブサーバーは着信接続を受信するサーバーです。管理者は、このサーバーにピアリザベーションを 追加 します。

ただし、一方または両方のサーバーがハブ、バリデータ、ストックサーバーのいずれあっても、これらの手順を使用してピアリザベーションを設定できます。また、よりビジーな状態にあるサーバーから発信接続をする場合にもピアリザベーションを使用できますが、以下のプロセスではそのような構成については説明しません。

前提条件

これらの手順を実行するには、次の前提条件を満たしている必要があります。

  • 両方のサーバーの管理者がrippledをインストールして実行している。
  • 両方のサーバーの管理者が協力することに合意し、連絡が取り合える。秘密情報を共有する必要はないため、パブリックな通信チャネルを使用してもかまいません。
  • ハブサーバーが着信ピア接続を受信できる。ファイアウォールをそのように設定する手順については、ピアリングのポート転送を参照してください。
  • 両方のサーバーが、同じXRP Ledgerネットワーク（本番XRP Ledger、Testnet、Devnetなど）と同期するように設定されている。

手順

ピアリザベーションを使用するには、以下の手順に従います。

1.（ストックサーバー）永続ノードキーペアを設定する

ストックサーバーの管理者が、以下の手順を実行します。

永続ノードキーペア値をすでにサーバーに設定している場合は、ステップ2: ノード公開鍵をピアの管理者に連絡するに進んでください。（例えば、各サーバーの永続ノードキーペアはサーバークラスターの設定の一環として設定します。）

ヒント: 永続ノードキーペアの設定は省略可能ですが、この設定をしておけば、サーバーのデータベースの消去や新規マシンへの移行が必要となった場合にピア接続の設定を容易に維持することができます。永続ノードキーペアを設定しない場合は、server_infoメソッドの応答のpubkey_nodeフィールドに表示される、サーバーが自動生成したノード公開鍵を使用できます。

  1. validation_createメソッドを使用して新しいランダムキーペアを生成します。（secret値を省略します。）

例:

    rippled validation_create

    Loading: "/etc/rippled.cfg"
    Connecting to 127.0.0.1:5005
    {
       "result" : {
          "status" : "success",
          "validation_key" : "FAWN JAVA JADE HEAL VARY HER REEL SHAW GAIL ARCH BEN IRMA",
          "validation_public_key" : "n9Mxf6qD4J55XeLSCEpqaePW4GjoCR5U1ZeGZGJUCNe3bQa4yQbG",
          "validation_seed" : "ssZkdwURFMBXenJPbrpE14b6noJSu"
       }
    }

validation_seed（ノードシード値）とvalidation_public_key値（ノード公開鍵）を保存します。

  1. rippledの構成ファイルを編集します。
    vim /etc/opt/ripple/rippled.cfg

The recommended installation uses the config file /etc/opt/ripple/rippled.cfg by default. Other places you can put a config file include $HOME/.config/ripple/rippled.cfg (where $HOME is the home directory of the user running rippled), $HOME/.local/ripple/rippled.cfg, or the current working directory from where you start rippled.

  1. 前のステップで生成したvalidation_seed値を使用して、[node_seed]スタンザを追加します。

例:

    [node_seed]
    ssZkdwURFMBXenJPbrpE14b6noJSu

警告: すべてのサーバーの[node_seed]値が一意である必要があります。構成ファイルを別のサーバーにコピーする場合は、[node_seed]値を削除するか、変更してください。[node_seed]は公開しないようにします。不正使用者がこの値にアクセスできた場合、それを使用してサーバーを偽装し、XRP Ledgerのピアツーピア通信を行う可能性があります。

  1. rippledサーバーを再起動します。
    systemctl restart rippled

2.ストックサーバーのノード公開鍵を連絡する

ストックサーバーの管理者が、ハブサーバーの管理者にストックサーバーのノード公開鍵を伝えます。（ステップ1のvalidation_public_keyを使用します。）ハブサーバーの管理者はこの値を以降のステップで使用する必要があります。

3.（ハブサーバー）ピアリザベーションを追加する

ハブサーバーの管理者が、以下の手順を実行します。

peer_reservations_addメソッドを使用し、前のステップで入手したノード公開鍵を使用して予約を追加します。例:

$ rippled peer_reservations_add n9Mxf6qD4J55XeLSCEpqaePW4GjoCR5U1ZeGZGJUCNe3bQa4yQbG "Description here"

Loading: "/etc/opt/ripple/rippled.cfg"
Connecting to 127.0.0.1:5005

{
  "result": {
    "status": "success"
  }
}

ヒント: 説明はオプションのフィールドです。この予約は誰のためにしたものかを人間が読み取れる形式のメモを追加できます。

4.ハブサーバーの現在のIPアドレスとピアポートを連絡する

ハブサーバーの管理者は、サーバーの現在のIPアドレスとピアポートをストックサーバーの管理者に伝える必要があります。ハブサーバーが、ネットワークアドレス変換（NAT）を行なうファイアウォールの内側にある場合は、サーバーの 外部 IPアドレスを使用します。デフォルトの構成ファイルは、ピアプロトコルにポート51235を使用します。

5.（ストックサーバー）ピアサーバーに接続する

ストックサーバーの管理者が、以下の手順を実行します。

connectメソッドを使用して、サーバーをハブサーバーに接続します。例:

{
    "command": "connect",
    "ip": "169.54.2.151",
    "port": 51235
}

{
    "method": "connect",
    "params": [
        {
            "ip": "169.54.2.151",
            "port": 51235

        }
    ]
}

rippled connect 169.54.2.151 51235

ハブサーバーの管理者が上記の手順に従ってピアリザベーションを設定した場合、自動的に接続され、可能な限り接続が維持されます。

次のステップ

サーバーの管理者は、サーバーに設定された他のピアへの予約を管理できます。（他のサーバーからの予約は確認できません。）次のことを実行できます。

ヒント: 不正なピアからの接続を即座に切断するAPIメソッドはありませんが、firewalldなどのソフトウェアファイアウォールを使用すれば、不正なピアからのサーバーへの接続をブロックできます。例については、コミュニティーによって作成されたrbhスクリプト を参照してください。

関連項目