= openssl genpkey = * 各種公開鍵暗号アルゴリズム（ＲＳＡ、ＥＣＤＳＡ、ＥｄＤＳＡ等）の秘密鍵を生成するためのコマンド。 * ＣＳＲ作成する程度であれば、秘密鍵をわざわざ分けて作る必要は無い、と考えてるけど、それでも分けて実行したい場合に使用する。 * もうそろそろ {{{openssl genrsa}}} コマンド使うの止めよう:-)。そんなドキュメントは捨てちゃえ。 <> == ＲＳＡ公開鍵暗号の秘密鍵の作り方 == {{{ openssl genpkey -algorithm RSA -out 秘密鍵ファイル名.pem -pkeyopt rsa_keygen_bits:ビット数 chmod 0400 秘密鍵ファイル名.pem }}} {{{-pkeyout rsa_keygen_bits:}}} を指定しない場合、通常（今時？）２０４８ビットと解釈される。 指定可能なビット数は２５６から１，０７３，７４１，６９６（0x3fffff80）まで可能（openssl のバージョンによる）。 なおマニュアル読むと {{{-pkeyopt rsa_keygen_pubexp:3}}} と「冪指数」に「３」（0x3）を指定している例が記載されているが、 実用的にはデフォルトの６５５３７（0x10001）で十分だし、（素数である必要があるにしても）他を指定する意味は無い（処理速度的にも）。 なお秘密鍵ファイルのパーミッションはバージョン１．１．１になってから気にしないで大丈夫になったようだ。 == ＥＣＤＳＡ公開鍵暗号の秘密鍵の作り方 == {{{ openssl genpkey -algorithm EC -out 秘密鍵ファイル名.pem -pkeyopt ec_paramgen_curve:ＥＣパラメータ名 -pkeyopt ec_param_enc:named_curve chmod 0400 秘密鍵ファイル名.pem }}} または {{{ openssl genpkey -paramfile <(openssl ecparam -name ＥＣパラメータ名) -out 秘密鍵ファイル名.pem chmod 0400 秘密鍵ファイル名.pem }}} ※`<(`''command''`)`というイディオム（実行結果をテンポラリファイル名で渡してくれる）は zsh/bash 拡張なので、シェルスクリプト（sh/ash/ksh）中では使わないこと。 「ＥＣパラメータ名」はいわゆる「prime256v1」「secp384r1」「secp521r1」と言った 「楕円曲線」を示す。具体的には下記コマンドを実行することで、使用できる「楕円曲線」を選べる。 {{{ openssl ecparam -list_curves }}} ただし、他の環境でも使えるかどうかは別の話なので、先に示したメジャーな「楕円曲線」の使用を推奨する。 なお秘密鍵ファイルのパーミッションはバージョン１．１．１になってから気にしないで大丈夫になったようだ。 == ＥｄＳＡ公開鍵暗号の秘密鍵の作り方 == 本機能はバージョン１．１．１での新機能となる。よって、１．１．０はもちろんのこと、それよりも古いバージョンでは実行できない。 {{{ openssl genpkey -algorithm ED25519 -out 秘密鍵ファイル名.pem }}} または {{{ openssl genpkey -algorithm ED448 -out 秘密鍵ファイル名.pem }}} * ＥｄＤＳＡで対応しているエドワーズ曲線はＥＤ２５５１９（２５３ビット）とＥＤ４４８（４４６ビット）である。 * ご覧の通り、ＥＤ２５５１９は現役だが、ＥＤ４４８はバックアップで早々に使われることは無いと思われ。 * なおＥＤ２５５１９は強度的にはｐｒｉｍｅ２５６ｖ１つまり、３０７２ビットＲＳＡ級となる。 * 実用面においてはサポートが始まったばかりなので、認証局で使えるようになるまではあと数年かかると思われる。 === Ｘ２５５１９／Ｘ４４８ === * {{{openssl genpkey}}} ではＸ２５５１９とＸ４４８の秘密鍵の作成が行える。 * ただしこれはキー交換用の鍵であるため、できた秘密鍵から証明書は作成できない。 * なおＸ２５５１９については鍵交換アルゴリズムとして、ＥＤ２５５１９とは違い、既に稼働（普及）している。 == 秘密鍵の暗号化について == 実運用で必要だと思ったことは無いが、世の中には秘密鍵を暗号化しないといけないユースケースがあるようで、その場合の指定方法について調査した。 * 結論から言えば、ＲＳＡでのみ指定できる。ＥＣＤＳＡでは指定できない。未検証だがＥｄＤＳＡも指定できないと思う。 * また指定できる暗号化アルゴリズムも数が限られている。 * 具体的には「{{{openssl enc --list}}}」（旧 openssl コマンドでは存在しないオプションだが問題無い）を実行して「Valid ciphername values:」行より後に出る一覧が指定できる。 * 厳密には更にカウンタ系（ＣＮＴ、ＧＣＭ、ＸＴＳ）や特殊なところで {{{-chacha}}}（ストリーム暗号だから？）, {{{-rc4-hmac-md5}}}（別途秘密鍵が必要でパラメーターとして渡せないから） は指定できない。 == 参考文献 == * [[https://www.openssl.org/blog/blog/2018/09/11/release111/|OpenSSL 1.1.1 Is Released]] ２０１８年０９月１１日付 * [[https://www.openssl.org/docs/man1.1.1/man1/genpkey.html|openssl 1.1.1 genpkey(1)]] * [[https://www.openssl.org/docs/man1.1.0/apps/genpkey.html|openssl 1.1.0 genpkey(1)]] * [[https://jovi0608.hatenablog.com/entry/2018/05/09/213703|「SSL/TLS暗号設定ガイドライン 第2.0版」を読んで]] * [[https://kazu-yamamoto.hatenablog.jp/entry/20171114/1510635277|TLS 1.3 開発日記 その22 公開鍵暗号の動向]]