onionサービス

どのようなものか

onionサービスは、IPアドレスを指すDNS名の代わりに、サーバー自身の公開
鍵から作った名前を使い、Torネットワーク内からアクセスするサーバーで
す。単にonionとも呼ばれ、一つのtorデーモンで、複数のonionサービスを
並行して動かせます。仕様には、以前のhidden
service、隠しサービスという名前も残っています。

名前は、base32の56文字に`.onion`を付けたものです。デコードすると35バ
イトで、サービスの32バイトのed25519識別鍵、その鍵のSHA3-256ハッシュ
から取る二バイトのチェックサム、3に設定したバージョンの一バイトから
なります。最後がバージョンなので、現在のアドレスはすべてdで終わりま
す。ラベルを誰かが選ぶのでなく、鍵を書き表したものです。以前のバー
ジョン2の名前は、RSA-1024鍵のSHA-1ハッシュから取った16文字で、torは
2021年の0.4.6.1-alphaで対応を終了しました。

サービスに接続するには、二種類の合流場所を使います。サービスは、いく
つかのリレーを紹介ポイントとして選び、そこへのサーキットを開いてお
き、その一覧を載せた署名付きディスクリプターを、ディレクトリーリレー
へ送ります。ディスクリプターは、期間ごとに変わるブラインド化した鍵に
対応付けて保存し、本文も暗号化します。保存するリレーがアドレスを知ら
なければ、一覧を読めません。アドレスを持つクライアントは、ディスクリ
プターを取得し、名前に含まれる鍵で署名を検査し、一つのリレーをランデ
ブーポイントに選びます。紹介ポイントを通して、そこで合流するようサー
ビスに求めます。サービスは、自分のサーキットをそのリレーへ作ってハン
ドシェイクを完了し、リレーが二本のサーキットをつなぎます。経路には、
両側が三つずつ選んだ、計六つのリレーが入り、互いのIPアドレスは分かり
ません。以前はクライアント認可、現在は制限付き探索と呼ぶ任意のモード
では、許可したクライアントごとの鍵に向けて、ディスクリプターをさらに
暗号化します。紹介ポイントの場所が分かるのは、そのクライアントだけに
なります。

なぜ重要なのか

名前自体が、通常のサイトでDNSと認証局が分担する仕事を果たし、どちら
も必要としません。ディスクリプターを検証し、ハンドシェイクを完了する
と、アドレスの背後の秘密鍵を持つ相手と通信していると分かります。
`.onion`を特別用途のドメイン名に予約するRFC
7686は、この名前を、場所と認証を組み合わせるものと説明します。その帰
結として、onion名は、登録、割り当て、移転、取り消しができません。所
有するとは、鍵ペアを管理することだけです。

暗号化も、同じ設計から生まれます。onionサービスへの通信は、Torネット
ワークの外へ出ないため、相手側の出口リレーも、最後の平文区間もありま
せん。onionの単なる`http://`でも、入力した名前と照合してクライアント
が身元を確認したホストまで、ページをエンドツーエンドで暗号化して運び
ます。

サービスは、紹介ポイントと、各ランデブーポイントへ向けて、外向きの接
続だけを作ります。外から入るポートを開ける必要がなく、NATの内側でも
動きます。onionを追加しても、ホストで開いているポートの一覧は変わり
ません。

読者には、アドレスを知る手段が必要です。サイトが応答ヘッダー
`Onion-Location`で知らせると、Tor
Browserは、ページのonion版へ進める、紫のカプセル形のボタンをアドレス
バーに出します。Tor
Projectは、三つの条件を示します。値は、onionホストを持つ`http:`か
`https:`のURLであること、ヘッダーを送るページはHTTPSで届くこと、その
ページ自体はonion上にないことです。ヘッダーを設定できなければ、meta
タグでも知らせられますが、パスは引き継がず、すべてのページから一つの
固定URLへ向かいます。

実際の活用例

自社のonionミラーを、読みやすいアドレスで公開した手順を、段階ごとに
記録しています。デーモンは、ディストリビューション自身のパッケージか
ら入れ、外向きプロキシのポートを無効にしています。アドレスに対応する
秘密鍵は、ホスト外で生成し、リポジトリーにもノートパソコンにも、一度
も置いていません。ロールは、自分が生成しなかった識別情報を上書きしな
いため、手で置いた鍵をそのまま使います。アドレスはインベントリーで宣
言し、毎回の収束処理で、ホスト上の識別ファイルと一致するかを検査しま
す。鍵を差し替えて宣言を古いままにすると、実行を止めます。二つの秘密
情報検査は、どちらもこの鍵ファイルを検出します。分かりやすい鍵ファイ
ルのパターンでは、デプロイ鍵には一致しても、この鍵を見落とすと、測定
で分かったためです。

