リレーを保護する
Protect Your Relays (iroh.computer)
要約
Iroh Servicesは、クライアント配布時に含まれるリレーURLが悪用されるリスクに対応するため、デフォルトでマネージドリレーの認証を必須としました。これにより、プロジェクトのAPIキーから発行されたトークンを持つエンドポイントのみがリレーを利用できるようになり、URLが漏洩しても不正利用を防ぐことができます。この変更は2026年6月以降にデプロイされたリレーに適用され、それ以前にデプロイされたリレーは互換性のために引き続きオープンなままですが、設定から認証を有効化することも可能です。
全文翻訳
リレーを保護する
2つのデバイスが直接接続できない場合、リレーが接続を中継し、データの流れを維持します。リレーが誰でも受け入れる場合、そのURLを知る者は誰でもリレーを通過するトラフィックをプッシュできます。そして、そのURLは、配布されるすべてのクライアントに含まれており、接続確立を監視している人なら誰でも確認できるため、すぐに知られてしまいます。
このため、Iroh Services上のマネージドリレーは、デフォルトで認証されるようにしました。プロジェクトのAPIキーによって発行されたトークンを持つエンドポイントのみが、それらを使用できます。
有効にするための特別な操作は必要ありません。すでにiroh_servicesプリセットを通じて接続している場合、エンドポイントは自動的に認証されます。
ただし、これは2026年6月以降にデプロイされたリレーのデフォルト設定です。それ以前にリレーをデプロイした場合、設定はそのままオープンな状態を維持するため、既存のエンドポイントに影響はありません。この機能を有効にするには、リレーの認証設定(Relays > Settings内)にアクセスしてください。
問題点:リレーURLは取り消せない認証情報
公開リポジトリ、クライアントバンドル、またはスクリーンショットからリレーURLを見つけた誰かが、インフラがダウンするまでスパムを送り続ける可能性があります。
自分でリレーを起動したとしても、他人のトラフィックが自分のトラフィックと競合します。リレーには、それがレンタルしたサーバーであれ、自分のデスクの下にあるVMであれ、あるいは当社に支払っている容量であれ、帯域幅と接続スロットの限界があります。URLを見つけた他の誰かが、それを利用し始めています。
自分でリレーを実行している場合は、独自の認証スキームを構築できます。irohはその点について意見を押し付けません。しかし、当社のマネージドリレーを使用している場合、今月まではアクセスを簡単に制御する方法を提供していませんでした。今回、認証パズルの最初のピースであるAPIキーをリリースしました。APIキーは無制限に発行、ローテーション、削除できます。これらは、メトリクスをプッシュするためにも使用しているAPIキーと同じものです。もしIroh Servicesを利用しているなら、すでに持っているはずです。
仕組み
すべてのリレー接続は、WebSocketへのアップグレードと同じHTTPハンドシェイクから始まります。認証情報は標準ヘッダーで送信されます。
トークンは署名されたケイパビリティトークンです。これには4つの情報が含まれています。
- 発行者:プロジェクトのAPIキー
- 対象:提示するエンドポイントの公開鍵
- 許可内容:リレーの使用許可のみ
- 有効期限:短期間に設定可能。漏洩した場合でも、長期間使用されることはありません。
エンドポイントが接続すると、irohのリレーハンドシェイクは、まずエンドポイントがその鍵を実際に所有していることを証明します。これは、認証されているかどうかにかかわらず、すべての接続に対して行われます。その後、リレーはトークンをチェックします。署名は有効か、期限は切れていないか、リレー使用の許可があるか、この特定のエンドポイント宛か、そしてプロジェクトのAPIキーのいずれかによって発行されたものか? すべての回答が「はい」であれば、エンドポイントは許可されます。
これにより、以下の2つの利点が得られます。
URLが漏洩しても無害です。 あなたのAPIキーによって発行されたトークンなしでは、接続しようとしても何も得られません。
トークンが漏洩しても、なりすましはできません。 トークンは特定のエンドポイントの公開鍵に宛てられているため、別のエンドポイントから提示しても失敗します。ハンドシェイクは、そのエンドポイントの秘密鍵の所有権を証明する必要がありますが、トークンだけではそれはできません。
取り消しも同様のパスをたどります。あなたのAPIキーはリレーが認識するIDであるため、APIキーをローテーションまたは削除すると、そのAPIキーが発行したトークンの認識を停止し、それらのトークンで通信している接続は切断されます。
エンドポイントの接続
これらをすべて手動で組み立てる必要はありません。 iroh_servicesプリセットは、APIシークレットからトークンを生成し、すべてのリレー接続に自動的に付与します。認証されたエンドポイントを構築するのは、これまで書いてきたコードとほとんど同じ数行です。
use iroh_net::relay::RelayUrl;
let api_secret = std::env::var("IROH_SERVICES_API_SECRET").expect("IROH_SERVICES_API_SECRET not set");
let relay_urls = vec![RelayUrl::from_url("wss://relay.example.com")?];
let mut endpoints = iroh_net::endpoint::Endpoint::builder()
.bind(0)?;
// Use the iroh_services preset to connect to authenticated relays
endpoints
.relays(iroh_services::preset(api_secret, relay_urls))
.await?;
APIシークレットはプロセスから離れることはありません。プリセットはそれを使用してリレー専用のトークンを導き出し、その導き出されたトークンがリレーに送信されます。.relays(...)をプロジェクトダッシュボードのリレーURLにポイントし、IROH_SERVICES_API_SECRETを設定するだけで完了です。
今後の予定
現在、各エンドポイントは同じ機能を持っています。将来的には、異なるスコープを持つトークンを発行する機能を追加し、一部のエンドポイントにより多くの権限を付与できるようにします。さらに、エンドポイントごとに個別にアクセスを取り消せるようにし、ダッシュボード外でこれらすべてを実行できるAPIも提供する予定です。これらの機能に興味がある場合は、Discordでご連絡ください。
現在リレーを実行している場合は、少なくとも2つの異なるリージョンにデプロイして、一方のリージョンがダウンしてもエンドポイントが孤立しないようにしてください。マネージドリレーガイドに、完全なセットアップ手順が記載されています。
質問がある場合や、リレーの設定について相談したい場合は、Discordに参加するか、通話のスケジュールを設定してください。リレーについて話すのが大好きで、皆様が最大限に活用できるようお手伝いしたいと考えています。
Irohは、すぐに機能するデバイス間通信ライブラリです。必要に応じて、既製のプロトコルのエコシステムから構築したり、単純なパイプのクリーンな抽象化の上に完全にカスタムなソリューションを構築したりできます。Irohはオープンソースであり、すでに何十万ものデバイスで本番稼働しています。
開始するには、ドキュメントをご覧になるか、コードに直接飛び込むか、Discordチャンネルでチャットしてください。