SSL コンテキストオプション

オプション

peer_name string

使用するピア名。省略した場合は、ストリームをオープンしたときに使ったホスト名をもとに、名前を推測します。

verify_peer bool

SSL サーバー証明書の検証を要求するかどうか。

デフォルトは true です。

verify_peer_name bool

ピア名の検証を要求するかどうか。

デフォルトは true です。

allow_self_signed bool

自己証明の証明書を許可するかどうか。 verify_peer が必要です。

デフォルトは false です。

cafile string

ローカルファイルシステム上の証明書ファイルの場所。 verify_peer オプションでリモートサーバーとの 認証の際に使用する。

capath string

cafile が指定されていなかったりその場所にファイルが 見つからなかったりした場合、capath が指す ディレクトリを検索して認証ファイルを探します。capath は認証ファイルのディレクトリを正確に指している必要があります。

local_cert string

ファイルシステム上のローカル証明書ファイルのパス。 あなたの証明書とプライベートキーを含み、PEM エンコードされた ファイルである必要があります。オプションで、発行者の 認証チェーンを含めることも可能です。 プライベートキーは、 local_pk で指定した別のファイルに含めることも可能です。

local_pk string

ローカルファイルシステム上のプライベートキーファイルの場所。 証明書 (local_cert) とプライベートキーを別のファイルに分けたい場合に用います。

passphrase string

local_cert ファイルをエンコードした際の パスフレーズ。

verify_depth int

証明書のチェインが深すぎる場合に終了するかどうか。

デフォルトでは検証を行いません。

ciphers string

使用可能な暗号化方式の一覧を設定します。設定できるフォーマットは » ciphers(1) の説明を参照ください。

デフォルトは DEFAULT です。

capture_peer_cert bool

true に設定すると、peer_certificate コンテキストオプションがピア証明書を含んで作成されます。

capture_peer_cert_chain bool

true に設定すると、peer_certificate_chain コンテキストオプションが証明書チェインを含んで作成されます。

SNI_enabled bool

true に設定すると、サーバー名の表示 (SNI) が有効になります。 これを有効にすると、同じ IP アドレスで複数の証明書を使えるようになります。

SNI_server_certs array

SNI で使用するサーバー名と、それに対応する証明書の配列。 キーがサーバー名で、値がローカルファイルシステム上の証明書ファイルのパスとなります。 証明書ファイルは PEM エンコードされていて、 証明書とプライベートキーの両方を含んでいる必要があります。

PHP 5.6.0 以降で利用可能です。

alpn_protocols array

ALPN (Application-Layer Protocol Negotiation) で使用する、 アプリケーション層のプロトコル名の配列。 値は、プロトコル名を表す文字列です (たとえば "http/1.1" や "h2")。

PHP 7.0.0 および OpenSSL 1.0.2 以降で利用可能です。

no_ticket bool

設定すると、TLS セッションチケットを無効にします。これは、前方秘匿性 (PFS) を実現し、セキュリティを高めるのに役立ちます。

PHP 5.3.6 以降で利用可能です。

disable_compression bool

設定すると、TLS 圧縮を無効にします。これは、CRIME アタックベクターを軽減するのに役立ちます。

peer_fingerprint string | array

リモート証明書のダイジェストが指定したハッシュに一致しない場合に、異常終了させます。

string を指定する場合は、その長さでハッシュアルゴリズムを判断します。 "md5" (32) あるいは "sha1" (40) のいずれかです。

array を指定する場合は、キーがハッシュアルゴリズムで、 それに対応する値がダイジェストとなります。

security_level int

セキュリティレベルを設定します。 指定されない場合、ライブラリのデフォルトのセキュリティレベルが使われます。 セキュリティレベルについては、 » SSL_CTX_get_security_level(3) に説明があります。

PHP 7.2.0 および OpenSSL 1.1.0 以降が必要です。

min_proto_version int

許可する最小のプロトコルバージョンを設定します。 指定されない場合、ライブラリのデフォルトの最小プロトコルバージョンが使われます。 プロトコルバージョンについては、 » SSL_CTX_set_min_proto_version(3) に説明があります。

PHP 7.3.0 および OpenSSL 1.1.0 以降で利用可能です。

max_proto_version int

許可する最大のプロトコルバージョンを設定します。 指定されない場合、ライブラリのデフォルトの最大プロトコルバージョンが使われます。 プロトコルバージョンについては、 » SSL_CTX_set_max_proto_version(3) に説明があります。

PHP 7.3.0 および OpenSSL 1.1.0 以降で利用可能です。