openssl_csr_sign
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
openssl_csr_sign — CSR に他の証明書(あるいは自分自身)で署名して証明書を作成する
説明
OpenSSLCertificateSigningRequest|string
$csr
,OpenSSLCertificate|string|null
$ca_certificate
,#[\SensitiveParameter] OpenSSLAsymmetricKey|OpenSSLCertificate|array|string
$private_key
,int
$days
,?array
$options
= null
,int
$serial
= 0,?string
$serial_hex
= null
): OpenSSLCertificate|false
openssl_csr_sign() は、 指定した CSR を用いて x509 証明書を作成します。
注意: この関数を正しく動作させるには、正しい形式の openssl.cnf をインストールしておく必要があります。 詳細な情報は、インストールについてのセクション を参照ください。
パラメータ
csr
-
事前に openssl_csr_new() で作成した CSR。 file://path/to/csr のように指定された PEM エンコードされた CSR へのパス、 あるいは openssl_csr_export() で生成した文字列も使用可能です。
ca_certificate
-
作成された証明書は
ca_certificate
で署名されます。ca_certificate
がnull
の場合は、自己署名の証明書となります。 private_key
-
private_key
はca_certificate
に対応する秘密鍵です。 days
-
days
は、作成された証明書の有効期限を日数で指定します。 options
-
options
で CSR の詳細設定が可能です。options
についての詳細な情報は openssl_csr_new() を参照ください。 serial
-
発行される証明書のシリアル番号を、オプションで指定します。 省略した場合のデフォルトは 0 です。
戻り値
成功した場合に OpenSSLCertificate オブジェクト。
失敗した場合に false
を返します。
変更履歴
バージョン | 説明 |
---|---|
8.0.0 |
成功した場合に、この関数は
OpenSSLCertificate クラスのインスタンスを返すようになりました。
これより前のバージョンでは、
OpenSSL X.509 型のリソースを返していました。
|
8.0.0 |
csr は、
OpenSSLCertificateSigningRequest のインスタンスを受け入れるようになりました。
これより前のバージョンでは、
OpenSSL X.509 CSR 型のリソースを受け入れていました。
|
8.0.0 |
ca_certificate は、
OpenSSLCertificate クラスのインスタンスを受け入れるようになりました。
これより前のバージョンでは、
OpenSSL X.509 型のリソースを受け入れていました。
|
8.0.0 |
private_key は、
OpenSSLAsymmetricKey または
OpenSSLCertificate クラスのインスタンスを受け入れるようになりました。
これより前のバージョンでは、
OpenSSL key または
OpenSSL X.509 型のリソースを受け入れていました。
|
例
例1 openssl_csr_sign() の例 - CSR に署名する(あなた自身の CA を作成する)
<?php
// このスクリプトでは、前のページのテキストエリアから受け取った
// CSR を利用すると仮定します。
$csrdata = $_POST["CSR"];
// ここでは自己認証局の証明書を用いて署名要求に署名します。
// どんな証明書でも署名は可能ですが、署名に用いる証明書が
// 新たに署名される証明書を取り扱うであろうソフトウェアや
// ユーザーらに信頼されていない限り、その手続きは無意味です。
// 自己認証局証明書とその秘密鍵が必要です。
$cacert = "file://path/to/ca.crt";
$privkey = array("file://path/to/ca.key", "your_ca_key_passphrase");
$usercert = openssl_csr_sign($csrdata, $cacert, $privkey, 365, array('digest_alg'=>'sha256') );
// ユーザーがローカル設定(SSL サーバー用の証明書
// ファイルなど)にコピー&ペーストできるように
// 作成された証明書をそのまま表示します。
openssl_x509_export($usercert, $certout);
echo $certout;
// 発生したエラーをすべて表示します。
while (($e = openssl_error_string()) !== false) {
echo $e . "\n";
}
?>
User Contributed Notes 4 notes
Here is an sample how to create valid X.509 Public and Private Key (cert/key).
When not using self signed the 4.2.1 segault. You need the CVS code at least for openssl.
<?
Header("Content-Type: text/plain");
$CA_CERT = "CA.cert.pem";
$CA_KEY = "CA.key.pem";
$req_key = openssl_pkey_new();
if(openssl_pkey_export ($req_key, $out_key)) {
$dn = array(
"countryName" => "DE",
"stateOrProvinceName" => "Frankfurt",
"organizationName" => "smcc.net",
"organizationalUnitName" => "E-Mail",
"commonName" => "Testcert"
);
$req_csr = openssl_csr_new ($dn, $req_key);
$req_cert = openssl_csr_sign($req_csr, "file://$CA_CERT", "file://$CA_KEY", 365);
if(openssl_x509_export ($req_cert, $out_cert)) {
echo "$out_key\n";
echo "$out_cert\n";
}
else echo "Failed Cert\n";
}
else echo "FailedKey\n";
?>
To generate a self-signed certificate, pass NULL as the signing certificate (2nd parameter). For example:
$req_key = openssl_pkey_new();
$dn = array(
"countryName" => "US",
"stateOrProvinceName" => "Colorado",
"organizationName" => "yPass.net",
"organizationalUnitName" => "yPass.net",
"commonName" => "yPass.net Root Certificate"
);
$req_csr = openssl_csr_new($dn, $req_key);
$req_cert = openssl_csr_sign($req_csr, NULL, $req_key, 365);
config_section_section is incorrect. The correct keyword to use is "config_section_name".
You can use file_get_contents() to directly pass the content instead of giving file paths.
Also, if you get an error "sec_error_reused_issuer_and_serial", put a serial into the last parameter:
<?php
$privkey = array(file_get_contents('ca.key'),"your_ca_key_passphrase");
$usercert = openssl_csr_sign($csrdata, file_get_contents('ca.crt'),$privkey,365,NULL,'06');
openssl_x509_export($usercert,$certout);
file_put_contents('serverCASigned.crt',$certout);
?>
In that above example the serial was "06".