openssl_csr_new
(PHP 4 >= 4.2.0, PHP 5, PHP 7)
openssl_csr_new — CSR を作成する
説明
openssl_csr_new
( array $dn
, resource &$privkey
[, array $configargs
[, array $extraattribs
]] ) : mixed
openssl_csr_new() は、新しい CSR (Certificate Signing Request)
を dn の情報に基づいて作成します。
注意:
この関数を正しく動作させるには、正しい形式の
openssl.cnfをインストールしておく必要があります。 詳細な情報は、インストールについてのセクション を参照ください。
パラメータ
dn証明書で使用される識別名、またはsubjectフィールド。
privkeyprivkeyには、事前に openssl_pkey_new() （あるいはその他の openssl_pkey 系の関数）で作成した秘密鍵を設定します。 これに対応する公開鍵が、CSR への署名に使用されます。configargsデフォルトでは、システムの
openssl.confの設定に したがってリクエストが初期化されます。configargsのキーconfig_section_sectionを設定することで、この デフォルト項目を変更することが可能です。また、キーconfigに別の openssl 設定ファイルを指定することで別の設定を使用することも可能です。 もしconfigargsに以下の表のキーが存在すれば、それらはopenssl.confの対応する項目と同じ働きをします。設定の上書き configargsのキー型 openssl.confで同等の意味を持つ項目説明 digest_alg string default_md ダイジェストメソッド、または署名のハッシュ。 通常は openssl_get_md_methods() 関数のリストのうちのひとつです。
x509_extensions string x509_extensions x509 証明書を作成する際に使用する拡張モジュールを選択します req_extensions string req_extensions CSR を作成する際に使用する拡張モジュールを選択します private_key_bits int default_bits 秘密鍵を作成する際に使用するビット数を指定します private_key_type int none 作成する秘密鍵の型を指定します。以下の定数 OPENSSL_KEYTYPE_DSA,OPENSSL_KEYTYPE_DHOPENSSL_KEYTYPE_RSAあるいはOPENSSL_KEYTYPE_ECからひとつ選択します。 デフォルト値はOPENSSL_KEYTYPE_RSAです。encrypt_key bool encrypt_key （パスフレーズとともに）エクスポートされるキーを暗号化するか? encrypt_key_cipher int none 暗号定数のうちの一つ。 curve_name string none openssl_get_curve_names() のうちの一つ。 config string N/A 代替の openssl.conf ファイルのパス extraattribsextraattribsは、CSR に関する追加の設定情報を 設定するために使用します。dnおよびextraattribsはどちらも連想配列で、それらの キーが OID に変換されたうえでリクエストの関連する部分に適用されます。
返り値
CSR を返します。
失敗した場合に false を返します
変更履歴
| バージョン | 説明 |
|---|---|
| 7.1.0 | configargs が、新たに curve_name をサポートしました。
|
例
例1 自己署名証明書の作成
<?php// SSLサーバ証明書では、commonName はセキュアにするドメインです。// S/MIME 電子メール証明書では、 commonName は電子メールアドレスのオーナーです。// location と identification フィールドは、セキュアにするドメイン// または電子メールのオーナーを参照します。$dn = array( "countryName" => "GB", "stateOrProvinceName" => "Somerset", "localityName" => "Glastonbury", "organizationName" => "The Brain Room Limited", "organizationalUnitName" => "PHP Documentation Team", "commonName" => "Wez Furlong", "emailAddress" => "wez@example.com");// 新しい 秘密鍵(と公開鍵の) キーペアを生成します$privkey = openssl_pkey_new(array( "private_key_bits" => 2048, "private_key_type" => OPENSSL_KEYTYPE_RSA,));// CSR を生成します$csr = openssl_csr_new($dn, $privkey, array('digest_alg' => 'sha256'));// 自己署名の証明書を生成します。365日有効です$x509 = openssl_csr_sign($csr, null, $privkey, $days=365, array('digest_alg' => 'sha256'));// 秘密鍵、CSR と自己署名証明書をあとで使うために保存します。openssl_csr_export($csr, $csrout) and var_dump($csrout);openssl_x509_export($x509, $certout) and var_dump($certout);openssl_pkey_export($privkey, $pkeyout, "mypassword") and var_dump($pkeyout);// 起きたエラーを表示します。while (($e = openssl_error_string()) !== false) { echo $e . "\n";}?>
例2 自己署名の ECC 証明書を作成する (PHP 7.1.0 以降)
<?php$subject = array( "commonName" => "docs.php.net",);// 新しい 秘密鍵(と公開鍵の) キーペアを生成します$private_key = openssl_pkey_new(array( "private_key_type" => OPENSSL_KEYTYPE_EC, "curve_name" => 'prime256v1',));// CSR を生成します$csr = openssl_csr_new($subject, $private_key, array('digest_alg' => 'sha384'));// 自己署名のEC証明書を生成します。$x509 = openssl_csr_sign($csr, null, $private_key, $days=365, array('digest_alg' => 'sha384'));openssl_x509_export_to_file($x509, 'ecc-cert.pem');openssl_pkey_export_to_file($private_key, 'ecc-private.key');?>
