PHP 5.6.29 Released

گزینه‌های متنSSL

گزینه‌های متنSSLفهرست گزینه‌های متن SSL

Description

گزینه‌های متن برای انتقالات ssl:// و tls://.

Options

verify_peer boolean

نیازمند تایید گواهینامه SSL.

بصورت پیشفرض FALSE.

allow_self_signed boolean

امکام گواهینامه‌های خودامضا.

بصورت پیش‌فرض FALSE

cafile string

مکان فایل تایید هویت در سیستم فایل محلی به همراه گزینه متن verify_peer برای تایید هویت نقطه دور استفاده می‌شود.

capath string

اگر cafile تعیین نشده باشد یا اگر گواهینامه یافت نشود دایرکتوری اشاره شده با capath جستجو می‌گردد تا گواهینامه لازم یافت شود. capath باید یک دایرکتوری درهم‌سازی شده گواهینامه باشد.

local_cert string

مسیر فایل گواهینامه محلی در سیستم فایل. باید یک فایل کدگذاری شده PEM شامل گواهینامه شما و کلید خصوصی را شامل باشد. می‌تواند بصورت اختیاری شامل زنجیره صادرکنندگان گواهینامه هم باشد.

passphrase string

Passphrase که با آن فایل local_cert کدگذاری گردیده است.

CN_match string

اسامی معمول را ما انتظار داریم. PHP تنها تعداد محدودی تطبیق انجام می‌دهد. اگر اسامی معمول تطبیق نداشتند این تلاش برای اتصال شکست خواهد خورد.

verify_depth integer

اگر زنجیره گواهینامه سنگین بود پایان بده.

Defaults to no verification.

ciphers string

فهرست رمزنگاری موجود را تعیین می‌نماید. قالب رشته توسط » ciphers(1) تعیین شده است.

بصورت پیشفرض DEFAULT.

capture_peer_cert boolean

اگر برابر با TRUE باشد یک گزینه متن peer_certificate شامل گواهینامه نقطه را خواهد ساخت.

capture_peer_cert_chain boolean

اگر برابر باTRUE باشد یک گزینه متن peer_certificate_chain شامل زنجیره گواهینامه ساخته خواهد شد.

SNI_enabled boolean

اگر برابر با TRUE باشد نام سرور مشخص خواهد شد. فعال کردن SNI امکان صدور چندین مجوز برای یک IP فراهم می‌کند.

SNI_server_name string

اگر تعیین شده باشد این مقداربه عنوان نام سرور در مشخص کننده نام سرور به کار خواهد رفت. اگر تعیین نشده باشد نام سرور بر اساس نام میزبان هنگام باز نمودن جریان استفاده خواهد شد.

Changelog

Version Description
5.3.2 SNI_enabled و SNI_server_name اضافه شد.
5.0.0 capture_peer_cert٬ capture_peer_chain و ciphers را اضافه نمود.

Notes

Note: بدلیل زیرساختار بودن ssl:// برای پوشاننده‌های https:// و ftps:// هر گزینه متن برای ssl:// در مورد https:// و ftps:// نیز صادق است.

Note: برای SNI (Server Name Indication) PHPباید به همراه OpenSSL 0.9.8j یا بالاتر کلامپایل شده باشد. از OPENSSL_TLSEXT_SERVER_NAME برای تعیین پشتیبانی از SNI استفاده کنید.

add a note add a note

User Contributed Notes 6 notes

up
3
Anonymous
2 years ago
If I read the UPGRADING file correctly, in PHP 5.6 the default value of verify_peer has changed.
up
2
Botjan kufca
6 years ago
CN_match works contrary to intuitive thinking. I came across this when I was developing SSL server implemented in PHP. I stated (in code):

- do not allow self signed certs (works)
- verify peer certs against CA cert (works)
- verify the client's CN against CN_match (does not work), like this:

stream_context_set_option($context, 'ssl', 'CN_match', '*.example.org');

I presumed this would match any client with CN below .example.org domain.
Unfortunately this is NOT the case. The option above does not do that.

What it really does is this:
- it takes client's CN and compares it to CN_match
- IF CLIENT's CN CONTAINS AN ASTERISK like *.example.org, then it is matched against CN_match in wildcard matching fashion

Examples to illustrate behaviour:
(CNM = server's CN_match)
(CCN = client's CN)

- CNM=host.example.org, CCN=host.example.org ---> OK
- CNM=host.example.org, CCN=*.example.org ---> OK
- CNM=.example.org, CCN=*.example.org ---> OK
- CNM=example.org, CCN=*.example.org ---> ERROR

- CNM=*.example.org, CCN=host.example.org ---> ERROR
- CNM=*.example.org, CCN=*.example.org ---> OK

According to PHP sources I believe that the same applies if you are trying to act as Client and the server contains a wildcard certificate. If you set CN_match to myserver.example.org and server presents itself with *.example.org, the connection is allowed.

Everything above applies to PHP version 5.2.12.
I will supply a patch to support CN_match starting with asterisk.
up
2
website at meezaan dot net
3 months ago
There is also a crypto_type context. In older versions this was crypto_method. This is referenced on http://php.net/manual/en/function.stream-socket-enable-crypto.php.
up
1
borbas dot geri at gmail dot com
2 years ago
I used this for Apple Push Notification Service.
Passed in a local certificate filename `cert.pem` trough local_cert option.
Worked fine, when invoked the script directly.

But when I included/required the script from a different location, it stopped working, without any explicit error message.

Resolved by passed in the full path for the file `<FullPathTo>cert.pem`.
up
0
Charlie
5 days ago
I am unable to load a PEM that was generated with the stunnel tools. However, I am able to use PHP calls to generate a working PEM that is recognized both by stunnel and php, as outlined here:

http://www.devdungeon.com/content/how-use-ssl-sockets-php

This code fragment is now working for me, and with stunnel verify=4, both sides confirm the fingerprint. Oddly, if "tls://" is set below, then TLSv1 is forced, but using "ssl://" allows TLSv1.2:

$stream_context = stream_context_create([ 'ssl' => [
'local_cert'        => '/path/to/key.pem',
'peer_fingerprint'  => openssl_x509_fingerprint(file_get_contents('/path/to/key.crt')),
'verify_peer'       => false,
'verify_peer_name'  => false,
'allow_self_signed' => true,
'verify_depth'      => 0 ]]);

$fp = stream_socket_client('ssl://ssl.server.com:12345',
   $errno, $errstr, 30, STREAM_CLIENT_CONNECT, $stream_context);
fwrite($fp, "foo bar\n");
while($line = fgets($fp, 8192)) echo $line;
up
0
Charlie
8 days ago
It appears that "allow_self_signed" does not and cannot apply to the local_cert option.

The stunnel verify=4 option, which verifies but ignores a CA, has no analog in these settings, which is unfortunate.

Even more perplexingly, while the "openssl verify -CAfile" is successful, PHP appears unable to use the new ca/crt pair in any configuration.

I did actually link my PHP against a copy of LibreSSL 2.3.8, but PHP oddly is unable to use TLS1.1 or 1.2. It does, however, enable EC secp521r1 (of which my native OpenSSL 0.9.8e is incapable).
To Top