Provided by: manpages-fr-extra_20151231_all bug

NOM

       genpkey - Générer une clef privée

SYNOPSIS

       openssl genpkey [-out fichier] [-outform PEM|DER] [-pass param] [-cipher] [-engine identifiant]
       [-paramfile fichier] [-algorithm algorithme] [-pkeyopt opt:valeur] [-genparam] [-text]

DESCRIPTION

       La commande genpkey génère une clef privée.

OPTIONS

       -out fichier
           Le fichier de sortie. S'il n'est pas indiqué, la sortie standard est utilisée.

       -outform DER|PEM
           Cela indique le format de sortie DER ou PEM.

       -pass param
           La  source  de  mot  de passe pour le fichier de sortie. Pour plus de renseignements sur le format de
           param, consultez la section PARAMÈTRES DE PHRASE SECRÈTE d'openssl(1).

       -cipher
           Cette option indique de chiffrer  la  clef  privée  avec  l’algorithme  fourni.  N’importe  quel  nom
           d’algorithme accepté par EVP_get_cipherbyname() est acceptable, comme par exemple des3.

       -engine identifiant
           L’indication  d’un moteur (en utilisant son identifiant unique identifiant) forcera genpkey à essayer
           d'obtenir une référence fonctionnelle pour le moteur indiqué et à  l'initialiser  si  nécessaire.  Le
           moteur  sera  ensuite utilisé par défaut pour tous les algorithmes disponibles. Si elle est utilisée,
           cette option devrait être indiquée avant toutes les autres options.

       -algorithm algorithme
           L’algorithme à clef publique à utiliser, comme par exemple RSA, DSA ou DH. Si utilisée, cette  option
           doit être indiquée avant toutes les options -pkeyopt. Les options -paramfile et -algorithm s’excluent
           mutuellement.

       -pkeyopt opt:valeur
           Définir  l’option  d’algorithme  à  clef  publique opt à valeur. L’ensemble exact d’options prises en
           charge dépend de l’algorithme à clef publique utilisé et de son implémentation. Consultez la  section
           OPTIONS DE GÉNÉRATION DE CLEF ci-dessous pour plus de précisions.

       -genparam
           Générer  un  ensemble  de  paramètres  au lieu d’une clef privée. Si utilisée, cette option doit être
           indiquée avant les options -algorithm, -paramfile et -pkeyopt.

       -paramfile fichier
           Certains algorithmes à clef publique génèrent une clef publique à partir d’un ensemble de paramètres.
           Ils peuvent être fournis en utilisant cette option. Si cette option est utilisée, l’algorithme à clef
           publique utilisé est déterminé par les paramètres. Si utilisée, cette option doit être indiquée avant
           les options -pkeyopt. Les options -paramfile et -algorithm s’excluent mutuellement.

       -text
           Afficher une représentation au format texte (en clair) des clefs privée et publique et des paramètres
           avec la structure PEM ou DER.

OPTIONS DE GÉNÉRATION DE CLEF

       Les options prises en charge par un algorithme et même par chaque implémentation d’un algorithme  peuvent
       varier. Les options pour les implémentations d’OpenSSL sont précisées ci-dessous.

OPTIONS DE GÉNÉRATION DE CLEF RSA

       rsa_keygen_bits:nombrebits
           Le nombre de bits dans la clef générée. Sans indication, 1024 est utilisé.

       rsa_keygen_pubexp:valeur
           La  valeur  d’exposant  public  RSA.  Cela  peut  être  une grande valeur décimale ou hexadécimale si
           précédée de 0x. La valeur par défaut est 65537.

OPTIONS DE GÉNÉRATION DE PARAMÈTRES DSA

       dsa_paramgen_bits:nombrebits
           Le nombre de bits dans les paramètres générés. Sans indication, 1024 est utilisé.

