218c6b4b9b
which has some variation of writing in Japanese, as well as some typos. Submitted by: kano@na.rim.or.jp Approved by: kuriyama (mentor/implicitly)
199 lines
5.2 KiB
Groff
199 lines
5.2 KiB
Groff
.\"
|
|
.\" %FreeBSD: src/usr.sbin/ntp/doc/ntp-genkeys.8,v 1.5 2003/06/17 09:51:17 sobomax Exp %
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.Dd August 2, 2001
|
|
.\"
|
|
.\" WORD: private key 秘密鍵
|
|
.\" WORD: public key 公開鍵
|
|
.\" WORD: generator 原始根(Diffie-Hellman 鍵交換アルゴリズムの)
|
|
.\" WORD: prime modulus 素数係数(Diffie-Hellman 鍵交換アルゴリズムの)
|
|
.\"
|
|
.Dt NTP_GENKEYS 8
|
|
.Os
|
|
.Sh 名称
|
|
.Nm ntp-genkeys
|
|
.Nd 公開鍵、秘密鍵を生成する
|
|
.Sh 書式
|
|
.Nm
|
|
.Op Fl dfhlnt
|
|
.Op Fl c Ar conffile
|
|
.Op Fl g Ar target
|
|
.Op Fl k Ar keyfile
|
|
.Sh 解説
|
|
.Nm
|
|
ユーティリティは NTPv3/NTPv4 の対称鍵暗号化認証スキーム、または NTPv4
|
|
の公開鍵 (Autokey) 暗号化認証スキームで用いられるランダム鍵を
|
|
生成します。
|
|
.Pp
|
|
以下のオプションが利用可能です。
|
|
.Bl -tag -width indent
|
|
.It Fl c Ar conffile
|
|
.Xr ntp.conf 5
|
|
ファイルの位置を指定します。
|
|
.It Fl d
|
|
デバッグメッセージ出力を有効にします (複数回指定可能です)。
|
|
.It Fl f
|
|
生成した鍵を強制的にインストールします。
|
|
.It Fl g target
|
|
文字列
|
|
.Ar target
|
|
の文字で指定されたファイルを生成します。
|
|
.Bl -tag -width X
|
|
.It Li d
|
|
D-H パラメータファイルを生成します。
|
|
.It Li m
|
|
MD5 鍵ファイルを生成します。
|
|
.It Li r
|
|
RSA 鍵を生成します。
|
|
.El
|
|
.It Fl h
|
|
鍵をその場所 (現在のディレクトリ) に作成します。
|
|
これは、オプション
|
|
.Fl l
|
|
を暗黙的に含みます。
|
|
.It Fl k Ar keyfile
|
|
鍵ファイルの場所を指定します。
|
|
.It Fl l
|
|
シンボリックリンクを作りません。
|
|
.It Fl n
|
|
実際には何もしません。
|
|
何をしようとするかだけを出力します。
|
|
.It Fl t
|
|
シンボリックリンクの先の (古い) ファイルを抹消します。
|
|
.El
|
|
.Pp
|
|
デフォルトでは、このプログラムは、16 個のランダム対称鍵を含むファイル
|
|
.Xr ntp.keys 5
|
|
を生成します。
|
|
加えて、ソフトウェアビルドの際に rsaref20 パッケージが組み込まれている
|
|
場合、このプログラムは、Autokey スキームで使用する暗号値を生成します。
|
|
これらの値は次の 3 個のファイルになります。
|
|
.Pa ntpkey
|
|
は、RSA 秘密鍵を含みます。
|
|
.Pa ntpkey_ Ns Ar host
|
|
は、RSA 公開鍵を含みます。
|
|
ここで
|
|
.Ar host
|
|
は、鍵を生成したマシンの DNS 名です。
|
|
.Pa ntpkey_dh
|
|
は、Diffie-Hellman 鍵交換アルゴリズムで用いるパラメータを含みます。
|
|
すべてのファイルは印字可能な ASCII 形式です。
|
|
NTP 秒で示した
|
|
タイムスタンプがそれぞれのファイルに追加されます。
|
|
このアルゴリズムはシステムクロックを乱数の種としますので、
|
|
このプログラムは、実行するごとに異なるファイルとファイル名を
|
|
生成します。
|
|
.Pp
|
|
ファイル
|
|
.Xr ntp.keys 5
|
|
は 16 個の MD5 鍵を含みます。
|
|
それぞれの鍵は、ASCII の印字可能部分集合
|
|
95 文字からランダムに選んだ 16 文字からなります。
|
|
デーモンは、
|
|
設定ファイルコマンド
|
|
.Ic keys
|
|
によって指定された位置からこのファイルを読み込みます。
|
|
また、このファイルは root だけが見ることができるようにします。
|
|
プログラム
|
|
.Xr ntpq 8
|
|
や
|
|
.Xr ntpdc 8
|
|
とともに使用するためには、簡単に思い出せるパスワードからなる
|
|
鍵を手で追加しなければなりません。
|
|
このファイルは同じセキュリティ区画を共有するサーバとクライアントに配布する
|
|
際には、安全な手段で配布しなければなりません。
|
|
一方、MD5 鍵と DES 鍵に
|
|
対する鍵の識別子は、1-65534 の (両端を含む) 範囲に含まれる必要が
|
|
ありますが、プログラム
|
|
.Nm
|
|
ユーティリティは、1 から 16 の識別子のみを使用します。
|
|
各アソシエーションに対する
|
|
鍵の識別子は、設定ファイルコマンド
|
|
.Ic server
|
|
または
|
|
.Ic peer
|
|
の鍵引数として指定されます。
|
|
.Pp
|
|
ファイル
|
|
.Pa ntpkey
|
|
は RSA 秘密鍵を含みます。
|
|
デーモンは、設定ファイルコマンド
|
|
.Ic crypto
|
|
の引数
|
|
.Ar privatekey
|
|
で指定される位置からこのファイルを読み込みます。
|
|
このファイルは、
|
|
root のみが見ることができるようにします。
|
|
このファイルは、これを生成したマシンに対してだけ有効であり、
|
|
他のデーモンやアプリケーションプログラムと共有されることは
|
|
決してありません。
|
|
.Pp
|
|
ファイル
|
|
.Pa ntpkey_ Ns Ar host
|
|
は RSA 公開鍵を含みます。
|
|
ここで、
|
|
.Ar host
|
|
は、このファイルを生成したホストの DNS 名です。
|
|
デーモンは、
|
|
設定ファイルコマンド
|
|
.Ic server
|
|
または、
|
|
.Ic peer
|
|
の引数
|
|
.Ar publickey
|
|
で指定した位置からこのファイルを読み込みます。
|
|
このファイルに含まれるデータは公開値であるため、このファイルは
|
|
安全な手段によらずとも配布、格納することができます。
|
|
.Pp
|
|
ファイル
|
|
.Pa ntp_dh
|
|
は、2 個の Diffie-Hellman パラメータ、
|
|
原始根 (generator) と素数係数 (prime modulus)
|
|
を含みます。
|
|
デーモンは、設定ファイルコマンド
|
|
.Ic crypto
|
|
の引数
|
|
.Ar dhparams
|
|
により指定された位置からこのファイルを読み込みます。
|
|
このファイルは、同じ鍵交換区画を共有する他のサーバ、クライアントに対し
|
|
安全な手段によらずとも配布することができます。
|
|
.Pp
|
|
ファイル形式の最初の部分は 2 行からなります。
|
|
最初の行は、
|
|
ファイルを生成したシステムの DNS 名を含み、2 行目は日付スタンプを
|
|
含みます。
|
|
.Ql #
|
|
から始まる行はコメントとみなされ、デーモンはこの行を無視します。
|
|
ファイル
|
|
.Xr ntp.keys 5
|
|
の中で、次の 16 行は MD5 鍵を順序通り含みます。
|
|
必要があれば、通常のテキストエディタを用いてこのファイルをさらに
|
|
変更することができます。
|
|
次のセクションでこの形式を説明します。
|
|
ファイル
|
|
.Pa ntpkey
|
|
と、
|
|
.Pa ntpkey_ Ns Ar host
|
|
では、
|
|
次の行は係数 (modulus) の長さ (ビット単位) と、鍵を
|
|
PEM でコード化した文字列を含みます。
|
|
ファイル
|
|
.Pa ntpkey_dh
|
|
では、次の行は素数 (prime) の長さ (バイト単位) と、素数を PEM で
|
|
コード化した文字列を含みます。
|
|
その次、すなわち最後行は、原始根 (generator)
|
|
の長さ (バイト単位) と、原始根を PEM でコード化した文字列を含みます。
|
|
.Pp
|
|
注意: 必要があれば、戻り値の説明は、rsaref20 パッケージのファイル
|
|
.Pa ./source/rsaref.h
|
|
を参照して下さい。
|
|
.Sh 関連項目
|
|
.Xr ntp.keys 5 ,
|
|
.Xr ntpdc 8 ,
|
|
.Xr ntpq 8
|
|
.Sh バグ
|
|
RSA 公開鍵/秘密鍵の組と Diffie-Hellman パラメータを生成する際に
|
|
かなり時間がかかることがあります。
|
|
最新のワークステーションで数秒、
|
|
古いマシンなら数分の範囲です。
|