Description

openssl_csr_sign(
    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() génère un certificat x509 depuis le CSR donnée.

Note: Vous devez avoir un fichier openssl.cnf valide et installé pour que cette fonction opère correctement. Voir les notes se trouvant dans la section concernant l'installation pour plus d'informations.

Liste de paramètres

csr: Une CSR générée précédemment par openssl_csr_new(). Mais ceci peut aussi être le chemin vers une CSR encodée au format PEM si spécifiée avec file://path/to/csr ou une chaîne exportée générée par openssl_csr_export().
ca_certificate: Le certificat généré sera signé par le certificat ca_certificate. Si ca_certificate vaut null, le certificat généré sera autosigné.
private_key: private_key est la clé privée qui correspond au certificat ca_certificate.
days: days spécifie la durée pour laquelle le certificat est valide, en nombre de jours.
options: Il est possible d'affiner la signature CSR avec options. Voir la fonction openssl_csr_new() pour plus d'informations sur options.
serial: Un numéro de série optionnel pour le certificat émis. S'il n'est pas spécifié, il vaudra 0.
serial_hex: Une chaîne hexadécimale facultative représentant le numéro de série du certificat émis. Si elle est définie, elle a la priorité sur la valeur du paramètre serial. Si elle n’est pas spécifiée ou qu’elle est définie à null, la valeur du paramètre serial est alors utilisée à la place.

Valeurs de retour

Retourne une OpenSSLCertificate en cas de succès, false sinon.

Historique

Version	Description
8.4.0	Le paramètre `serial_hex` a été ajouté.
8.0.0	En cas de succès, cette fonction retourne désormais une instance de OpenSSLCertificate ; auparavant une resource de type `OpenSSL X.509` était retournée.
8.0.0	`csr` accepte désormais une instance de OpenSSLCertificateSigningRequest ; auparavant, une resource de type `OpenSSL X.509 CSR` était acceptée.
8.0.0	`ca_certificate` accepte désormais une instance de OpenSSLCertificate ; auparavant, une resource de type `OpenSSL X.509` était acceptée.
8.0.0	`ca_certificate` accepte désormais une instance de OpenSSLAsymmetricKey ou OpenSSLCertificate ; auparavant, une resource de type `OpenSSL key` ou `OpenSSL X.509` était acceptée.

Exemples

Exemple #1 Exemple avec openssl_csr_sign() - signer une CSR (comment être le propre Autorité de Certification)

<?php
// Supposons que ce script est configuré pour recevoir des CSR qui ont
// été collés dans un champ textarea depuis une autre page
$csrdata = $_POST["CSR"];

// Nous allons signer la requête avec notre propre certificat, en tant 
// qu'"autorité de certification". Vous pouvez utiliser n'importe quel
// certificat pour en signer un autre, mais le processus est inutile à moins
// que le certificat de signature n'ait la confiance des utilisateurs
// qui utiliseront le nouveau certificat signé.

// Nous avons besoin de notre certificat et de la clé privée
$cacert = "file://path/to/ca.crt";
$privkey = array("file://path/to/ca.key", "la_cle_secrete_de_votre_certificat");

$usercert = openssl_csr_sign($csrdata, $cacert, $privkey, 365, array('digest_alg'=>'sha256') );

// Affichons maintenant le certificat généré, de façon à ce que l'utilisateur
// puisse le copier/coller dans sa configuration locale (comme un
// fichier qui contient les certificats de son serveur SSL)
openssl_x509_export($usercert, $certout);
echo $certout;

// Affiche toutes les erreurs survenues
while (($e = openssl_error_string()) !== false) {
    echo $e . "\n";
}
?>