OpenSSLのソースを表示

[[Category:Transport Layer Security]]
[[en:OpenSSL]]
{{Related articles start}}
{{Related|Transport Layer Security}}
{{Related articles end}}

[http://www.openssl.org OpenSSL] は SSL と TLS プロトコルのオープンソース実装で、可能な限り柔軟になるように設計されています。BSD, Linux, OpenVMS, Solaris, Windows などの様々なプラットフォームをサポートしています。

{{Warning|2015年5月に公開された、OpenSSL のプロトコルの利用に関する共同研究によって、SSL 接続に "Logjam" 攻撃と呼ばれる、さらなる危険が存在することが判明しました。結果については https://weakdh.org/ を、推奨されるサーバー側の設定の変更については https://weakdh.org/sysadmin.html を見て下さい。}}

== インストール ==

{{Pkg|openssl}} は {{Pkg|coreutils}} の依存関係として、デフォルトで Arch Linux にインストールされます。

開発者向けに様々な OpenSSL ライブラリのバインディングが用意されています。

* {{Pkg|python-pyopenssl}}
* {{Pkg|perl-net-ssleay}}
* {{Pkg|lua-sec}}, {{Pkg|lua52-sec}}, {{Pkg|lua51-sec}}
* {{Pkg|haskell-hsopenssl}}
* {{Pkg|haskell-openssl-streams}}

== 設定 ==

Arch Linux では {{ic|OPENSSLDIR}} は {{ic|/etc/ssl}} です。

OpenSSL 設定ファイルは、慣習的に {{ic|/etc/ssl/openssl.cnf}} に置かれ、最初は複雑に見えるかもしれません。シェルスクリプトの動作と同じように、変数が代入で展開されることがあることを覚えておいてください。設定ファイルの形式についての詳しい説明は、{{man|5ssl|config}} を参照してください。

=== req セクション ===

キー、要求、および自己署名証明書の生成に関連する設定。

req セクションは DN プロンプトを担当する。一般的な誤解として、''Common Name'' (CN) プロンプトがあり、これはユーザーの固有名詞を値として持つべきであると示唆するものです。エンドユーザー証明書は CN として '''マシンのホスト名''' を持つ必要があり、一方 CA は有効な TLD を持つべきではありません。これは、認証されたエンドユーザーの CN と CA 証明書の組み合わせの中で、あるソフトウェアがエンドユーザー証明書は自己署名されていると誤認する可能性のある組み合わせが存在しないようにするためです。CA 証明書の中には、[https://www.equifax.com Equifax] のように、CN を持たないものもあります。

{{hc|$ openssl x509 -subject -noout < /etc/ssl/certs/Equifax_Secure_CA.pem|2=
subject= /C=US/O=Equifax/OU=Equifax Secure Certificate Authority
}}

== 使用方法 ==

この章は、[[Transport Layer Security#証明書を取得]]を読んだ事を前提としています。

=== Curve25519 秘密鍵を生成 ===

 $ openssl genpkey -algorithm x25519 -out ''file''

=== ECDSA 秘密鍵を生成 ===

 $ openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-256 -out ''file''

=== RSA 秘密鍵を生成 ===

''genrsa'' に取って代わる({{man|1ssl|openssl}} によると)、{{man|1ssl|genpkey}} を使用。

 $ openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:''keysize'' -out ''file''

暗号化された鍵が必要な場合は、{{ic|-aes-256-cbc}} オプションを使用します。

=== 証明書署名要求を生成 ===

{{man|1ssl|req}} を使用。

 $ openssl req -new -sha256 -key ''private_key'' -out ''filename''

=== 証明書署名リクエストを表示 ===

証明書署名リクエストはエンコードされた形式で保存されます。リクエストを人間が読める形式で表示するには:

 $ openssl req -noout -text -in ''filename''

=== 自己証明証明書を生成 ===

 $ openssl req -key ''private_key'' -x509 -new -days ''days'' -out ''filename''

=== 一つのコマンドで自己証明証明書と秘密鍵を生成 ===

OpenSSL では、上記のコマンドを 1 つにまとめることができるので、場合によっては便利かもしれません。

  $ openssl req -x509 -newkey rsa:4096 -days ''days'' -keyout ''key_filename'' -out ''cert_filename''

=== Diffie–Hellman パラメーターを生成 ===

詳細については、[[Wikipedia:Diffie–Hellman key exchange|Diffie–Hellman key exchange]] を参照してください。

現在の[[MozillaWiki:Security/Server Side TLS|ベストプラクティス]]は、RFC 7919の標準的なDHグループの1つ、例えば [https://ssl-config.mozilla.org/ffdhe2048.txt ffdhe2048] を使用することです。

あるいは、自分でランダムなグループを生成することもできます。

 $ openssl dhparam -out ''filename'' ''2048''

{{Tip|特にハイエンドのハードウェアでない場合、生成を高速化するには、{{ic|-dsaparam}} オプションを追加します[https://security.stackexchange.com/questions/95178/diffie-hellman-parameters-still-calculating-after-24-hours/95184#95184]。}}
=== 証明書情報を表示 ===

 $ openssl x509 -text -in ''cert_filename''

=== 証明書の指紋を表示 ===

 $ openssl x509 -noout -in ''cert_filename'' -fingerprint ''-digest''

{{ic|''-digest''}} はオプションで、{{ic|-md5}}、{{ic|-sha1}}、{{ic|-sha256}} または {{ic|-sha512}} のいずれか 1 つです。digest が指定されていない場合については、{{man|1ssl|x509|Input, Output, and General Purpose Options}} の「-digest」 を参照してください。

=== 証明書の形式を変換する ===

{{ic|openssl x509}} を使用して、証明書をバイナリ (DER) 形式から PEM 形式 ({{ic|BEGIN CERTIFICATE}} ヘッダを含むテキスト形式) に変換します。

 $ openssl x509 -inform DER < ''myCA''.crt > ''myCA_pem''.crt

=== サードパーティプロバイダーを使用する ===

OpenSSL 3 では、OpenSSL プラグ可能性の新しい概念としてプロバイダーが導入されました。 OpenSSL に含まれていないアルゴリズムを再コンパイルすることなく使用できます。たとえば、[https://csrc.nist.gov/projects/post-quantum-cryptography NIST ポスト量子暗号] アルゴリズムをテストするには、[https://openquantumsafe.org/ Open Quantum Safe] プロバイダー {{AUR|oqsprovider}} をインストールできます。例として、[https://pq-crystals.org/dilithium/index.shtml Dilithium] 署名アルゴリズムのバリアントの 1 つを使用して、秘密キーを含む量子安全な自己署名証明書を生成できます。

 $ openssl req -provider oqsprovider -x509 -newkey dilithium3 -days ''days'' -keyout ''key'' -out ''cert''

== トラブルシューティング ==

=== 復号時に "bad decrypt" と表示される ===

OpenSSL 1.1.0 から dgst と enc コマンドのデフォルトのダイジェストアルゴリズムが MD5 から SHA256 に変更されています [https://www.openssl.org/news/changelog.html#x6]。

OpenSSL 1.0.2 以前を使ってファイルを暗号化した場合、復号化しようとすると新しいバージョンでは以下のようにエラーが発生します:

 error:06065064:digital envelope routines:EVP_DecryptFinal_ex:bad decrypt:crypto/evp/evp_enc.c:540

{{ic|-md md5}} オプションを指定することで問題は解決します:

 $ openssl enc -d -md md5 -in encrypted -out decrypted

=== Python 3.10 と "ca md too weak" エラー ===

Python 3.10 のデフォルトでは、許可された OpenSSL 暗号のハードコードされたリストがあります。MD5 のような安全でないものは、OpenSSL のシステム全体の設定を無視して、 {{ic|ssl}} モジュールレベルで無効化されています。その結果、古い証明書や、時には {{ic|https}} 接続を確立するときでさえ、奇妙なエラーになることがあります、以下のような:

 requests.exceptions.SSLError: HTTPSConnectionPool(host='a.kind.of.example.com', port=443): Max retries exceeded with url: / (Caused by SSLError(SSLError(398, '[SSL: CA_MD_TOO_WEAK] ca md too weak (_ssl.c:3862)')))

Python をシステムの設定に従うようにするには、 {{ic|1=--with-ssl-default-suites=openssl}} パラメータを {{ic|./configure}} に追加して再構築する必要があるかもしれません。この問題は {{Bug|73549}} としても報告されています。

==参照==
* [http://ja.wikipedia.org/wiki/OpenSSL Wikipedia] の OpenSSL のページ
* [http://www.openssl.org OpenSSL] プロジェクトページ
* [https://www.freebsd.org/doc/ja/books/handbook/openssl.html FreeBSD ハンドブック]
* [http://www.akadia.com/services/ssh_test_certificate.html 署名済みの SSL 証明書を作成するステップバイステップガイド]
* [https://jamielinux.com/docs/openssl-certificate-authority/ OpenSSL Certificate Authority]: 独自の認証局として機能する方法を説明するガイド。
* [https://www.feistyduck.com/books/bulletproof-ssl-and-tls/bulletproof-ssl-and-tls-introduction.pdf Bulletproof SSL and TLS by Ivan Ristić], SSL/TLS のより正式な入門書