Provided by: manpages-ja_0.5.0.0.20161015+dfsg-1_all bug

NAME

       Zebedee --- シンプルでフリーでセキュアなトンネルプログラム

書式

       Server:
           zebedee -s [-dDtu] [-f file] [-k keybits] [-n name] [-o logfile] [-r ports] [-v level]
           [-x config] [-z level] [targethost]

       Client:
           zebedee [-dDmtu] [-e command] [-f file] [-k keybits] [-n name] [-o log] [-v level] [-x
           config] [-z level] [[clientports:]serverhost[:targetport]]

       Key generation:
           zebedee -p [-f file]

           zebedee -P [-p] [-f file]

       Hash generation:
           zebedee -h [file ...]

           zebedee -H string ...

       Windows Service:
           zebedee [-n name] -S [install[=file] | remove | run]

DESCRIPTION

       Zebedeeは2つのシステム間で、 暗号化され、圧縮されたTCP/IPまたはUDPの"トンネル"を確立する単
       純なプログラムである。 これは、低帯域のネットワーク上でのパフォーマンスを圧縮により向上す
       るだけでなく、 telnet, ftpX などの TCP ベースの トラフィックを盗聴から防御することも可
       能にする。 また、暗号化の有無にかかわらずデータ圧縮を使用することで、 遅いネットワークで良
       好なパフォーマンスを得ることも可能である。

       Zebedee の主な目的は:

       •   UNIX と Windows 95/98/NT の双方にてクライアントとサーバーの機能を提供する。

       •   ほんの少しの設定か全くの設定無しで簡単にインストール、使用、保守ができる。

       •   少しの付加データと、少ないプロトコルのオーバヘッドにて、 圧縮により多大なトラフィック
           の低減を行う。

       •   特許化されていないか、または特許の有効期限が切れているアルゴリズムのみを用いる。

       •   GNU 一般公有使用許諾書(GPL)のもとで商用、非商用を問わず 完全にフリーに使用・配布ができ
           る ("CREDITS AND LEGALITIES" を見よ)。

       もちろん、Zebedee は初めてのあるいは唯一の利用可能な セキュアなトンネルプログラムではな
       い。 高機能という面では sshSSL などとは比べ物にもならないが、 もし、素早く、単純で、
       全にフリーなものを求め ているなら、これはピッタリのツールだろう。

       この文書は Zebedee リリース 2.0.0 の機能について記している.

   名前の由来は?(What's in a name?)
       あなたが疑問を持とうが持つまいが、Zebedee は次の 3つの主要なコンポー ネントから命名され
       た。

       •   Zlib による圧縮

       •   Blowfish による暗号化

       •   Diffie-Hellman による認証

       これでわかったよね?

   基本的な使い方(Basic Usage)
       ローカルマシンとリモートホストを安全に接続するには、 まずリモートホストの方で、Zebedee を
       サーバーモードで起動する必要がある。 一番簡単な方法は、-s オプションを使うことだ。

        zebedee -s

       うまくいけば(いくはず!)Zebedeeは 端末(windowsではコンソールウインドウ)から切り離されて
       バックグラウンドで走る。 そして、クライアントからの接続を待つ。

       次にクライアントマシンでZebedeeをクライアントモードで起動する。 この場合は、リモートホスト
       のホスト名とトンネルすべきサービス名かポート番号 (ここではこれをターゲットポートと呼ぶこと
       にする)を指定する。 例えば、リモートホストの名前が"remhost"で 安全なtelnetセッションを張り
       たいとしたら、こうなる。

        zebedee remhost:telnet

       実際には、ポートのデフォルトがtelnetなので このケースでは次のように省略してもよい。

        zebedee remhost

       このコマンドを実行すると、 トンネルの入口になる(ローカル側の)ポートの番号が表示される。
       Zebedeeは端末から切り離されてバックグラウンドで走り、 このローカル側のポートに接続されるの
       を待つ。 例えば、1234と表示されたら、

        telnet localhost 1234

       とすれば、"remhost"に安全なトンネル経由で接続される。

       デフォルトでは、Zebedeeはプロセスを終了させるまで接続を待ち続けて、 必要があれば同時発生す
       る複数のコネクションを処理する。

       時には、Zebedeeを起動し、 その後すぐにそのポートに接続するコマンドを起動したいこともあるだ
       ろう。 これを一発でやるには次のようにする。

        zebedee -e "telnet localhost %d" remhost

       文字列中の"%d"がローカルポート番号と置き換えられる。従って、 Zebedeeはポート番号を表示しな
       い(する必要がない)。 このようにコマンドを指定した場合には、そのコマンドが接続を終了すると
       同時に、 ローカル側のZebedeeクライアントも終了する。

       クライアントが使用するローカルポート番号を指定したい(する必要がある)こともあるだろう。 (保
       護したい通信を行なう)コマンドが、特定のポートに接続しようとする場合だ。 この場合
       は、Zebedeeを次のように起動することで、 ローカルポートを指定することもできる。

        zebedee clientport:hostname:targetport

       例えば、次のコマンド:

        zebedee 8000:webhost:80

       は、クライアントの8000番ポート経由で接続する、 webhostへの全てのHTTP接続を保護する。 詳細
       はEXAMPLES参照のこと。

       また、Zebedee クライアントは 同一ホスト内の複数のターゲットポートに対して、 複数のトンネル
       を(同時並行的に)扱うこともできる。 この場合は、ローカルとリモートのポートの指定はポート番
       号のリストになる。 例えば

        zebedee 9001,9002,9003:somehost:daytime,telnet,ftp

       これは、9001番のクライアントポートへの通信を、 リモートのターゲットシステムのdaytimeポート
       へとトンネルする。 同様に、9002番はtelnetポートへ、9003番はftpポートへトンネルする。

       詳細は clientporttargetportを参照のこと。

   UDPトンネリング(UDP Tunnelling)
       Zebedeeはもともとは TCP/IP のトラフィックだけを扱うように設計されたが、 バージョン2.0.0か
       らはコネクションレスのUDPのデータも扱えるようになった。 この機能を有効にするにはZebedee-u オプション付きで起動する (または、udpmode キーワードを使用する)。 例えばサーバ側で

        zebedee -s -u

       クライアント側で

        zebedee -u 10000:somehost:echo

       を実行する。なお、ひとつのクライアントとサーバは、TCPかUDPのどちらかを扱い、 両方同時に扱
       うことはできない。両方のタイプをトンネルするには、 2つの独立したインスタンスを起動する。
       TCPモードとUDPモードのサーバは違うポートを使うので、 両者を同じシステムで起動することは安
       全である。

       UDPモードでもZebedeeのクライアントとサーバ間のトンネルはTCP/IPで接続する。 この接続は無通
       信が一定時間続くとタイムアウトする。 タイムアウトしてからさらにデータが来るとトンネルの再
       接続を行う必要があるので、 アプリケーションの特性によっては UDPモードのパフォーマンスがよ
       くないように見えることもある。 また、扱えるUDPダイアグラムのサイズにも制限があることにも注
       意すること。

       詳細は、maxbufsizeudpmodeudptimeout を参照のこと。

   言葉の定義(Some Terminology)
       通常は、Zebedeeを使用する場合、関係するシステムは2つである。 片方でクライアントを起動し
       て、ローカルポートでそれと通信する。 反対側ではサーバを起動して、そのシステムで動作してい
       るサービスと会話する。 しかしながら、次のように最大4つのシステム(マシン)が関係するケースも
       ありえる。

        [ソース] <===> [クライアント] <=====> [サーバ] <===> [ターゲット]
                   |                     |               |
                   +- 安全でない         |               + 安全でない
                      接続               |                 接続
                                         +- 安全なトンネル

       Zebedeeのクライアントは「クライアント」システムで、 サーバは「サーバ」システムでそれぞれ動
       作している。 トンネル設定の契機となる最初の接続は「ソース」マシンから発生する。 「ソー
       ス」と「クライアント」は違うシステムであってもかまわないが、 通常は同一のシステムである。
       サーバは最後に「ターゲット」システムと通信する。 ターゲットも普通はソースと同じマシンにな
       るが、違うマシンであっても全く問題はない。

       ほとんどの場合、「ソース」と「クライアント」、 「サーバ」と「ターゲット」の違いを気にする
       必要はない。 しかし、この用語の区別が以下に述べるキーワードに多く反映している。 キーワード
       の説明を読む時には、このことを頭に入れておいたほうがいいだろう。

       Zebedeeのトンネルに関係するこの4つシステムの問題と別に、 安全に接続するために、いくつかの
       全く違うタイプの「キー(key)」が使われる。 クライアントとサーバはprivate key(秘密鍵)という
       値を必要とする (自分で生成する場合もある)。 このキーからは、public values が計算され交換さ
       れ、 それによりshared secret key が導き出される (この時にDiffie-Hellman key agreement
       mechanism が使用される)。 このキーからは、接続のたびにユニークなsession keyが導き出され、
       最終的にこのキーで暗号化が行なわれる。

   設定ファイル(Configuration File)
       Zebedee の動作をコントロールするには、 設定ファイルを使うのがおそらく一番よい。設定ファイ
       ルを指定するには コマンドラインオプションで -fを使う。ファイルは(-f)オプションの位 置で処
       理される。従って、それ以降のコマンドラインオプションでファイルの内 容を上書きすることがで
       きる。

       行の形式は以下のとおり。

        key value # optional comment

       keyはひとつの単語であり大文字小文字は無視される。valueは単語か文字 列かどちらかである。 文
       字列はダブルクォート("こんな風に")かシングルクォート ('こんな風に')でくくられる。ダブル
       クォート " の中に シングルクォート ' があってもよいし("here's an example")、その逆も言え
       る。 value では大文字小文字の違いは区別される。

       空白行と""#""ではじまる行(その前に空白があっても同じ)は無視される。 長い文字列は ""\""で次
       の行に継続することもできる。 この文字は除去され、次の行がこの行に接続される。 1行の長さは
       継続行も含め 1024 文字に制限されていることに注意。 行の接続はコメントの認識を含めすべての
       処理に先だって行われる。 そのため以下の例

        server false
        # This comment continues on the next line \
        server true

       では、serverの値は falseになる。

       キーワードとその意味は以下に述べる。 ほとんどのキーワードは対応するコマンドラインオプショ
       ンがあるが、 なかには対応するオプションがないものもある。 対応するコマンドラインオプション
       があるものについてはそれも併記してある。 逆に、コマンドラインオプションの中には 設定ファイ
       ル内のキーワードに対応するものがないものもある。 それらはこのセクションの最後に述べる。

       キーワードが真偽値(boolean)と書かれていたら、 その値は"true" または "false"でなければなら
       ない。

       キーワードの中にはポートのリストを指定するものがある。 この場合は、ポート名(サービス
       名)、ポート番号、番号の範囲を コンマか空白で区切ったものを指定する。 例えば、""telnet, ftp
       5900-5903""は ""23,21,5900,5901,5902,5903""と等しい。

       また、クライアントだけに指定するキーワードもあるし、 サーバだけに指定するキーワードもあ
       る。 ひとつの Zebedee プログラムはサーバかクライアントかどちらかひとつの機能を実行し、 そ
       の時の用途と違う用途向けのオプションは無視する。 エラーメッセージも表示しない。 サーバにな
       るかクライアントになるかは、 server キーワードで決まる。

       server (コマンドラインでは -s)
           これは、クライアントになるかサーバになるかを決める真偽値のキーワードである。 これが指
           定されなかった場合は、クライアントとして動作する。 コマンドラインオプションの -s オプ
           ションはこの値をtrueにするのと等しい。

       クライアント専用キーワード(Client-Only Keywords)

       以下のキーワードはクライアントだけに適用される。

       command (コマンドラインでは -e)
           クライアントとして動作している時に意味を持つ。 これは、トンネルへ接続した後に起動され
           るコマンドを示す。 この値が "%d" という文字列を含んでいたら、実行時にローカルポート番
           号と置き変えられる (clientport 参照)。 この処理はsprintf関数を使用して行なうので、
           ""%""によるエスケープ処理が適用される (すなわち、""%"" を 1 文字生成するためには
           ""%%"" を使う)。 さらに、"%d" を二つ以上指定したり "%d" 以外のフォーマット指定子 を指
           定すると、おそらくプログラムはクラッシュするだろう。

           コマンドが接続を閉じたら、Zebedeeも終了する。 このキーワードおよびオプションを使用する
           と、暗黙のうちにマルチユースモードがOFFになる (multiuse参照)。 Zebedee クライアントが
           複数の接続を扱う場合 (multiuse)やポートのリストが clientportで指定された場合は、コマン
           ドの自動起動は 使用することができない。

       clientport
           これはZebedee クライアントがローカル接続のためにlistenすべき、 ひとつのポート番号か
           ポート番号のリストである。

           もしクライアントがトンネルするのが単独のリモートポートならば、 これは省略できる。 その
           場合はポートは自動的に割り当てられて、 端末にポート番号を示すメッセージが表示される。

           ポート番号のリストを指定する時は、リモートポートがコマンドラインで指定されたのであれ、
           targetport キーワードで指定されたのであれ、 ポートの数は正確にリモートポートの数と一致
           しなければならない。

           2.0.0より前のバージョンでは、同じ意味でlocalportというキーワードが使用されていた。 後
           方互換性のために、このキーワードは現バージョンでも認識される。

       localsource
           この値がtrueだと、クライアントはローカルマシンで発生した接続だけを受けつける。 別の言
           葉で言うと、「ソース」と「クライアント」が同一のシステムである必要がある。

           この値はデフォルトはfalseであり、どのマシンがソースとなっても接続を受けつける。

       multiuse (コマンドラインでは -m)
           この値がtrueだと(デフォルトではそうなっているが)、 Zebedeeのクライアントは複数の接続要
           求(同時並行的に発生してもよい)を扱い、 要求ひとつひとつに対して、新しいトンネルを設置
           する。 値がfalseだと、クライアントはシングルユースモードで動作し、 最初の接続が閉じら
           れた直後に終了する。

           コマンドラインの-mオプションはこれをtrueに設定するのと等しい。 現在のバージョン
           のZebedeeはこれがデフォルトだが (だから、このオプションを設定する必要はないが)、 後方
           互換性のために残されている。

           クライアントが複数のポートを待ち受ける場合は、 たとえこれがfalseに設定されていても、
           自動的に マルチユースモードになる。 (clientport 参照)

       serverhost
           これはトンネルを接続すべきリモートホストの名前である。 ホストの名称にはデフォルトはな
           いので、 設定ファイルかコマンドラインのどちらかで、 必ずこれを指定しなければならない。

           2.0.0より前のバージョンでは、同じ意味でremotehostというキーワードが使用されていた。 後
           方互換性のために、このキーワードは現バージョンでも認識される。

       targetport
           ここに指定したポート番号(リストも可)でターゲットホストに接続するように、 Zebedeeクライ
           アントがZebedeeサーバに要求する。 これが指定されない時のデフォルトは"telnet" (ポート番
           号 23)である。

           ポート番号のリストを指定する時は、 ローカルポートがコマンドラインで指定されたのであ
           れ、 clientport キーワードで指定されたのであれ、 ポートの数は正確にローカルポートの数
           と一致しなければならない。

           2.0.0より前のバージョンでは、同じ意味でremoteportというキーワードが使用されていた。 後
           方互換性のために、このキーワードは現バージョンでも認識される。

       サーバ専用キーワード(Server-Only Keywords)

       以下のキーワードはサーバとして動作する時に適用する。

       redirect (コマンドラインでは -r)
           このキーワードはサーバがリダイレクトするポートのリストである。 (例 ""telnet,ftp,
           5900-5910"") もし redirect キーワードが指定されない場合は、 どのポートへのトンネル接続
           要求も受け付けられる。 この方法(redirectを指定しないこと)はテスト中には便利だが、 セ
           キュリティー面でのリスクがあるので、 もし可能ならば(このキーワードで)明示的に許可する
           ポートを指定すべきである。

           このキーワード(または-rオプション)は複数指定されてもよい。この場合は、 そのうちどれか
           のポートに指定されていればリダイレクトが許可される。

       targethost
           デフォルトではZebedee サーバは 全てのトンネルをローカルマシンのポートにリダイレクトす
           る。 もし、このキーワードが指定されると、 全ての接続はその名称のホストへとリダイレクト
           される。 トンネルを安全なネットワークの中にまで延長するのは無駄であるが、 この機能を使
           用すると、そのオーバーヘッドを省くことができて便利である。 また ftp のトラフィックをト
           ンネルする時にも使える。 (詳細はEXAMPLES参照)

           Zebedeeがサーバモードで動作する時は、 通信をリダイレクトすべきホストの名称は、 コマン
           ドラインの最後の付加的なパラメータとして指定することもできる。

           2.0.0より前のバージョンでは、同じ意味でredirecthostというキーワードが使用されていた。
           後方互換性のために、このキーワードは現バージョンでも認識される。

       圧縮と暗号化関連のキーワード(Compression and Encryption Keywords)

       以下のキーワードは、トンネル内を流れるデータの圧縮と暗号化を制御する。 これらは、クライア
       ントとサーバどちらでも使用される。

       compression (コマンドラインでは -z)
           Zebedee は圧縮方式として zlib をサポートする。 そして、もしコンパイル時に有効になって
           いればbzip2もサポートする。 このキーワードで圧縮の方式と圧縮レベルを指定する。 この値
           の形式は type:level である。type は ""zlib"" と ""bzip2""のどちらか、level は0から9の
           整数である。 プレフィックスなしで整数だけの場合は、zlibが選択される。

           level は使用可能な最大の圧縮レベルを設定する (9が最大で0が圧縮なし)。 実際に使用される
           圧縮レベルは、クライアントの値とサーバの値の最小値である。 この目的では、(0以外
           の)bzip2レベルはいかなるzlibレベルの値より上であるとみなされる。 従って、サーバとクラ
           イアントのいずれかがbzip2レベルをサポートしていなければ、 プロトコルはzlibを選択する。
           デフォルトの圧縮レベルは""zlib:6""である。

           bzip2圧縮の動作方式とバッファーサイズのために、 bzip2は連続的なデータのストリームが流
           れる場合にだけ使う意味がある。 通常のtelnetセッションのような、小さな転送ではzlibの方
           が性能がよい。 どちらがあなたにとってよく働くかは、実験してみないとわからないだろう。
           加えて、バッファーサイズが小さいので、bzip2の1より上からは得るものがない。 Zebedeeはこ
           れより上の値はこの値に変更する。

           verbosity levelを2以上にすれば、 接続が終了した時に基本的な統計値がプリントアウトされ
           るので、 どれだけ圧縮が有効だったか正確に知ることができる。 例えば、

            zebedee(232/210):   read 166 bytes (265 expanded) in 3 messages
            zebedee(232/210):   wrote 20969 bytes (30499 expanded) in 247 messages

       generator
           これは、Diffie-Hellmanキー交換の"generator"で、16進数の文字列で指定する。 デフォルト
           は"2"である。 なんのことかわからなければ、 下手にいじらない方がいいだろう。

       keygencommand
           このキーワードが指定されると、 この値(コマンド文字列)が秘密鍵を生成するために使用され
           る。 そのコマンドは標準出力に1行の16進数を出力しなくてはならない。 この行は少くと
           も10桁の16進数であること。

       keygenlevel
           これは0と2の間の整数で、Zebedeeで使用する秘密鍵生成の強度を決定する。 デフォルトは2(最
           強)である。接続時のパフォーマンスが耐えがたい場合以外には、 一般的にはこれを変更しない
           ほうがよい。

           簡単に言って、UNXI系のシステムではレベル2のキー生成のメカニズムは、 可能であれば
           "/dev/random" を使用する。 しかしながら、あまりにも多くの要求を連続的にこのデバイスに
           対して行うと、 カーネルが必要な"エントロピー"をかき集める間、 プロセスがブロックされる
           可能性がある(それが数秒になることもある)。 "/dev/random"が使用できない場合や レベル
           が1にセットされた場合は、 "/proc"ファイルシステムの現在の内容が(もしあれば)使用され
           る。 レベル0では現在のプロセスにある情報だけが使用される。

           Windows上のシステムでは、現在のところ、 キー生成強度のレベルごとの違いはなく、 この
           キーワードは実際には無視される。

       keylength (コマンドラインでは -k)
           これは、Blowfish暗号化のキーのビット長の最大値の整数である。 この値は4から576の間の4の
           倍数でなければならない。 使用されるキー長はクライアントの値とサーバの値の最小値にな
           る。 (minkeylength参照)

           デフォルトは128である。 特別なケースとして、この値が0に設定されると、 キーのネゴシエー
           ションと暗号化は無効にされる。

       keylifetime
           このパラメータの値が0以外に設定されると、これ以降の接続において、 クライアントはセッ
           ションキーの導出のために、以前設定されたshared secret keyを 再利用するように要求する。
           つまりZebedeeのクライアントとサーバは、 最初の接続においてのみキー交換の対話を全て行な
           う。 それ以降の接続では、キーの有効期限が切れるまでは、同じsecret keyが再利用され、 こ
           のキーからsession keyが導出される。 キーの有効期限が切れると、自動的に新しいキーの交換
           が行なわれる。

           そして、このキーワードが、shared secret keyが有効な期間を指定する。 これは、既に接続さ
           れた接続には影響しないで、新しい接続だけに影響する。

           このキーワードの値の単位は秒であり、65535(約18時間)以下でなければならない。 デフォルト
           は3600秒(1時間)である。 このキーワードの値を0に設定すると、キーの再利用は行なわれなく
           なり、 接続の度に、完全なshared keyの交換手続きが行なわれる。 つまり、クライアントも
           サーバも毎回秘密鍵を新しく生成するとみなす。 ただし、この方法はパフォーマンスに多大な
           影響があるので、 偏執狂的に高度な安全性を必要とする場合以外には勧められない。

       minkeylength
           これは、クライアントまたはサーバで許容される最小のキー長を指定する。 クライアントが
           サーバのレベルより小さい値を要求すると、 サーバはここで指定した最小値を返答する。 サー
           バがクライアントの最小値より下のレベルを返答すると、 クライアントは接続を終了する。

           デフォルトは0である。

       modulus
           このキーワードの値は、Diffie-Hellmanキー交換の剰余値を表す16進数の文字列である。 これ
           が何かわかる人で数学オタクの人以外はいじっちゃだめ。

           デフォルトの値は下記の1024ビットの素数である。

            f488fd584e49dbcd 20b49de49107366b 336c380d451d0f7c 88b31c7c5b2d8ef6
            f3c923c043f0a55b 188d8ebb558cb85d 38d334fd7c175743 a31d186cde33212c
            b52aff3ce1b12940 18118d7c84a70a72 d686c40319c80729 7aca950cd9969fab
            d00a509b0246d308 3d66a45d419f9c7c bd894b221926baab a25ec355e92f78c7

           これは Peter Gutman の CryptLib の中の testdh.h というファイルから とられた。 そこに
           は、この値が "generated by Colin Plumb for SKIP"だとコメントがある。 それから "these
           values were chosen as representative well-known public values to allay fears of
           possible trapdoors in self-generated values.  The generation method and actual values
           can be checked against the SKIP standards document." だとさ。

       privatekey
           デフォルトでは、Zebedeeはセッションごとに新しい秘密鍵を生成する。 しかし、もしあなたが
           毎回同じキーを使いたい場合は、 16進数の文字列としてこれを指定すればいい。 もし公開鍵暗
           号による認証(identitychecking)を使用したい場合は、 必ずこれを設定しなくてはいけない。
           キーが少くとも10桁は必要なことに注意すること。

       様々なキーワード(Miscellaneous Keywords)

       以下のキーワードはクライアントにもサーバにも等しく適用される。

       checkidfile
           これは、接続を許可する前にチェックするアイデンティティを複数記述したファイルの名称であ
           る。 これについてはidentity checkingで詳しく述べる。 このファイルはひとつしか指定でき
           ない。もし複数出現したら、 最後の値が使用される。

           もし、keylengthが0であることに (クライアントとサーバが)同意した場合は、アイデンティ
           ティのチェックは行なわれない。

       debug (コマンドラインでは -D)
           これはZebedeeが "debug" モードで動作するかを指定する真偽値である。 "debug" モードでは
           サーバは (multiuseモードのクライアント)は 一度に一つの接続しか受け付けない。 そし
           て、別プロセスや別スレッドを生成することなく "inline" で動作する。 これはデバッガ上で
           プログラムを動かす時に便利である。 デフォルトはfalseである。コマンドラインオプションの
           -D は これを true に設定するのと同じである。

           注:この設定は、UDPモードでは正しく動作しないので、試さないほうがいい。

       detached (コマンドラインでは -d)
           これはプロセスが制御端末から自分自身を切離してバックグラウントで (UNIX用語ではデーモン
           として)動作するかどうか指定する真偽値である。 これはクライアントでもサーバでも有効であ
           り、 デフォルトは true である。コマンドラインオプションの-dは これを false に設定する
           のと同じである。

           注:Windowsのコマンドプロンプトではこれがうまく動作しないこともあるようだ。 その徴候
           は、コンソールウインドウへの出力が止まり割込みのsignalが無視されるが、 コンソールのプ
           ロンプトがZebedeeが終了するまで表示されないことだ。 これを回避するには、以下のように
           "start" コマンドを使用すればよい。

            DOS> start zebedee -f server.zbd

           これはZebedeeを新しいコンソールセッションで起動し、そこから切り離す。 切り離す前に一瞬
           だけチラリとそのコンソールが見えるが、それが消えても Zebedeeはバックグラウンドで動作し
           ている。

       include
           これは別の設定ファイルの名前を指定する。 そのファイルはこのファイルの残りを処理する
           前、 この時点で処理される。 例えば、秘密鍵をもっときっちりガードしたファイルに分離して
           保存した場合に、 そのファイルを取り込むために使用される。 includeは5レベルの深さまでに
           限定される(最初のファイルをレベル1として)。 これはうっかり無限ループを作らないためであ
           る。

       maxbufsize
           これは、 Zebedee がアプリケーションからデータを読むために使用するバッファの長さ(バイト
           単位)を指定する。 実際に使用されるバッファの長さはサーバの値とクライアントの値の最小値
           になる。

           デフォルトでは、Zebedeeはトンネルの両端で サーバプログラム、クライアントプログラムか
           ら8192バイト単位で読み出す。 例えば、すごく対話的なアプリケーションがあって、 大きな
           データ転送を待つためにひどいレスポンスだったりした時など、 これを小さくしたいこともあ
           るだろう。 バッファサイズは1バイトまで縮めることができるが、 おかしな動きをデバッグし
           ようとしているのか時間を無駄にしたいのでなければ、 これはお勧めできない。 逆に、大量の
           データの転送があって、 圧縮をめいっぱい効かせたい場合は、16383バイトまで大きくしてもよ
           い。 注:maxbufsizeZebedee が使用するメモリ量には関係ない。 一度に読みこむデータの
           かたまりのサイズだけに影響する。

           UDPモードでは、バッファサイズは扱えるデータグラムの最大長にも影響する。 現在のバッファ
           サイズより大きなデータグラムは分断され、 それを受信するアプリケーションが落ちることに
           なりがちだ。 16383バイト以上のデータグラムは扱うことができない。

       message
           verbosity level が1ならば、設定ファイルのこの部分を処理した時に、 このメッセージがログ
           に記録される。

       name (コマンドラインでは -n)
           これは、実行ファイルのファイル名の代わりに、 メッセージの中で使われるプログラム名称に
           なる。 Windows環境では、インストールあるいは削除されるサービスの名前としても用いられ
           る。

       logfile (command-line -o)
           これはメッセージが出力されるファイルの名前である。 もし省略されるとメッセージは標準エ
           ラーに出力される。

           2つの特殊なファイル名も正しい名前として認識される。 もし、名称がNULLだと、全てのメッ
           セージ出力は止められる。 SYSLOGだと、メッセージはホストのシステムログに出力される。
           Windowsシステムでは、アプリケーションイベントログを意味する。 他のシステムでは、メッ
           セージはsyslog サービスに出力される。

       serverport
           これは、Zebedee サーバが接続を待ち受けるポートである。 デフォルトはTCPモードでは11965
           (0x2EBD)、UDPモードでは11230(0x2BDE)である。 サーバでこれを指定すると、サーバはこの
           ポートでlistenする。 クライアントでこれを指定すると、クライアントは サーバのこの番号の
           ポートに接続することになる。

       timestamplog (コマンドラインでは -t)
           これは、ログメッセージにタイムスタンプを含めるかどうかを示す真偽値である。 コマンドラ
           インオプションの -t はこれをtrueに設定するのと同じである。

       udpmode (コマンドラインでは -u)
           デフォルトではZebedeeは、コネクションベースのTCP/IPの通信を扱う。 もし、このキーワード
           が指定されると、かわりにコネクションレスのUDP/IPの通信を扱う。

           この場合でも、Zebedeeのクライアントとサーバ間のトンネルはTCP/IP接続を使用する。 UDPの
           宛先ごとに別々の接続が使用される。 UDPはコネクションレスなので、通信が完了したことを簡
           単に知ることはできない。 この理由で、Zebedeeの接続は一定の時間通信が無い場合にタイムア
           ウトする必要がある。 この時間はudptimeoutの値で制御される。

           すでにタイムアウトしてしまったトンネルに向けたデータが到着した場合、 接続を再確立する
           必要がある。 このために、アプリケーションの特性によっては、 UDPモードのパフォーマンス
           がよくないように見えることもある。 keylifetimeの値を変更して、 接続のセットアップの時
           間を最小にすれば、パフォーマンスを向上させることができる。 udptimeout の値を変更するこ
           とも同様に役に立つ。

           コマンドラインオプションの-uは、この値をtrueに設定するのと同じである。

       udptimeout
           デフォルトでは、UDPモードのトンネルは、300秒通信が無いと閉じられる。 このキーワードで
           その時間を変更できる(単位は秒)。 この値は65535より大きくなってはいけない。 これを0にす
           ると一切通信が行なわれない(そういう設定もできるけど…)。

       verbosity (コマンドラインでは -v)
           これは、ログするメッセージのレベルを示す整数値である。 0だとエラーメッセージだけ、 5に
           するとメッセージトラフィックの非常に細かいディテールまで含める。 デフォルトは1であ
           り、通常はそれが最も使いやすい。

           メッセージは stderr に出力される(コマンドラインオプションの-ologfile キーワードでリ
           ダイレクトされない限り) 一般的なメッセージはこんな感じである:

            zebedee(54/119):  Listening on local port 1172

           カッコの中の数字はメッセージを出力したプロセスとスレッドのIDを表している。 全てのエ
           ラーメッセージはレベル0でもログが取られ、 以下の様に、先頭が "ERROR" という単語から始
           まる。

            zebedee(54/119): ERROR: failed to connect to localhost:11965

           メッセージはログが取られたレベルに従ってインデントされる。

       その他のオプション(Other Options)

       設定ファイルに対応するものを持たないコマンドオプション がいくつかあるので、それについてこ
       こで説明する。

       -p  このオプションで Zebedee は秘密鍵の値を標準出力に出力する。 この出力は設定ファイルでそ
           のまま使用できる形式である。 例えば、

            privatekey "c480bd48f707c69dec54c9e7b6e22dd04cac659e"

           の様な形である。

       -P  このオプションで Zebedee はidentity checking で 使用できるパブリックアイデンティティを
           生成する。結果は標準出力に書かれる。 例えば、

            ef8153a0e392df005f67321ca2f0ace5bb8c5a1f myhostname

           の様な形である。

           このオプションは秘密鍵を含む設定と共に指定するか、 -p と共に用いて秘密鍵と公開鍵を両方
           同時に生成しなくてはいけない。

       -h  このオプションは以降の引数をファイル名とみなす。 そして、それぞれのファイルは8192バイ
           トのかたまりとして読みこまれ、 SHAハッシュが計算される。 引数がない場合や引数が""-""で
           あった場合は標準入力のハッシュが計算される。 例えば、

            $ zebedee -h /etc/passwd
            bb1e734aeffd2111417761f5938dea3b53759598 /etc/passwd
            $ zebedee -h < /etc/passwd
            bb1e734aeffd2111417761f5938dea3b53759598 -

           の様な形である。

       -H  こちらは-hと似ているが、引数が文字列として扱われ、 その文字列のSHAハッシュが計算され表
           示される。

            $ zebedee -H hello world
            ac62a630ca850b4ea07eda664eaecf9480843152 hello
            86bf25ecb8a40b40b885c097c683b6e236fc8085 world

       -S (Windows only)
           Windowsシステムでは Zebedee を サービス(ブート時に自動的に起動され独立して動くプロセ
           ス)として インストールすることもできる。

           Zebedeeinstallパラメータと設定ファイルの名前を指定することで サービスとしてインス
           トールされる。例えば、

            zebedee -Sinstall=c:\zebedee\service.zbd

           の様な形である。

           常に、設定ファイルのフルパスを指定しなければならない。 このファイルはスタートアップ時
           に読みこまれ、 サービスが動作するために必要なパラメータを全て含んでいなければならな
           い。

           デフォルトでは、 インストールされるサービスの名前はプログラムファイルの名前から取られ
           る。 従って通常はZebedeeになる。 しかし、-nオプションを使用して変更することもできる。

            zebedee -n "Zebedee Client Service" -Sinstall=c:\zebedee\clientsvc.zbd

           一旦、サービスがインストールされると、次のシステム再起動から自動的に起動される。 もし
           くは(Windows NTの場合)サービスコントロールパネルで手動起動することもできる。

           サービスを削除するにはまずサービスを終了してから、-Sオプションと remove パラメータを使
           う。 そして、もし必要ならば-nオプションでサービスの名称を指定する。 例えば、

            zebedee -n "Zebedee Client Service" -Sremove

           の様な形である。

           -Sのパラメータは他に run がある。これは内部で Zebedee の サービススタートアップコード
           を起動するために使うもので、 ユーザが直接使用してはならない。

       -x  コマンドラインで指定できない設定ファイルのパラメータを 指定するために、このオプション
           を使用することもできる。 これに文字列の引数をつけると、 それがあたかも設定ファイル
           の1行であるかのように処理される。 コメントは認識されるが、"\"の継続行は使用できない。
           例えば、

            zebedee -x " server true # It's a server!"

           というまわりくどいやりかたでも次のコマンド

            zebedee -s

           と同じ効果を得ることができる。

   Identity Checking
       Zebedee はデフォルトでは、2点間に暗号化チャネルを生成するに過ぎない。 ご承知の通り、データ
       は "on the wire (通信線上)" での盗聴からは守られるが、 あなたが想定している相手に接続され
       ているか否かは保証されない。 これは、"man-in-the-middle (第三者による横取り)" アタックに対
       しては無防備である。 もし、あなたがデータの圧縮と、盗聴から守ることを第一に心配しているな
       ら、 あなたはこの条件に満足するだろう。 しかし、あなたの通信が第三者に横取りされていないこ
       とに対する保証を求めるなら、 Zebedee はそれを行うための便宜を提供する。

       もし、同一の素数と原始根と秘密鍵が用いられるなら、それらは Diffie-Hellman の鍵交換プロトコ
       ルのために、常に同じ公開鍵を生成するだろう。 もし、あなたが(設定ファイルのprivatekeyキー
       ワードにて設定された) 固定された秘密鍵を用いるなら、 Zebedee は素数と原始根と秘密鍵の値の
       全てをハッシュして "fingerprint (指紋)" を生成することができる。 これは、-P オプションによ
       り行われる。 例えば、server.key ファイルが次の値

        privatekey "1e34d6769502bae1087c18d2e8c8776e4a17ddaf"

       であるとき、

       次のコマンド

        $ zebedee -P -f server.key > server.id

       を実行すると、

       このような出力

        135f04050961d37553731250d5c6f7495f088b32 myhostname

       が得られる。

       この最初の16進数が "fingerprint (指紋)" である。 行中の他の文字列は、このアイデンティティ
       の所有者を表すコメントである。 デフォルトでは、これはアイデンティティが生成されたマシンの
       ホスト名である。

       設定ファイルにおいて checkidfile キーワードが設定された場合、その値は "fingerprint (指紋)"
       行を記述したファイルのファイル名である。 もし、接続 先のアイデンティティがファイル中のいか
       なる値とも一致しない場合、 接続は切断される。

   その他のセキュリティ関連の注記(Notes on Other Security Issues)
       Message Integrity
           プロトコルのオーバーヘッドを可能な限り小さくするために、 Zebedee は伝送されたデータの
           正しさに対する確認は何も行っていない。 そのため、アタッカーは途中でデータパケットを改
           変することができる。 しかし、暗号の使用はデータを任意に変換することを極めて困難にして
           いるのではないか (例えば、""ls -l""を""rm -f""に書き換えられるかい?) 。 しか
           し、Zebedee はランダムなデータが送られたことによる影響から アプリケーションを守ること
           は行わない。

       Replay and Insertion Attacks
           多くのネットワークシステムにおいて有り得る攻撃の一つは データのキャプチャリングであ
           り、良く知られた効果を及ぼす (例えば、管理者の telnet セッションにはある種の"危険な"操
           作が伴い、 その操作を後に繰り返されたらどうなるか)。 これを行うには、暗号化されたデー
           タストリームを改変する必要は無いが、 サーバに送られた同じネットワークパケットは、同じ
           レスポンスを引き出すだろう。

           Zebedee が "anonymous" モードで動作しているとき、 セッション毎に異なる鍵が生成されるた
           め、 このようなアタックが成功する危険は非常に小さい。 しかし、identity checkingの機能
           が使われているときには 鍵は固定されているので、再生は実際に可能性がある。
           Zebedeeは、一つ一つの接続毎にユニークなセッションキーを生成することで、 この問題に対処
           している。 この方法では、接続のセットアップの最後に、チャレンジ-レスポンスの交換が行な
           われ、 相手側のシステムがshared secret keyを保持しており、 以前に記録されたデータをオ
           ウム返ししているわけではないことが、 確認される。

           加えて、Zebedee は Blowfish 暗号法を "cipher feedback" モードで用いており、 データのあ
           らゆる部分の複号は、 それ以前の全てのデータパケットの複号が成功しているかどうかに依存
           する。 チャレンジ・レスポンスはデータストリームの "salts" を交換するので、 トンネル化
           されたプロトコルに "known plain-text" アタック(辞書攻撃)を加えるのは より困難になる。

       Key Generation
           良くない鍵の使用は、最強の暗号化メカニズムをも汚すことができる。 鍵を生成すると
           き、Zebedee は可能な限り推測が困難なデータをかき集めて、 それを SHA ハッシュアルゴリズ
           ムにより "ステア (かき混ぜる)" する。

           Windowsの場合、アタッカーが既にシステムにアクセスしていれば、 取得可能なあらゆるデータ
           は予測することができる。 しかし既に言及したように、 ほとんどの用途においてこれは許容で
           きるだろう。 興味があるならば、プログラム中のコメントに詳細が説明されているので、 参照
           されたい。

           もし、鍵の生成メカニズムに不満があるなら、 設定ファイル中のkeygencommand オプションを
           用いて、 外部の鍵生成プログラムを呼べば良い。 組み込まれている性能を改善する提案は大歓
           迎だ!

トラブルシューティング(TROUBLESHOOTING)

       Zebedee は「箱から出してすぐそのまま」動くべきだが、あなたはトラブル にあうかもしれな
       い。ほとんどのトラブルは接続の確立時に起こる (接続さえうまくいけば、データ転送はスムーズに
       いくことが多い)。 (接続の)セットアップの手順に何が起こっているか簡単に見るには-vオプション
       を 使えばよい。-d -D もいっしょに使って、Zebedeeを端末から終了でき るようにして、一度に一
       つの接続しか処理しないようにしたほうがい いかもしれない。だから、こんな感じになるだろう。

        zebedee -dD -v 3 -s

       ロギングレベルを3に設定することで、 接続のセットアップの主なやりとりを見ることができる。
       問題がその後に起きてると確信が持てるならば、 レベルを4か5にすれば、 (接続時だけでなく)実際
       の通信で何がやりとりされているかも見ることができる。

EXAMPLES

       Zebedee のパッケージには、たくさんのサンプルの設定ファイルが含まれている。 ここでは、それ
       らの使用法と Zebedee を 特定のいくつかのプロトコルで使用する具体的な方法を述べる。

   サーバ設定の例(Example Server Configuration)
       Zebedeeのパッケージに含まれる server.zbd という設定ファイルがある。 これにはよく使われるほ
       とんどのオプションの設定例がある。

        #
        # Sample Zebedee server configuration file
        #
        # This shows the use of many, but not all, of the configuration file
        # options available for use by a server.
        #

        verbosity 2            # Slightly more than basic messages

        server true            # Yes, it's a server!
        detached true          # Run detached from terminal
        udpmode false          # Are we operating in UDP mode?

        # Uncomment the following line to log messages to a file
        #
        #  logfile './server.log'
        #
        # Or to log to the system logging facility uncomment this:
        #
        #  logfile SYSLOG

        # Uncomment the following line if you want to use a fixed private
        # key stored in a static file. The file should contain a line of
        # the form "privatekey hexadecimal-key-string"
        #
        #  include './server.key'

        keygenlevel 2          # Generate maximum strength private keys

        # To validate the identity of clients uncomment the following
        # line:
        #
        #  checkidfile './clients.id'

        # Set up allowed redirection ports.
        # These should be pretty safe -- but it's not a good idea
        # to open up all ports.

        redirect "telnet ftp"          # Basic services
        redirect 5900-5999             # VNC traffic
        redirect 6000-6010             # X Window System
        redirect "daytime chargen"     # Ports useful for testing

        targethost localhost           # Redirection is to the local machine

        compression zlib:9             # Allow maximum zlib compression
        keylength 256                  # Allow keys up to 256 bits
        keylifetime 36000              # Shared keys last 10 hours
        maxbufsize 16383               # Allow maximum possible buffer size

       認証の機能をテストするためには、 checkidfileの行をコメントアウトし、 パッケージに含まれ
       るclient1.keyclient2.keyというファイルをクライアント側で使用すればよい。

   VNCの使用例(Use with VNC)
       Zebedeeを作った理由の一つとして、ダイアルアップでVNCを使うということがある。 VNCは「リモー
       トフレームバッファコンセプト」を使い、 リモートディスプレイを提供するフリーのシステムであ
       る。 Windowsのデスクトップを離れた所に表示することもできるし、 "Xvnc"サーバを使って X のデ
       スクトップを VNCクライアントマシンから操作することもできるし、 Javaを使えるブラウザーの中
       から操作することもできる。 詳しくはhttp://www.uk.research.att.com/vnc/を参照のこと。

       提供されるサーバの設定例であるserver.zbd は 5900-5999 ポートを リダイレクトしてVNCセッショ
       ンをトンネリングする。 このファイルはUNIXでもWindowsでも使用できるが、 Windowsで使うために
       は、レジストリの"AllowLoopback"フラグを セットする必要があるので注意。 以下の断片を(先頭の
       スペースを取り除いてから)ファイルに保存して regedit に読ませれば、そのトリックを実行する。

        REGEDIT4

        [HKEY_LOCAL_MACHINE\SOFTWARE\ORL\WinVNC3]
        "AllowLoopback"=dword:00000001

        [HKEY_LOCAL_MACHINE\SOFTWARE\ORL\WinVNC3\Default]

       この内容は Zebedee パッケージの中の vncloopback.reg にも含まれている。 このレジストリを設
       定すれば、コマンドラインで与えられたホストにトンネリングされたVNC ビューワを vncviewer.zbd
       で起動することができる。 デフォルトでは、サーバの(WinVNCのデフォルトである)5900ポートにト
       ンネルするが、 コマンドラインで指定して上書きすることもできる。 以下に vncviewer.zbd の内
       容を示す。

        #
        # Zebedee configuration file to start up a tunnelled VNC session
        #
        # Usage: zebedee -f vncviewer.zbd remote-host[:vnc-port]
        #

        verbosity 1         # Basic messages only

        server false        # It's a client
        detached true       # Detach from terminal

        message "Starting VNC viewer on localhost:99"

        # On Windows systems you might use the following:

        command '"c:\Program Files\ORL\VNC\vncviewer.exe" localhost:99'

        # On UNIX systems you might use the following:

        # command 'vncviewer localhost:99'

        targetport 5900     # Remote VNC server on port 5900 unless overridden
                            # by a value specified on the command-line

        clientport 5999     # Local connection on 5999 -- i.e. localhost:99

        compression 6       # Request normal Zlib compression

       以下のようにこのファイルを使用すると、

        zebedee -f vncviewer.zbd somehost:5901

       somehostの5901番ポートのVNCサーバにトンネルしたVNCビューワを起動する。 ビューワはローカル
       ホストの5999番ポートに接続する。

       VNCはJavaのビューワもサポートしている。 もしサーバがポート59xxで動作していたら、 ビューワ
       を58xxからダウンロードすることができる。 しかしながら、 どうもJavaビューワはクライアントへ
       のメインのVNCポート番号で通信しているようだ。 そのため、Javaビューワでこれをトンネルするに
       は、 ローカルとリモートで同じポート番号を使う必要がある。 そのため、例えば、5901番のポート
       を使っているVNCサーバへのトラフィックを トンネルするには、次のようにする。

        zebedee 5801,5901:remotehost:5801,5901

       もしローカルマシンでも5901番ポートを使ったVNCサーバが動いていると、 これはうまくいかない。
       しかし、ポートが衝突しないように両者を調整することは可能である。

       もうひとつだけ言っておくことがある。 VNCをデータ圧縮とともに使おうとしているなら、
       VNCのprotocol encodingに関して実験したほうがよい。 私は、"raw" encoding が圧縮の効果が高
       く、 遅い回線上ではよりよいパフォーマンスを示すことを発見した。 しかし、あなたの場合は違う
       結果となるかもしれない。

   X Window Systemの使用例(Use with the X Window System)
       X Window Systemは6000番以上のポートを使う。

       xlocal というローカルマシンのポート6000でX サーバが動作しているとする。 これは通
       常、xlocal:0 というディスプレイで使われているポートである。 そして、xremoteという(リモー
       ト)マシンから、 ローカルのディスプレイに安全な xterm のセッションを送り返したいものとす
       る。 これを行なうには、以下のコマンドを xlocal で実行する。

        zebedee -r 6000 -s

       そして、xremote では

        zebedee 6001:xlocal:6000

       を実行する。

       このことは、xremote上で、環境変数のDISPLAYが"localhost:1"に設定されていれば、 Xのトラ
       フィックはxlocalに到着することを意味する。 そのため、例えばxtermを安全にxremoteから送ろう
       とするなら、 xremote上で次のコマンドを実行する必要がある。

        xterm -display localhost:1

       これが正しく動作するためには、 xremoteのXサーバのアクセスコントロールリストにlocalhostのエ
       ントリーを 追加しなくてはならない。 これを行うには次のコマンドを実行する。

        xhost +localhost

   HTTPの通信を安全にする(Securing HTTP traffic)
       Zebedeeクライアントを"multi-use"モードで動作させることで、 全てのWebサーバへの通信を安全に
       することができる。 もし、Webサーバが webhost のポート80で動作しており、 そのサーバマシンで
       Zebedee サーバも動作しているとしたら、 次のコマンドがローカルマシンの8000番ポート経由のト
       ンネルを設定する。

        zebedee 8000:webhost:80

       will set up a tunnel via port 8000 on the client host. Now any URLs that previously were
       addressed via webhost, for example:

        http://webhost/private/index.html

       は、この状態では次のURLで安全にアクセスできる。

        http://localhost:8000/private/index.html

       ""localhost:8000""をあなたのプロキシーとして設定することで、 全てのHTTPのトラフィックを安
       全なトンネル経由にすることもできる。 しかし、注意すべきことは、HTTPのプロキシー設定以外に
       この設定をしてはいけない。 Secure HTTPを含む他のプロトコルは他の方法でリダイレクトする必要
       がある。 ほとんどのブラウザは違うドメインに違うプロキシーを割りあてる設定も可能である。 そ
       のため、必要なものだけ選んでガードすることもできる。 これを行なう方法についてはブラウザの
       マニュアルを参照されたし。

   FTPの通信を安全にする(Securing FTP traffic)
       以下の手段で、 Zebedeeを使い多くのFTPサーバへのFTPコントロールコネクション (ユーザ名とパス
       ワードが送られるコネクション)を守ることができる。 さらに、Zebedeeパッケージに含まれる
       ftpgw.tcl スクリプトによって、 パッシブモードのデータコネクションさえも守ることができる。

       FTPサーバを扱う最も単純な方法は、以下のように Zebedee を起動することだ。

        zebedee -s -r ftp ftpserverhost

       FTPサーバと同じマシンで Zebedee を動作させていても、コマンドラインで 明示的にホスト名を指
       定する必要がある(または redirecthostキーワードを使用)。それを localhostとして参照してはい
       けない。クライアントシステムでは Zebedeeを次のように起動して、ポート10000番経由のマルチ
       ユーストンネル を構築する。

        zebedee 10000:ftpserverhost:ftp

       FTPサーバに接続するには、次のようなコマンドを使用する。

        ftp clienthost 10000

       くどいようだが、localhost でなくローカルクライアントのホスト名を使うこと。 もし、windowsの
       標準FTPクライアントのように、 あなたのFTPクライアントがコマンドラインでポートを指定できな
       い時は、 プログラムの中で(FTPセッションの中で) ""open clienthost 10000"" というコマンドを
       使うことができる。 もし、クライアントマシンでFTPサーバが立ち上がっていなければ、 Zebedee
       をこのように起動してもよい。

        zebedee ftp:ftpserverhost:ftp

       これだとFTPクライアントプログラムは次のように起動できる。

        ftp clienthost

       FTPのコントロールコネクションとデータコネクションが同じ所から来ているか どうかチェックす
       るFTPサーバがあるが、そういうサーバに対しては上記の手法は うまくいかない。wu-ftpd のような
       メジャーなFTPサーバはこの点に ついて厳しくチェックを入れる(セキュリティ面からは望ましいこ
       とだが…)。 もし、サーバへの接続は明らかにうまくいくのに、 ファイルのリストや読み出しで失敗
       したりハングアップするなら、 そのサーバがここを厳しくチェックするタイプだった、ということ
       だ。

       この問題を克服するのを助けるために、ftpgw.tcl というFTPゲートウェイの スクリプトが Zebedee
       パッケージには含まれている。 このプログラムはフリーに入手可能であるTclスクリプティング言語
       (http://www.scriptics.com参照)で書かれていて、 FTPのリクエストを中継して再送信し、サーバか
       らZebedee の存在を隠す。 これは Zebedee サーバと同じマシンで走らせる必要がある。 FTPサーバ
       も同じマシンで動いているなら、単にこう起動すればよい。

        tclsh ftpgw.tcl

       これでゲートウェイはポート2121で待ち受ける。明らかに、実際の使用ではこれ をバックグラウン
       ドで起動したいだろう。それから、Zebedeeサーバを

        zebedee -s -r 2121

       として起動する。

       このケースではローカルホスト名を指定する必要はない (したければしてもかまわないが)。 クライ
       アント側ではこうする。

        zebedee 2121:ftpserverhost:2121

       それからこうする。

        ftp clienthost 2121

       こちらでは、この場合でもクライアントホスト名を使う。

       この設定では、FTPのコントロールコネクションはトンネルされるが、 データコネクションには一切
       影響を与えない。 もし、あなたのFTPクライアントがパッシブモードをサポートしていれば、
       ftpgw.tcl でデータチャンネルも安全にすることができる。 Netscape Navigator や Windows用
       のWS_FTPなどはそれをサポートしている。

       パッシブモードのデータコネクションを安全にするためには、 まずデータコネクションに使うポー
       ト番号の範囲を選ばなくてはいけない。 この例では。30000から30100番を使うものとする。 ま
       ず、ftpgw.tcl を 起動する時に、このポート範囲を指定するために、 -pオプションを使用する。

        tclsh ftpgw.tcl -p 30000-30100

       Zebedeeサーバはこのように起動する。

        zebedee -s -r 2121,30000-30100

       クライアントはこうだ。

        zebedee 2121,30000-30100:ftpserverhost:2121,30000-30100

       Netscapeを使ってコントロールコネクションとデータコネクションを 両方安全にアクセスするに
       は、このようなURLを入力する。

        ftp://username@clienthost:2121/

       ここでusernameはFTPサーバでのユーザ名である。

CREDITS AND LEGALITIES

       The following information can also be found in the file LICENCE.txt in the Zebedee
       distribution.

        Copyright (c) 1999, 2000 by Neil Winton. All Rights Reserved.

        This program is free software; you can redistribute it and/or modify
        it under the terms of the GNU General Public License as published by
        the Free Software Foundation; either version 2 of the License, or
        (at your option) any later version.

        This program is distributed in the hope that it will be useful,
        but WITHOUT ANY WARRANTY; without even the implied warranty of
        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        GNU General Public License for more details.

        You should have received a copy of the GNU General Public License
        along with this program; if not, write to the Free Software
        Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,
        USA.

       A copy of the GNU General Public License can be found in the file GPL2.txt.

       You may obtain the latest copy of Zebedee, including full source code from
       http://www.winton.org.uk/zebedee/ and other enquiries about Zebedee can be e-mailed to the
       author at zebedee@winton.org.uk

       Zebedee would not have been possible without the use of a large amount of freely-available
       software to do all the really hard stuff. I gratefully acknowledge the contributions made
       by the authors of the following software packages.

       Zebedee uses the "Blowfish" encryption algorithm devised by Bruce Schneier.  For more
       information on Blowfish see http://www.counterpane.com/blowfish.html .  The implementation
       used is by Eric Young and is covered by the following copyright:

        Copyright (C) 1995-1997 Eric Young (eay@mincom.oz.au)
        All rights reserved.

        This package is an Blowfish implementation written
        by Eric Young (eay@mincom.oz.au).

        This library is free for commercial and non-commercial use as long as
        the following conditions are aheared to.  The following conditions
        apply to all code found in this distribution.

        Copyright remains Eric Young's, and as such any Copyright notices in
        the code are not to be removed.

        Redistribution and use in source and binary forms, with or without
        modification, are permitted provided that the following conditions
        are met:
        1. Redistributions of source code must retain the copyright
        notice, this list of conditions and the following disclaimer.
        2. Redistributions in binary form must reproduce the above copyright
        notice, this list of conditions and the following disclaimer in the
        documentation and/or other materials provided with the distribution.
        3. All advertising materials mentioning features or use of this software
        must display the following acknowledgement:
        This product includes software developed by Eric Young (eay@mincom.oz.au)

        THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
        ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
        ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
        OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
        HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
        LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
        OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
        SUCH DAMAGE.

        The license and distribution terms for any publically available version or
        derivative of this code cannot be changed.  i.e. this code cannot simply be
        copied and put under another distrubution license
        [including the GNU Public License.]

        The reason behind this being stated in this direct manner is past
        experience in code simply being copied and the attribution removed
        from it and then being distributed as part of other packages. This
        implementation was a non-trivial and unpaid effort.

       Zebedee uses the zlib compression library by Jean-loup Gailly and Mark Adler. It is
       covered by the following copyright notice:

        (C) 1995-1998 Jean-loup Gailly and Mark Adler

        This software is provided 'as-is', without any express or implied
        warranty.  In no event will the authors be held liable for any damages
        arising from the use of this software.

        Permission is granted to anyone to use this software for any purpose,
        including commercial applications, and to alter it and redistribute it
        freely, subject to the following restrictions:

        1. The origin of this software must not be misrepresented; you must not
        claim that you wrote the original software. If you use this software
        in a product, an acknowledgment in the product documentation would be
        appreciated but is not required.
        2. Altered source versions must be plainly marked as such, and must not be
        misrepresented as being the original software.
        3. This notice may not be removed or altered from any source distribution.

        Jean-loup Gailly        Mark Adler
        jloup@gzip.org          madler@alumni.caltech.edu

       Zebedee may use the bzip2 compression library by Julian Seward which is covered by the
       following licence:

        This program, "bzip2" and associated library "libbzip2", are
        copyright (C) 1996-1999 Julian R Seward.  All rights reserved.

        Redistribution and use in source and binary forms, with or without
        modification, are permitted provided that the following conditions
        are met:

        1. Redistributions of source code must retain the above copyright
           notice, this list of conditions and the following disclaimer.

        2. The origin of this software must not be misrepresented; you must
           not claim that you wrote the original software.  If you use this
           software in a product, an acknowledgment in the product
           documentation would be appreciated but is not required.

        3. Altered source versions must be plainly marked as such, and must
           not be misrepresented as being the original software.

        4. The name of the author may not be used to endorse or promote
           products derived from this software without specific prior written
           permission.

        THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
        OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
        WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
        ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
        DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
        GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
        INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
        WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
        NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
        SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

        Julian Seward, Cambridge, UK.
        jseward@acm.org
        bzip2/libbzip2 version 0.9.5 of 24 May 1999

       By default Zebedee is built using an aribtrary precision integer arithmetic library
       derived from the sources to "mirrordir-0.10.49" which in turn derived this from the Python
       sources. The copyright is as follows:

        huge-number.c: arbitrary precision integer library from Python sources
        This has nothing to do with cryptography.
        Copyright (C) 1998 Paul Sheer

        This program is free software; you can redistribute it and/or modify
        it under the terms of the GNU General Public License as published by
        the Free Software Foundation; either version 2 of the License, or
        (at your option) any later version.

        This program is distributed in the hope that it will be useful,
        but WITHOUT ANY WARRANTY; without even the implied warranty of
        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        GNU General Public License for more details.

        You should have received a copy of the GNU General Public License
        along with this program; if not, write to the Free Software
        Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

        This file was taken from the Python source for `long' type
        integers. I have changed it to compile independently of the
        Python source, and added the optimisation that GNU C can
        use 31 bit digits instead of Python's 15 bit. You can download
        the original from www.python.org. This file bears little
        resemblance to the original though - paul

        Copyright 1991-1995 by Stichting Mathematisch Centrum, Amsterdam,
        The Netherlands.

                                All Rights Reserved

        Permission to use, copy, modify, and distribute this software and its
        documentation for any purpose and without fee is hereby granted,
        provided that the above copyright notice appear in all copies and that
        both that copyright notice and this permission notice appear in
        supporting documentation, and that the names of Stichting Mathematisch
        Centrum or CWI or Corporation for National Research Initiatives or
        CNRI not be used in advertising or publicity pertaining to
        distribution of the software without specific, written prior
        permission.

        While CWI is the initial source for this software, a modified version
        is made available by the Corporation for National Research Initiatives
        (CNRI) at the Internet address ftp://ftp.python.org.

        STICHTING MATHEMATISCH CENTRUM AND CNRI DISCLAIM ALL WARRANTIES WITH
        REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
        MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH
        CENTRUM OR CNRI BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL
        DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
        PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
        TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
        PERFORMANCE OF THIS SOFTWARE.

       Zebedee uses the Secure Hash Algorith (SHA) the code for which was derived from Uwe
       Hollerbach's SHA module for perl. The code contains the following statement:

        NIST Secure Hash Algorithm
        heavily modified by Uwe Hollerbach <uh@alumni.caltech edu>
        from Peter C. Gutmann's implementation as found in
        Applied Cryptography by Bruce Schneier

        This code is in the public domain

       Under Windows, Zebedee uses an implementation of the getopt function covered by the
       following copyright:

        Copyright (c) 1987, 1993, 1994
               The Regents of the University of California.  All rights reserved.

        Redistribution and use in source and binary forms, with or without
        modification, are permitted provided that the following conditions
        are met:
        1. Redistributions of source code must retain the above copyright
        notice, this list of conditions and the following disclaimer.
        2. Redistributions in binary form must reproduce the above copyright
        notice, this list of conditions and the following disclaimer in the
        documentation and/or other materials provided with the distribution.
        3. All advertising materials mentioning features or use of this software
        must display the following acknowledgement:
               This product includes software developed by the University of
               California, Berkeley and its contributors.
        4. Neither the name of the University nor the names of its contributors
        may be used to endorse or promote products derived from this software
        without specific prior written permission.

        THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
        ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
        ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
        OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
        HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
        LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
        OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
        SUCH DAMAGE.

   Thanks
       Special thanks go to those people who have taken the trouble to give me feedback and
       suggestions for improvement!

        $Id: zebedee.pod,v 1.1 2000/07/18 02:05:04 tnaka Exp $