From c7b4ab0fd2319da849770fbb1d607ae7a9f1ab6b Mon Sep 17 00:00:00 2001 From: barrier <110488117+barrier15300@users.noreply.github.com> Date: Mon, 15 Jul 2024 23:16:27 +0900 Subject: [PATCH 1/7] Create 15-docsideagateway.md --- gateway/15-docsideagateway.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 gateway/15-docsideagateway.md diff --git a/gateway/15-docsideagateway.md b/gateway/15-docsideagateway.md new file mode 100644 index 0000000..46fe923 --- /dev/null +++ b/gateway/15-docsideagateway.md @@ -0,0 +1,23 @@ +# Gateway Component + +# 概要 +Sutera Networkにある各Bloomに割り当てられている公開鍵を認証し、接続先のエンドポイントを返す。 + +# 詳細 +Sutera Networkのコンポーネントの一つに、Bloomというものがある。 +このBloomへ接続する際に、Gatewayコンポーネントに公開鍵を渡して認証する必要がある。 +無事認証が済めば、接続先のBloomに割り当てられているエンドポイント(IPとPort)を返す。 + +# 備考 +各Bloomの公開鍵は、ED25519アルゴリズムによって求められるものである + +# 例 +Bloom_hogeというサーバーに接続する場合 + +Bloom_hogeの公開鍵を取得 +↓ +Gatewayに取得した公開鍵を投げる +↓ +Bloom_hogeのエンドポイントを取得 + +といった流れを踏む From 21ca2a2f6c8d2fb923d15d8a3ecc9bc94b14f39e Mon Sep 17 00:00:00 2001 From: barrier <110488117+barrier15300@users.noreply.github.com> Date: Mon, 15 Jul 2024 23:49:18 +0900 Subject: [PATCH 2/7] Update 15-docsideagateway.md --- gateway/15-docsideagateway.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/gateway/15-docsideagateway.md b/gateway/15-docsideagateway.md index 46fe923..3ee5aa1 100644 --- a/gateway/15-docsideagateway.md +++ b/gateway/15-docsideagateway.md @@ -3,7 +3,7 @@ # 概要 Sutera Networkにある各Bloomに割り当てられている公開鍵を認証し、接続先のエンドポイントを返す。 -# 詳細 +# 詳細 (要確認) Sutera Networkのコンポーネントの一つに、Bloomというものがある。 このBloomへ接続する際に、Gatewayコンポーネントに公開鍵を渡して認証する必要がある。 無事認証が済めば、接続先のBloomに割り当てられているエンドポイント(IPとPort)を返す。 @@ -11,7 +11,7 @@ Sutera Networkのコンポーネントの一つに、Bloomというものがあ # 備考 各Bloomの公開鍵は、ED25519アルゴリズムによって求められるものである -# 例 +# 例 (要確認) Bloom_hogeというサーバーに接続する場合 Bloom_hogeの公開鍵を取得 From 0f0f83ac2480a6ffc1c1fdbac51e3f83a91a5b8a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?See2et=20/=20=E3=81=97=E3=83=BC=E3=81=9C=E3=81=A3=E3=81=A8?= <61668366+See2et@users.noreply.github.com> Date: Fri, 25 Oct 2024 13:39:24 +0900 Subject: [PATCH 3/7] re-wrote by see2et --- gateway/15-docsideagateway.md | 30 +++++++++++++----------------- 1 file changed, 13 insertions(+), 17 deletions(-) diff --git a/gateway/15-docsideagateway.md b/gateway/15-docsideagateway.md index 3ee5aa1..c9c2351 100644 --- a/gateway/15-docsideagateway.md +++ b/gateway/15-docsideagateway.md @@ -1,23 +1,19 @@ -# Gateway Component +# Gatewayコンポーネントとは -# 概要 -Sutera Networkにある各Bloomに割り当てられている公開鍵を認証し、接続先のエンドポイントを返す。 +Gatewayコンポーネントは、Suteraネットワークにある各BloomコンポーネントやClockingサーバーの公開鍵とエンドポイントを紐付けて保存する役目を負います。 +ここでいうエンドポイントとは、IPとポートのペアを指します。 +クライアントは接続したい任意のコンポーネントの公開鍵をGatewayコンポーネントに渡すことで、接続希望先のエンドポイントを取得できます。 -# 詳細 (要確認) -Sutera Networkのコンポーネントの一つに、Bloomというものがある。 -このBloomへ接続する際に、Gatewayコンポーネントに公開鍵を渡して認証する必要がある。 -無事認証が済めば、接続先のBloomに割り当てられているエンドポイント(IPとPort)を返す。 +## エンドポイントの検索 -# 備考 -各Bloomの公開鍵は、ED25519アルゴリズムによって求められるものである +Suteraネットワークが広大になっていくほど検索の対象とすべきBloomコンポーネントの数は膨大になっていきます。 +そのような状況下であっても常にエンドポイントの検索は迅速であることが期待されるため、以下の手順によって検索を行います。 -# 例 (要確認) -Bloom_hogeというサーバーに接続する場合 +1. リクエストされた公開鍵のハッシュ値を求める +2. そのハッシュ値と小さい差を持つ公開鍵とエンドンポイントのペアのみを検索の対象とする +3. リクエストされた公開鍵と一致する公開鍵とエンドンポイントのペアを見つける -Bloom_hogeの公開鍵を取得 -↓ -Gatewayに取得した公開鍵を投げる -↓ -Bloom_hogeのエンドポイントを取得 +## Gatewayコンポーネントの新設 -といった流れを踏む +Gatewayコンポーネントが新設あるいは停止状態から復帰するとき、そのコンポーネントは一切の情報を持たないか、情報が最新の状態に保たれていない可能性があります。 +Gatewayコンポーネントが正常に役割を果たせないことを避けるため、このような場合には任意の他のGatewayコンポーネントを選択し全てのデータを受信することができます。 From 371020356826a6eccc21120166a79447dc932615 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?See2et=20/=20=E3=81=97=E3=83=BC=E3=81=9C=E3=81=A3=E3=81=A8?= <61668366+See2et@users.noreply.github.com> Date: Fri, 25 Oct 2024 13:41:14 +0900 Subject: [PATCH 4/7] fix --- gateway/15-docsideagateway.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/gateway/15-docsideagateway.md b/gateway/15-docsideagateway.md index c9c2351..ff21a2e 100644 --- a/gateway/15-docsideagateway.md +++ b/gateway/15-docsideagateway.md @@ -1,13 +1,13 @@ # Gatewayコンポーネントとは -Gatewayコンポーネントは、Suteraネットワークにある各BloomコンポーネントやClockingサーバーの公開鍵とエンドポイントを紐付けて保存する役目を負います。 +Gatewayコンポーネントは、Suteraネットワークにある各BloomコンポーネントやClocking-Serverの公開鍵とエンドポイントを紐付けて保存する役目を負います。 ここでいうエンドポイントとは、IPとポートのペアを指します。 クライアントは接続したい任意のコンポーネントの公開鍵をGatewayコンポーネントに渡すことで、接続希望先のエンドポイントを取得できます。 ## エンドポイントの検索 Suteraネットワークが広大になっていくほど検索の対象とすべきBloomコンポーネントの数は膨大になっていきます。 -そのような状況下であっても常にエンドポイントの検索は迅速であることが期待されるため、以下の手順によって検索を行います。 +そのような状況下であっても常にエンドポイントの検索は迅速であることが期待されるため、以下の手順によって検索します。 1. リクエストされた公開鍵のハッシュ値を求める 2. そのハッシュ値と小さい差を持つ公開鍵とエンドンポイントのペアのみを検索の対象とする @@ -16,4 +16,4 @@ Suteraネットワークが広大になっていくほど検索の対象とす ## Gatewayコンポーネントの新設 Gatewayコンポーネントが新設あるいは停止状態から復帰するとき、そのコンポーネントは一切の情報を持たないか、情報が最新の状態に保たれていない可能性があります。 -Gatewayコンポーネントが正常に役割を果たせないことを避けるため、このような場合には任意の他のGatewayコンポーネントを選択し全てのデータを受信することができます。 +Gatewayコンポーネントが正常に役割を果たせないことを避けるため、このような場合には任意の他のGatewayコンポーネントを選択し全てのデータを受信できます。 From 7f8c7bfc53cc1b8f23d93e7d341a4231e89aab4f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?See2et=20/=20=E3=81=97=E3=83=BC=E3=81=9C=E3=81=A3=E3=81=A8?= <61668366+See2et@users.noreply.github.com> Date: Fri, 25 Oct 2024 13:44:48 +0900 Subject: [PATCH 5/7] Update 15-docsideagateway.md --- gateway/15-docsideagateway.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gateway/15-docsideagateway.md b/gateway/15-docsideagateway.md index ff21a2e..3a3edfb 100644 --- a/gateway/15-docsideagateway.md +++ b/gateway/15-docsideagateway.md @@ -1,7 +1,7 @@ # Gatewayコンポーネントとは Gatewayコンポーネントは、Suteraネットワークにある各BloomコンポーネントやClocking-Serverの公開鍵とエンドポイントを紐付けて保存する役目を負います。 -ここでいうエンドポイントとは、IPとポートのペアを指します。 +ここでいうエンドポイントとは、IPとポート番号のペアを指します。 クライアントは接続したい任意のコンポーネントの公開鍵をGatewayコンポーネントに渡すことで、接続希望先のエンドポイントを取得できます。 ## エンドポイントの検索 From 0088b8d994cbaf8b89e60543978a8fe41e724042 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?See2et=20/=20=E3=81=97=E3=83=BC=E3=81=9C=E3=81=A3=E3=81=A8?= <61668366+See2et@users.noreply.github.com> Date: Fri, 25 Oct 2024 13:45:15 +0900 Subject: [PATCH 6/7] Update 15-docsideagateway.md --- gateway/15-docsideagateway.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gateway/15-docsideagateway.md b/gateway/15-docsideagateway.md index 3a3edfb..5a66035 100644 --- a/gateway/15-docsideagateway.md +++ b/gateway/15-docsideagateway.md @@ -6,7 +6,7 @@ Gatewayコンポーネントは、Suteraネットワークにある各Bloomコ ## エンドポイントの検索 -Suteraネットワークが広大になっていくほど検索の対象とすべきBloomコンポーネントの数は膨大になっていきます。 +Suteraネットワークが広大になっていくほど検索の対象となるコンポーネントの数は膨大になっていきます。 そのような状況下であっても常にエンドポイントの検索は迅速であることが期待されるため、以下の手順によって検索します。 1. リクエストされた公開鍵のハッシュ値を求める From b82c4e13c2840b5bc3bd072721d2633f9666d1b4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?See2et=20/=20=E3=81=97=E3=83=BC=E3=81=9C=E3=81=A3=E3=81=A8?= <61668366+See2et@users.noreply.github.com> Date: Fri, 25 Oct 2024 13:45:33 +0900 Subject: [PATCH 7/7] Rename 15-docsideagateway.md to 15_what-is-gateway-component.md --- .../{15-docsideagateway.md => 15_what-is-gateway-component.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename gateway/{15-docsideagateway.md => 15_what-is-gateway-component.md} (100%) diff --git a/gateway/15-docsideagateway.md b/gateway/15_what-is-gateway-component.md similarity index 100% rename from gateway/15-docsideagateway.md rename to gateway/15_what-is-gateway-component.md