OPTIONS DE GÉNÉRATION DE PARAMÈTRES DH

       dh_paramgen_prime_len:nombrebits
           Le nombre de bits dans le paramètre p de nombre premier.

       dh_paramgen_generator:valeur
           La valeur à utiliser pour le générateur g.

       dh_rfc5114:num
           Si cette option est définie, les paramètres RFC 5114 adéquats sont utilisés au  lieu  d’en  créer  de
           nouveaux.  La  valeur  num  peut prendre la valeur 1, 2 ou 3 correspondant aux paramètres DH RFC 5114
           constitués d’un groupe de 1024 bits avec un sous-groupe de 160 bits, d’un groupe de 2048 bits avec un
           sous-groupe de 224 bits ou d’un groupe de 2048 bits avec un sous-groupe de 256 bits conformément  aux
           sections 2.1, 2.2 et 2.3 de la RFC 5114.

OPTIONS DE GÉNÉRATION DE PARAMÈTRES EC

       ec_paramgen_curve:courbe
           La courbe EC à utiliser.

OPTIONS DE GÉNÉRATION DE CLEF GOST2001 ET DE PARAMÈTRES

       La  prise  en  charge  de  Gost 2001 n’est pas activée par défaut. Pour activer cet algorithme, le moteur
       ccgost devrait être chargé dans le fichier de configuration  d’OpenSSL.  Consultez  README.gost  dans  le
       répertoire engines/ccgost de la distribution des sources pour plus de précisions.

       Utiliser  un  fichier de paramètres pour l’algorithme GOST R 34.10 est facultatif. Les paramètres peuvent
       être indiqués directement lors de la génération de clef ainsi que pendant la  génération  du  fichier  de
       paramètres.

       paramset:nom
           Indiquer  l’ensemble  de  paramètres  GOST R 34.10-2001 d’après la RFC 4357. L’ensemble de paramètres
           peut être indiqué à l’aide de nom abrégé, nom court  d’objet  ou  OID  numérique.  Les  ensembles  de
           paramètres suivants sont pris en charge :

             ensemble   OID               Utilisation
             A          1.2.643.2.2.35.1  Signature
             B          1.2.643.2.2.35.2  Signature
             C          1.2.643.2.2.35.3  Signature
             XA         1.2.643.2.2.36.0  Échange de clef
             XB         1.2.643.2.2.36.1  Échange de clef
             test       1.2.643.2.2.35.0  Test

NOTES

       L’utilisation  du  programme  genpkey  est  préférable aux utilitaires spécifiques à l’algorithme car des
       options d’algorithme supplémentaires et des algorithmes fournis par ENGINE peuvent être utilisés.

EXEMPLES

       Générer une clef privée RSA en utilisant les paramètres par défaut :

        openssl genpkey -algorithm RSA -out clef.pem

       Chiffrer une clef privée en utilisant un AES 128 bits et la phrase secrète « salut » :

        openssl genpkey -algorithm RSA -out clef.pem -aes-128-cbc \
                                       -pass pass:salut

       Créer une clef RSA de 2048 bits en utilisant 3 comme exposant public :

        openssl genpkey -algorithm RSA -out clef.pem \
                                       -pkeyopt rsa_keygen_bits:2048 \
                                       -pkeyopt rsa_keygen_pubexp:3

       Générer des paramètres DSA de 1024 bits :

        openssl genpkey -genparam -algorithm DSA -out pdsa.pem \
                                  -pkeyopt dsa_paramgen_bits:1024

       Créer une clef DSA à partir de paramètres :

        openssl genpkey -paramfile pdsa.pem -out clefdsa.pem

       Générer des paramètres DH de 1024 bits :

        openssl genpkey -genparam -algorithm DH -out pdh.pem \
                                  -pkeyopt dh_paramgen_prime_len:1024

       Afficher les paramètres DH RFC 5114 sur 2048 bits avec un sous-groupe de 224 bits :

        openssl genpkey -genparam -algorithm DH -out pdh.pem \
                                  -pkeyopt dh_rfc5114:2

       Créer une clef DH à partir de paramètres :

        openssl genpkey -paramfile pdh.pem -out clefdh.pem

TRADUCTION

       La traduction de cette page de manuel est maintenue par les membres de la  liste  <debian-l10n-french  AT
       lists  DOT  debian  DOT org>. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le
       paquet manpages-fr-extra.

1.0.2a 1.0.2c                                      2015-12-31                                      GENPKEY(1SSL)