mirror of
https://github.com/php/doc-ja.git
synced 2026-03-27 08:32:09 +01:00
906 lines
28 KiB
XML
906 lines
28 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: 3b06ef4bb06db8cf2cd8ea8470287f7f43ef9e71 Maintainer: hirokawa Status: ready -->
|
|
<!-- CREDITS: takagi,mumumu -->
|
|
<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 鍵タイプ
|
|
</simpara>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry xml:id="constant.openssl-keytype-dsa">
|
|
<term>
|
|
<constant>OPENSSL_KEYTYPE_DSA</constant>
|
|
(<type>int</type>)
|
|
</term>
|
|
<listitem>
|
|
<simpara>
|
|
DSA 鍵タイプ
|
|
</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) 鍵タイプ
|
|
</simpara>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry xml:id="constant.openssl-keytype-ec">
|
|
<term>
|
|
<constant>OPENSSL_KEYTYPE_EC</constant>
|
|
(<type>int</type>)
|
|
</term>
|
|
<listitem>
|
|
<simpara>
|
|
Elliptic curve (EC) 鍵タイプ
|
|
</simpara>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry xml:id="constant.openssl-keytype-x25519">
|
|
<term>
|
|
<constant>OPENSSL_KEYTYPE_X25519</constant>
|
|
(<type>int</type>)
|
|
</term>
|
|
<listitem>
|
|
<simpara>
|
|
X25519 curve 鍵タイプ。
|
|
この定数が使えるのは、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 curve 鍵タイプ。
|
|
この定数が使えるのは、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 curve 鍵タイプ。
|
|
この定数が使えるのは、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 curve 鍵タイプ。
|
|
この定数が使えるのは、PHP をコンパイルする際に OpenSSL 3.0以降を使ったときだけです。
|
|
</simpara>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</section>
|
|
|
|
<section xml:id="openssl.pkcs7.flags">
|
|
<title><acronym>PKCS7</acronym> フラグ/定数</title>
|
|
<para>
|
|
S/MIME 関数はビットフィールドを使用して指定したフラグを使用します。
|
|
このビットフィールドには、以下の値を一つ以上含むことが可能です。
|
|
<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>
|
|
<literal>text/plain</literal> content type ヘッダを暗号化/署名されたメッセージに
|
|
追加します。復号化または認証を行う際には、このヘッダは出力から
|
|
取り除かれます。復号化または認証されたメッセージが <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>
|
|
メッセージを認証する際に、通常、メッセージに含まれる証明書が
|
|
証明書にサインする際に検索されます。
|
|
このオプションでは、
|
|
<function>openssl_pkcs7_verify</function> の
|
|
<parameter>untrusted_certificates_filename</parameter> パラメータで指定した証明書
|
|
のみが使用されます。しかし、指定された証明書を信頼されていな
|
|
い CA として使用することも可能です。
|
|
</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>
|
|
サインを行った側の証明書の認証の連鎖を行いません。
|
|
この場合、サイン付きのメッセージにある証明書を未認証の CA
|
|
として使用しません。
|
|
</entry>
|
|
</row>
|
|
<row xml:id="constant.pkcs7-nocerts">
|
|
<entry>
|
|
<constant>PKCS7_NOCERTS</constant>
|
|
(<type>int</type>)
|
|
</entry>
|
|
<entry>
|
|
メッセージにサインする際、通常はサインをする人の証明書が挿入
|
|
されますが、このオプションを指定した場合はそうなりません。これに
|
|
よりサイン付きのメッセージのサイズは小さくなりますが、認証
|
|
側が(例えば、<function>openssl_pkcs7_verify</function> の
|
|
<parameter>untrusted_certificates_filename</parameter> を用いて渡すことにより)
|
|
サインをした人の証明書のコピーをローカルに用意する必要があります。
|
|
</entry>
|
|
</row>
|
|
<row xml:id="constant.pkcs7-noattr">
|
|
<entry>
|
|
<constant>PKCS7_NOATTR</constant>
|
|
(<type>int</type>)
|
|
</entry>
|
|
<entry>
|
|
通常、メッセージがサインされる時、サインした時間やサポートされる
|
|
対象アルゴリズムを含む一連の属性が付加されます。このオプションを
|
|
指定した場合、それらの属性は付加されません。
|
|
</entry>
|
|
</row>
|
|
<row xml:id="constant.pkcs7-detached">
|
|
<entry>
|
|
<constant>PKCS7_DETACHED</constant>
|
|
(<type>int</type>)
|
|
</entry>
|
|
<entry>
|
|
メッセージにサインをする際、MIME型 <literal>"multipart/signed"</literal>
|
|
を指定してクリアテキストでサインを行います。これは、
|
|
<function>openssl_pkcs7_sign</function> において
|
|
フラグを指定しなかった場合の <parameter>flags</parameter>
|
|
パラメータのデフォルトです。このオプションをオフにした場合、
|
|
メッセージは不透明なサインによりサインされます。これは、
|
|
メールリレイによる変換に対してより耐性がありますが、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 以降で利用可能です。
|
|
メッセージを暗号化する場合に、content-type の値として
|
|
<literal>application/x-pkcs7-mime</literal> ではなく
|
|
<literal>application/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>
|
|
暗号化済み/署名済み のメッセージに対して 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> として用いる
|
|
"canonical" フォーマットに変換されます:
|
|
これは、CMS の仕様です。
|
|
このオプションが指定されると、変換は行われません。
|
|
これは、
|
|
CMS フォーマットではない可能性があるバイナリデータを扱うのに便利です。
|
|
</entry>
|
|
</row>
|
|
<row xml:id="constant.openssl-cms-nointern">
|
|
<entry>
|
|
<constant>OPENSSL_CMS_NOINTERN</constant>
|
|
(<type>int</type>)
|
|
</entry>
|
|
<entry>
|
|
メッセージを検証する際、
|
|
通常は(もしあれば)メッセージに含まれる証明書を
|
|
署名に用いた証明書として探します。
|
|
このオプションを使うと、
|
|
<function>openssl_cms_verify</function> 関数の
|
|
<parameter>untrusted_certificates_filename</parameter>
|
|
引数で指定した証明書だけを検証に使うようになります。
|
|
ここで証明書を指定しても、
|
|
それは信頼されない証明書のまま引き続き使われます。
|
|
</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>
|
|
メッセージに署名する場合、
|
|
通常は署名者の証明書がメッセージに付加されます -
|
|
このオプションを使うと、その証明書を除去できます。
|
|
証明書を除去すると、署名済みのメッセージのサイズが減りますが、
|
|
(たとえば、<function>openssl_cms_verify</function>
|
|
関数に <parameter>untrusted_certificates_filename</parameter>
|
|
を使って渡すなどして)
|
|
検証する側が署名者の証明書をローカルに持っておく必要があります。
|
|
</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> を使って、
|
|
平文で署名します。
|
|
これは、<function>openssl_cms_sign</function>
|
|
で何も <parameter>flags</parameter>
|
|
を指定しなかったときのデフォルトの動作です。
|
|
このオプションを無効にした場合、メッセージは
|
|
opaque 署名を使って署名されます。
|
|
これは、メールがリレーされる際の変換を防ぐ一方で、
|
|
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 以降で利用可能です。
|
|
メッセージを暗号化する場合に、content-type の値として
|
|
<literal>application/pkcs7-mime</literal> ではなく
|
|
<literal>application/x-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 サポートを有効にした場合だけになりました。
|
|
MD2 サポートを有効にするには、PHP のコンパイル時に
|
|
<literal>-DHAVE_OPENSSL_MD2_H</literal> CFLAG を渡し、かつ OpenSSL 1.0.0 以降のコンパイル時に
|
|
<literal>enable-md2</literal> を指定する必要があります。
|
|
</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>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>
|
|
この定数を使うには、
|
|
OpenSSL 0.9.8j 以降を使って PHP をビルドしている必要があります。
|
|
</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>
|
|
<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>
|
|
デフォルトでは、暗号化の操作は標準的なブロックパディングを使ってパディングされ、
|
|
追加されたパディングは、復号化される際にチェックされ、除去されます。
|
|
<function>openssl_encrypt</function> や <function>openssl_decrypt</function> の
|
|
<parameter>options</parameter> に <constant>OPENSSL_ZERO_PADDING</constant>
|
|
が指定された場合、パディングは行われないので、
|
|
暗号化または復号化されるデータの総量はブロックサイズの倍数でなければなりません。
|
|
そうでない場合、エラーが発生します。
|
|
</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>
|
|
形式であることを示します。
|
|
</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>
|
|
形式であることを示します。
|
|
</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
|
|
-->
|