NOM

       dh - Échange de clés Diffie-Hellman

SYNOPSIS

        #include <openssl/dh.h>
        #include <openssl/engine.h>

        DH *   DH_new(void);
        void   DH_free(DH *dh);

        int    DH_size(const DH *dh);

        DH *   DH_generate_parameters(int prime_len, int generator,
                       void (*callback)(int, int, void *), void *cb_arg);
        int    DH_check(const DH *dh, int *codes);

        int    DH_generate_key(DH *dh);
        int    DH_compute_key(unsigned char *key, BIGNUM *pub_key, DH *dh);

        void DH_set_default_method(const DH_METHOD *meth);
        const DH_METHOD *DH_get_default_method(void);
        int DH_set_method(DH *dh, const DH_METHOD *meth);
        DH *DH_new_method(ENGINE *engine);
        const DH_METHOD *DH_OpenSSL(void);

        int DH_get_ex_new_index(long argl, char *argp, int (*new_func)(),
                    int (*dup_func)(), void (*free_func)());
        int DH_set_ex_data(DH *d, int idx, char *arg);
        char *DH_get_ex_data(DH *d, int idx);

        DH *   d2i_DHparams(DH **a, unsigned char **pp, long length);
        int    i2d_DHparams(const DH *a, unsigned char **pp);

        int    DHparams_print_fp(FILE *fp, const DH *x);
        int    DHparams_print(BIO *bp, const DH *x);

DESCRIPTION

       Ces fonctions implémentent le protocol d'échange de clés Diffie-Hellman. La génération de paramètres DH
       partagés est décrite dans DH_generate_parameters(3) ; DH_generate_key(3) décrit comment effectuer
       l'échange des clés.

       La structure DH consiste en plusieurs composants BIGNUM.

        struct
               {
               BIGNUM *p;              // nombre premier (partagé)
               BIGNUM *g;              // générateur de Z_p (partagé)
               BIGNUM *priv_key;       // valeur DH privée x
               BIGNUM *pub_key;        // valeur DH publique g^x
               // ...
               };
        DH

       Notez que les clés DH peuvent utiliser des implémentation DH_METHOD non standard, soit directement, soit
       en utilisant des modules ENGINE. Dans certains cas (par exemple un ENGINE fournissant la gestion de clés
       matérielle embarquées), ces valeurs BIGNUM ne seront pas utilisées par l'implémentation ou peuvent être
       utilisées pour le stockage de d'autres données. Pour cette raison, les applications devraient
       généralement éviter d'utiliser les éléments de la structure DH directement et devraient à la place
       utiliser les fonctions de l'API pour demander ou modifier les clés.

VOIR AUSSI

       dhparam(1), bn(3), dsa(3), err(3), rand(3), rsa(3), engine(3), DH_set_method(3), DH_new(3),
       DH_get_ex_new_index(3), DH_generate_parameters(3), DH_compute_key(3), d2i_DHparams(3), RSA_print(3)

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.