読みやすいプレフィックスは、探索して見つけられますが、選べません。一
文字増えるたびに、探索量の期待値が32倍になるため、`engineer`の八文字
には、平均で約1.1兆の鍵ペアが必要です。最初の公開時に使ったランダム
なアドレスは、段階的に切り替えて廃止し、公開済みのアドレスは、その間
も応答し続けました。終わりに見えて、そうではなかった段階もあります。
鍵を配置し、収束処理は変更なしと報告したのに、そのディレクトリーを指
定するものがなく、新しいアドレスは未公開のままでした。現在のロール
は、どのサービスも指定しない識別情報がディスク上にあると、失敗しま
す。

クレジットのページには、GeminiとGopherのアドレスと並べて、完全な
`engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd.onion`を載
せています。四つの入口は、同じ一つのフォルダーを読み、一回のデプロイ
ですべてを更新するため、内容が互いにずれません。通常のサイトは
`Onion-Location`を送り、読者が求めなくても、Tor
Browserがonionを案内します。読者自身のネットワークに見えるものは、入
口によって違います。Gopherなら読むページ、Geminiなら要求したアドレ
ス、onionならどちらも見えません。読みやすいプレフィックスは、便利な
だけで証明ではないので、比較するのはアドレス全体です。

アドレスの構造は、オフラインで検査できます。次の行は、デコードと
チェックサムの再計算を行い、二つの比較がどちらも`True`を表示します。

```python
import base64
import hashlib

label = "engineer2ezpeji52ipphljcflzyhetvy5r6tnqubtq45nzlxxv6rsqd"
raw = base64.b32decode(label.upper())
key, checksum, version = raw[:32], raw[32:34], raw[34:]
digest = hashlib.sha3_256(b".onion checksum" + key + version).digest()
print(version == b"\x03", digest[:2] == checksum)
```

正しいチェックサムが示すのは、形式が正しいことだけで、誰のアドレスか
ではありません。そこは、自社のHTTPSページに載ったアドレスを読むこと
で確かめます。

問題が起きるところ

鍵だけが、所有の証明です。
名前の背後に登録事業者がいないため、秘密鍵を失えばアドレスを失い、コ
ピーされれば、他人がそこで応答できます。Tor
Projectの設定ガイドは、鍵ファイルを秘密に保ち、長く続けるサービスな
ら、鍵をバックアップするよう求めます。設定でなく、署名鍵として扱いま
す。

最初の文字だけ読みます。 RFC
7686は、狙う名前に似た名前の鍵を、攻撃者が見つけられると警告します。
名前は人にとって意味を持たないため、リスクはさらに高くなります。相当
の計算で得る読みやすい名前は対策の一つですが、八文字のプレフィックス
があっても、残る48文字は以前と同じく不透明です。アドレス全体を比較す
るか、ブックマークや、そのサイト自身のHTTPSページのリンクから進みま
す。

サーバーが自分の名前を明かします。 Torがサービスの稼働場所を隠して
も、背後のソフトウェアが明かす場合があります。RFC
7686は、防御が失敗する例に、サーバーがアプリケーション層のメッセージ
で身元を漏らすことを挙げます。マシンの本当のホスト名を示すエラーペー
ジは、その一例です。設定ガイドは、サービスがローカルネットワークに露
出しないよう、TCPでなくUnixソケットで、ウェブサーバーに通信を渡すこ
とも勧めます。

```text
HiddenServiceDir /var/lib/tor/my-website/
HiddenServicePort 80 unix:/var/run/tor/my-website.sock
```

特に重要なのは、場所そのものを秘密にする場合です。

名前がDNSへ送られます。
Torに対応しないソフトウェアは、通常のリゾルバーにonion名を問い合わ
せ、ローカルネットワークとDNS提供元に、どのonionを求めたかを知らせま
す。RFC
7686は、そのようなソフトウェアには、問い合わせずに失敗することを、
DNSサーバーには、名前が存在しないと応答することを求めます。代わり
に、名前をTorクライアントへ渡します。

`Onion-Location`のボタンが出ません。
平文HTTPのリダイレクトにしかヘッダーを設定しないと、HTTPSの条件を満
たしません。アドレスを誤記しても、読者はどこにも着けません。最後の
HTTPS応答で、ヘッダーを確認します。

参考資料

  * Torランデブー仕様、バージョン3 — 識別鍵とブラインド化鍵、ディス
クリプター、紹介、ランデブーを含む、プロトコル全体です。

  * onionアドレスのエンコード — 公開鍵を56文字の名前に変える式と、ア
ドレスの例です。

  * onionサービスの仕組み — 紹介ポイント、ディスクリプター、ランデ
ブーを、一歩ずつ説明します。

  * onionサービスの設定 — torrcの行、torが作るファイル、鍵と場所の漏
洩に関する助言です。

  * Onion-Location —
Apache、Nginx、Caddyのヘッダーとmetaタグの設定、およびヘッダーが満た
すべき条件です。

  * RFC 7686 — `.onion`を予約する理由と、リゾルバー、DNS運用者、登録
事業者に必要な対応です。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/onion/	engineer.company	70
