mirror of
https://github.com/php/doc-ru.git
synced 2026-03-24 07:42:22 +01:00
883 lines
30 KiB
XML
883 lines
30 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
||
<!-- EN-Revision: 3b06ef4bb06db8cf2cd8ea8470287f7f43ef9e71 Maintainer: aur Status: ready -->
|
||
<!-- Reviewed: no -->
|
||
<appendix xml:id="openssl.constants" xmlns="http://docbook.org/ns/docbook">
|
||
&reftitle.constants;
|
||
&extension.constants;
|
||
<section xml:id="openssl.purpose-check">
|
||
<title>Флаги проверки</title>
|
||
<variablelist>
|
||
<varlistentry xml:id="constant.x509-purpose-ssl-client">
|
||
<term>
|
||
<constant>X509_PURPOSE_SSL_CLIENT</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.x509-purpose-ssl-server">
|
||
<term>
|
||
<constant>X509_PURPOSE_SSL_SERVER</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.x509-purpose-ns-ssl-server">
|
||
<term>
|
||
<constant>X509_PURPOSE_NS_SSL_SERVER</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.x509-purpose-smime-sign">
|
||
<term>
|
||
<constant>X509_PURPOSE_SMIME_SIGN</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.x509-purpose-smime-encrypt">
|
||
<term>
|
||
<constant>X509_PURPOSE_SMIME_ENCRYPT</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.x509-purpose-crl-sign">
|
||
<term>
|
||
<constant>X509_PURPOSE_CRL_SIGN</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.x509-purpose-any">
|
||
<term>
|
||
<constant>X509_PURPOSE_ANY</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
</variablelist>
|
||
</section>
|
||
|
||
<section xml:id="openssl.padding">
|
||
<title>Флаги заполнения для ассиметричного шифрования</title>
|
||
<variablelist>
|
||
<varlistentry xml:id="constant.openssl-pkcs1-padding">
|
||
<term>
|
||
<constant>OPENSSL_PKCS1_PADDING</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-sslv23-padding">
|
||
<term>
|
||
<constant>OPENSSL_SSLV23_PADDING</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-no-padding">
|
||
<term>
|
||
<constant>OPENSSL_NO_PADDING</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-pkcs1-oaep-padding">
|
||
<term>
|
||
<constant>OPENSSL_PKCS1_OAEP_PADDING</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
</variablelist>
|
||
</section>
|
||
|
||
<section xml:id="openssl.key-types">
|
||
<title>Типы ключей</title>
|
||
<variablelist>
|
||
<varlistentry xml:id="constant.openssl-keytype-rsa">
|
||
<term>
|
||
<constant>OPENSSL_KEYTYPE_RSA</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
RSA key type.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-keytype-dsa">
|
||
<term>
|
||
<constant>OPENSSL_KEYTYPE_DSA</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
DSA key type.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-keytype-dh">
|
||
<term>
|
||
<constant>OPENSSL_KEYTYPE_DH</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
DH (Diffie-Hellman) key type.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-keytype-ec">
|
||
<term>
|
||
<constant>OPENSSL_KEYTYPE_EC</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
Тип ключа эллиптической кривой.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-keytype-x25519">
|
||
<term>
|
||
<constant>OPENSSL_KEYTYPE_X25519</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
Тип ключа кривой X25519.
|
||
Константа доступна только в том случае, если PHP скомпилирован с OpenSSL 3.0+.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-keytype-ed25519">
|
||
<term>
|
||
<constant>OPENSSL_KEYTYPE_ED25519</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
Тип ключа кривой Ed25519.
|
||
Константа доступна только в том случае, если PHP скомпилирован с OpenSSL 3.0+.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-keytype-x448">
|
||
<term>
|
||
<constant>OPENSSL_KEYTYPE_X448</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
Тип ключа кривой X448.
|
||
Константа доступна только в том случае, если PHP скомпилирован с OpenSSL 3.0+.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-keytype-ed448">
|
||
<term>
|
||
<constant>OPENSSL_KEYTYPE_ED448</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
Тип ключа кривой Ed448.
|
||
Константа доступна только в том случае, если PHP скомпилирован с OpenSSL 3.0+.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
</variablelist>
|
||
</section>
|
||
|
||
<section xml:id="openssl.pkcs7.flags">
|
||
<title>Константы-флаги структур <acronym>PKCS7</acronym></title>
|
||
<para>
|
||
The S/MIME functions make use of flags which are specified using a
|
||
bitfield which can include one or more of the following values:
|
||
<table>
|
||
<title>Константы <acronym>PKCS7</acronym></title>
|
||
<tgroup cols="2">
|
||
<thead>
|
||
<row>
|
||
<entry>Константа</entry>
|
||
<entry>Описание</entry>
|
||
</row>
|
||
</thead>
|
||
<tbody>
|
||
<row xml:id="constant.pkcs7-text">
|
||
<entry>
|
||
<constant>PKCS7_TEXT</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>
|
||
Добавляет заголовок «Content-Type: <literal>text/plain</literal>» к зашифрованному
|
||
и подписанному сообщению.
|
||
При расшифровке или проверке флаг удаляет заголовки
|
||
из вывода. Возникнет ошибка, если расшифрованное или проверенное сообщение
|
||
не относится к <acronym>MIME</acronym>-типу <literal>text/plain</literal>.
|
||
</entry>
|
||
</row>
|
||
<row xml:id="constant.pkcs7-binary">
|
||
<entry>
|
||
<constant>PKCS7_BINARY</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>
|
||
Обычно входное сообщение преобразовывается к «каноническому» формату,
|
||
который эффективно использует последовательности <literal>CR</literal> и <literal>LF</literal>
|
||
как символы конца строки: как того требует сертификация S/MIME. С этой опцией
|
||
сообщение не преобразовывается. Это полезно при обработке двоичных данных,
|
||
формат которых не всегда соответствует MIME-формату.
|
||
</entry>
|
||
</row>
|
||
<row xml:id="constant.pkcs7-nointern">
|
||
<entry>
|
||
<constant>PKCS7_NOINTERN</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>
|
||
При проверке сообщения, если сообщение содержит сертификаты,
|
||
среди сертификатов сообщения обычно выполняется поиск сертификата подписи.
|
||
С этой опцией поиск выполняется только по сертификатам параметра
|
||
<parameter>untrusted_certificates_filename</parameter> функции <function>openssl_pkcs7_verify</function>,
|
||
а не по сертификатам сообщения. Предоставленные сертификаты по-прежнему можно использовать,
|
||
но как сертификаты недоверенных центров сертификации.
|
||
</entry>
|
||
</row>
|
||
<row xml:id="constant.pkcs7-noverify">
|
||
<entry>
|
||
<constant>PKCS7_NOVERIFY</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>Флаг отключает проверку сертификата отправителя подписанного сообщения.</entry>
|
||
</row>
|
||
<row xml:id="constant.pkcs7-nochain">
|
||
<entry>
|
||
<constant>PKCS7_NOCHAIN</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>
|
||
Флаг отключает проверку цепочки сертификатов отправителя: то есть исключает сертификаты
|
||
в подписанном сообщении (кроме сертификата отправителя)
|
||
как сертификаты недоверенных центров сертификации.
|
||
</entry>
|
||
</row>
|
||
<row xml:id="constant.pkcs7-nocerts">
|
||
<entry>
|
||
<constant>PKCS7_NOCERTS</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>
|
||
При подписании сообщения сертификат отправителя обычно включается
|
||
в сообщение, тогда как с этой опцией сертификат не добавляется. Это уменьшит
|
||
размер подписанного сообщения, но получателю потребуется доступ к локальной копии
|
||
сертификата отправителя, которую передают, например, через параметр
|
||
<parameter>untrusted_certificates_filename</parameter> функции
|
||
<function>openssl_pkcs7_verify</function>.
|
||
</entry>
|
||
</row>
|
||
<row xml:id="constant.pkcs7-noattr">
|
||
<entry>
|
||
<constant>PKCS7_NOATTR</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>
|
||
При подписании в сообщение обычно включается набор атрибутов, который содержит
|
||
время подписания и список симметричных алгоритмов, которые поддерживает S/MIME-протокол.
|
||
С этой опцией атрибуты не включаются.
|
||
</entry>
|
||
</row>
|
||
<row xml:id="constant.pkcs7-detached">
|
||
<entry>
|
||
<constant>PKCS7_DETACHED</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>
|
||
При подписании сообщения функция прикрепляет подпись в виде открытого текста
|
||
с MIME-типом <literal>multipart/signed</literal>. Это значение по умолчанию,
|
||
если только не указали флаги для параметра <parameter>flags</parameter> функции
|
||
<function>openssl_pkcs7_sign</function>.
|
||
Без этой опции функция подпишет сообщение непрозрачной подписью,
|
||
которая более устойчива к пересылке сообщений почтовыми ретрансляторами,
|
||
но недоступна для прочтения почтовыми агентами, которые
|
||
не поддерживают стандарт S/MIME.
|
||
</entry>
|
||
</row>
|
||
<row xml:id="constant.pkcs7-nosigs">
|
||
<entry>
|
||
<constant>PKCS7_NOSIGS</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>Флаг отключает попытку проверки подписей в сообщениях.</entry>
|
||
</row>
|
||
<row xml:id="constant.pkcs7-nooldmimetype">
|
||
<entry>
|
||
<constant>PKCS7_NOOLDMIMETYPE</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>
|
||
Флаг доступен с PHP 8.3.0. Опция устанавливает для шифрования сообщения
|
||
заголовок <literal>Content-Type: application/pkcs7-mime</literal>
|
||
вместо заголовка <literal>Content-Type: application/x-pkcs7-mime</literal>.
|
||
</entry>
|
||
</row>
|
||
</tbody>
|
||
</tgroup>
|
||
</table>
|
||
</para>
|
||
</section>
|
||
|
||
<section xml:id="openssl.cms.flags">
|
||
<title>Константы-флаги стуктур <acronym>CMS</acronym></title>
|
||
<para>
|
||
Функции для работы с CMS-сообщениями принимают флаги, которые определяют как битовое поле.
|
||
Поле битов включает одно или набор следующих значений:
|
||
<table>
|
||
<title>Константы <acronym>CMS</acronym></title>
|
||
<tgroup cols="2">
|
||
<thead>
|
||
<row>
|
||
<entry>Константа</entry>
|
||
<entry>Описание</entry>
|
||
</row>
|
||
</thead>
|
||
<tbody>
|
||
<row xml:id="constant.openssl-cms-text">
|
||
<entry>
|
||
<constant>OPENSSL_CMS_TEXT</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>
|
||
Добавляет заголовки content-type text/plain в зашифрованное/подписанное
|
||
сообщение. При расшифровке или проверке эти заголовки удаляются из вывода —
|
||
если расшифрованное или проверенное сообщение не относится к MIME-типу
|
||
text/plain, произойдёт ошибка.
|
||
</entry>
|
||
</row>
|
||
<row xml:id="constant.openssl-cms-binary">
|
||
<entry>
|
||
<constant>OPENSSL_CMS_BINARY</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>
|
||
Обычно входное сообщение преобразовывается в «каноничный» формат, который
|
||
эффективно использует символы <literal>CR</literal> и <literal>LF</literal>
|
||
в качестве конца строки: как требует спецификация CMS. Когда
|
||
присутствует эта опция, перевод не выполняется. Это полезно при обработке
|
||
двоичных данных, которые могут быть не в формате CMS.
|
||
</entry>
|
||
</row>
|
||
<row xml:id="constant.openssl-cms-nointern">
|
||
<entry>
|
||
<constant>OPENSSL_CMS_NOINTERN</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>
|
||
При проверке сообщения сертификаты (если есть), включённые в сообщение,
|
||
обычно проверяются на наличие сертификата подписи. С этой опцией используются
|
||
только сертификаты, указанные в параметре <parameter>untrusted_certificates_filename</parameter>
|
||
функции <function>openssl_cms_verify</function>.
|
||
Однако предоставленные сертификаты можно использовать как ненадёжные центры сертификации.
|
||
</entry>
|
||
</row>
|
||
<row xml:id="constant.openssl-cms-noverify">
|
||
<entry>
|
||
<constant>OPENSSL_CMS_NOVERIFY</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>
|
||
Не проверять сертификат подписавшего у подписанного сообщения.
|
||
</entry>
|
||
</row>
|
||
<row xml:id="constant.openssl-cms-nocerts">
|
||
<entry>
|
||
<constant>OPENSSL_CMS_NOCERTS</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>
|
||
При подписании сообщения сертификат подписывающей стороны обычно
|
||
включается — с этой опцией он исключается. Это уменьшит размер
|
||
подписанного сообщения, но у проверяющего должна быть копия сертификата
|
||
подписавшего, доступная локально (например, переданная в параметр <parameter>untrusted_certificates_filename</parameter>
|
||
функции <function>openssl_cms_verify</function>).
|
||
</entry>
|
||
</row>
|
||
<row xml:id="constant.openssl-cms-noattr">
|
||
<entry>
|
||
<constant>OPENSSL_CMS_NOATTR</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>
|
||
Обычно при подписании сообщения включается набор атрибутов,
|
||
который включает время подписи и поддерживаемые симметричные алгоритмы.
|
||
С этой опцией они не включены.
|
||
</entry>
|
||
</row>
|
||
<row xml:id="constant.openssl-cms-detached">
|
||
<entry>
|
||
<constant>OPENSSL_CMS_DETACHED</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>
|
||
При подписании сообщения используйте подпись открытым текстом с MIME-типом
|
||
<literal>"multipart/signed"</literal>. Это значение по умолчанию,
|
||
если вы не укажете никаких <parameter>flags</parameter> для
|
||
<function>openssl_cms_sign</function>.
|
||
Если вы отключите эту опцию, сообщение будет подписано с использованием
|
||
непрозрачной подписи, которая более устойчива к переводу почтовыми
|
||
ретрансляторами, но не может быть прочитана почтовыми агентами,
|
||
не поддерживающими S/MIME.
|
||
</entry>
|
||
</row>
|
||
<row xml:id="constant.openssl-cms-nosigs">
|
||
<entry>
|
||
<constant>OPENSSL_CMS_NOSIGS</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>Не пытаться проверять подписи в сообщении</entry>
|
||
</row>
|
||
<row xml:id="constant.openssl-cms-oldmimetype">
|
||
<entry>
|
||
<constant>OPENSSL_CMS_OLDMIMETYPE</constant>
|
||
(<type>int</type>)
|
||
</entry>
|
||
<entry>
|
||
Доступно начиная с PHP 8.3.0.
|
||
Устанавливает тип содержимого <literal>application/x-pkcs7-mime</literal>
|
||
вместо <literal>application/pkcs7-mime</literal> для шифрования сообщения.
|
||
</entry>
|
||
</row>
|
||
</tbody>
|
||
</tgroup>
|
||
</table>
|
||
</para>
|
||
</section>
|
||
|
||
<section xml:id="openssl.signature-algos">
|
||
<title>Алгоритмы подписи</title>
|
||
<variablelist>
|
||
<varlistentry xml:id="constant.openssl-algo-dss1">
|
||
<term>
|
||
<constant>OPENSSL_ALGO_DSS1</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-algo-sha1">
|
||
<term>
|
||
<constant>OPENSSL_ALGO_SHA1</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
Используется как алгоритм по умолчанию для функций <function>openssl_sign</function> и
|
||
<function>openssl_verify</function>.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-algo-sha224">
|
||
<term>
|
||
<constant>OPENSSL_ALGO_SHA224</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-algo-sha256">
|
||
<term>
|
||
<constant>OPENSSL_ALGO_SHA256</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-algo-sha384">
|
||
<term>
|
||
<constant>OPENSSL_ALGO_SHA384</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-algo-sha512">
|
||
<term>
|
||
<constant>OPENSSL_ALGO_SHA512</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-algo-rmd160">
|
||
<term>
|
||
<constant>OPENSSL_ALGO_RMD160</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-algo-md5">
|
||
<term>
|
||
<constant>OPENSSL_ALGO_MD5</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-algo-md4">
|
||
<term>
|
||
<constant>OPENSSL_ALGO_MD4</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-algo-md2">
|
||
<term>
|
||
<constant>OPENSSL_ALGO_MD2</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
Эта константа доступна, только если
|
||
PHP скомпилирован с поддержкой MD2. Для этого необходимо при компиляции PHP
|
||
передать CFLAG <literal>-DHAVE_OPENSSL_MD2_H</literal>
|
||
и включить <literal>enable-md2</literal> при компиляции OpenSSL 1.0.0+.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
</variablelist>
|
||
|
||
</section>
|
||
|
||
<section xml:id="openssl.ciphers">
|
||
<title>Алгоритмы шифрования</title>
|
||
<variablelist>
|
||
<varlistentry xml:id="constant.openssl-default-stream-ciphers">
|
||
<term>
|
||
<constant>OPENSSL_DEFAULT_STREAM_CIPHERS</constant>
|
||
(<type>string</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
Список шифров по умолчанию.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-cipher-rc2-40">
|
||
<term>
|
||
<constant>OPENSSL_CIPHER_RC2_40</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-cipher-rc2-128">
|
||
<term>
|
||
<constant>OPENSSL_CIPHER_RC2_128</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-cipher-rc2-64">
|
||
<term>
|
||
<constant>OPENSSL_CIPHER_RC2_64</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-cipher-des">
|
||
<term>
|
||
<constant>OPENSSL_CIPHER_DES</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-cipher-3des">
|
||
<term>
|
||
<constant>OPENSSL_CIPHER_3DES</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
</variablelist>
|
||
<variablelist>
|
||
<varlistentry xml:id="constant.openssl-cipher-aes-128-cbc">
|
||
<term>
|
||
<constant>OPENSSL_CIPHER_AES_128_CBC</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-cipher-aes-192-cbc">
|
||
<term>
|
||
<constant>OPENSSL_CIPHER_AES_192_CBC</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-cipher-aes-256-cbc">
|
||
<term>
|
||
<constant>OPENSSL_CIPHER_AES_256_CBC</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
</variablelist>
|
||
</section>
|
||
|
||
<section xml:id="openssl.constversion">
|
||
<title>Константы версий</title>
|
||
<variablelist>
|
||
<varlistentry xml:id="constant.openssl-version-text">
|
||
<term>
|
||
<constant>OPENSSL_VERSION_TEXT</constant>
|
||
(<type>string</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-version-number">
|
||
<term>
|
||
<constant>OPENSSL_VERSION_NUMBER</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
</variablelist>
|
||
</section>
|
||
|
||
<section xml:id="openssl.constsni">
|
||
<title>Константа SNI (Server Name Indication)</title>
|
||
<variablelist>
|
||
<varlistentry xml:id="constant.openssl-tlsext-server-name">
|
||
<term>
|
||
<constant>OPENSSL_TLSEXT_SERVER_NAME</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
Независимо от доступности SNI.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
</variablelist>
|
||
<note>
|
||
<para>
|
||
Эта константа требует PHP собранного
|
||
с библиотекой OpenSSL версии 0.9.8j или выше.
|
||
</para>
|
||
</note>
|
||
</section>
|
||
|
||
<section xml:id="openssl.constants.other">
|
||
<title>Другие константы</title>
|
||
<variablelist>
|
||
<varlistentry xml:id="constant.openssl-raw-data">
|
||
<term>
|
||
<constant>OPENSSL_RAW_DATA</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
Если константа <constant>OPENSSL_RAW_DATA</constant> передана
|
||
в функции <function>openssl_encrypt</function> или <function>openssl_decrypt</function>,
|
||
данные возвращаются как есть.
|
||
Если константа не указана, вызывающей стороне возвращаются данные в кодировке Base64.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-dont-zero-pad-key">
|
||
<term>
|
||
<constant>OPENSSL_DONT_ZERO_PAD_KEY</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
Не разрешает функции <function>openssl_encrypt</function> дополнять ключи,
|
||
длина которых короче длины ключа по умолчанию.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-zero-padding">
|
||
<term>
|
||
<constant>OPENSSL_ZERO_PADDING</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
По умолчанию операции шифрования дополняются стандартным заполнением блока,
|
||
а заполнение проверяется и удаляется при дешифровании.
|
||
Если константа <constant>OPENSSL_ZERO_PADDING</constant> передана в параметр <parameter>options</parameter>
|
||
функций <function>openssl_encrypt</function> или <function>openssl_decrypt</function>,
|
||
то заполнение не выполняется, общий объем
|
||
зашифрованных или расшифрованных данных должен быть кратен размеру
|
||
блока, иначе возникнет ошибка.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-encoding-smime">
|
||
<term>
|
||
<constant>OPENSSL_ENCODING_SMIME</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
Указывает, что выбрана кодировка S/MIME.
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-encoding-der">
|
||
<term>
|
||
<constant>OPENSSL_ENCODING_DER</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
Указывает, что выбрана кодировка <acronym>DER</acronym> (Distinguished Encoding Rules).
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
<varlistentry xml:id="constant.openssl-encoding-pem">
|
||
<term>
|
||
<constant>OPENSSL_ENCODING_PEM</constant>
|
||
(<type>int</type>)
|
||
</term>
|
||
<listitem>
|
||
<simpara>
|
||
Указывает, что выбрана кодировка <acronym>PEM</acronym> (Privacy-Enhanced Mail).
|
||
</simpara>
|
||
</listitem>
|
||
</varlistentry>
|
||
</variablelist>
|
||
</section>
|
||
</appendix>
|
||
<!-- Keep this comment at the end of the file
|
||
Local variables:
|
||
mode: sgml
|
||
sgml-omittag:t
|
||
sgml-shorttag:t
|
||
sgml-minimize-attributes:nil
|
||
sgml-always-quote-attributes:t
|
||
sgml-indent-step:1
|
||
sgml-indent-data:t
|
||
indent-tabs-mode:nil
|
||
sgml-parent-document:nil
|
||
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
|
||
sgml-exposed-tags:nil
|
||
sgml-local-catalogs:nil
|
||
sgml-local-ecat-files:nil
|
||
End:
|
||
vim600: syn=xml fen fdm=syntax fdl=2 si
|
||
vim: et tw=78 syn=sgml
|
||
vi: ts=1 sw=1
|
||
-->
|