openssl_csr_new() génère une nouvelle CSR
(Certificate Signing Request,
requête de signature de certificat), basée sur les informations fournies par
dn
, qui représente le nom unique
(Distinguished Name) qui doit être utilisé pour ce certificat.
privkey
doit être une clé privée qui a été
générée par openssl_pkey_new() (ou
obtenue autrement par l'une des fonctions de la famille openssl_pkey)
La clé publique sera utilisée pour signer la CSR.
extraattribs
est utilisé pour spécifier
des options de configuration supplémentaires pour la CSR. Les deux
paramètres dn
et
extraattribs
sont des tableaux associatifs dont les
clés sont converties en OIDs et appliquées aux parties appropriées de la
requête.
Note : Vous devez installer un fichier openssl.cnf valide pour que cette fonction opère correctement. Voyez les notes dans la section installation pour plus d'informations.
Par défaut, les informations du fichier openssl.conf
de votre système sont utilisées pour initialiser la requête ; vous pouvez
spécifier une section du fichier de configuration en utilisant l'index
config_section_section du tableau
configargs
. Vous pouvez aussi
spécifier une configuration OpenSSL alternative en utilisant l'index
config, et en lui donnant la valeur du chemin à
utiliser. Les index suivants, si fournis dans le paramètre
configargs
, se comportent comme leur équivalent
du fichier openssl.conf, tel qu'indiqué ci-dessous.
Tableau 1. Adaptation des configurations
Index configargs | Type | Equivalent openssl.conf | Description |
---|---|---|---|
digest_alg | chaîne de caractères | default_md | Sélectionne la méthode "digest" à utiliser |
x509_extensions | chaîne de caractères | x509_extensions | Sélectionne quelles extensions doivent être utilisées lors de la création du certificat x509 |
req_extensions | chaîne de caractères | req_extensions | Sélectionne quelles extensions doivent être utilisées lors de la création d'une CSR |
private_key_bits | entier | default_bits | Spécifie le nombre de bits à utiliser lors de la génération de la clé privée |
private_key_type | entier | none | Spécifie le type de clé privée à générer. Cela peut être l'une des constantes suivantes : OPENSSL_KEYTYPE_DSA, OPENSSL_KEYTYPE_DH ou OPENSSL_KEYTYPE_RSA. La valeur par défaut est OPENSSL_KEYTYPE_RSA, ce qui est le seul type de clé actuellement supporté. |
encrypt_key | booléen | encrypt_key | Doit être une clé exportée (avec mot de passe) qui sera chiffrée? |
Cette fonction retourne TRUE en cas de succès, FALSE en cas d'échec.
Précédent | Sommaire | Suivant |
openssl_csr_get_subject | Niveau supérieur | openssl_csr_sign |