Edit Report a Bug

    openssl_csr_sign

    (PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

    openssl_csr_sign — CSR に他の証明書（あるいは自分自身）で署名して証明書を作成する

    説明

    openssl_csr_sign(
        OpenSSLCertificateSigningRequest|string $csr,
        OpenSSLCertificate|string|null $ca_certificate,
        OpenSSLAsymmetricKey|OpenSSLCertificate|array|string $private_key,
        int $days,
        ?array $options = null,
        int $serial = 0
    ): 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";
    }
    ?>

    add a note add a note

    User Contributed Notes 4 notes

    up
    0
    Sriraam
    9 years ago
    config_section_section is incorrect. The correct keyword to use is "config_section_name".
    up
    0
    thomas dot lussnig at bewegungsmelder dot de
    22 years ago
    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";
    ?>
    up
    0
    eric at ypass dot net
    22 years ago
    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);
    up
    -4
    Kai Sellgren
    15 years ago
    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".
    add a note add a note
    To Top