NOM

       SSL_CTX_set1_curves, SSL_CTX_set1_curves_list, SSL_set1_curves, SSL_set1_curves_list,
       SSL_get1_curves, SSL_get_shared_curve, SSL_CTX_set_ecdh_auto, SSL_set_ecdh_auto -
       Fonctions de courbes elliptiques prises en charge

SYNOPSIS

        #include <openssl/ssl.h>

        int SSL_CTX_set1_curves(SSL_CTX *ctx, int *clist, int clistlen);
        int SSL_CTX_set1_curves_list(SSL_CTX *ctx, char *list);

        int SSL_CTX_set1_curves(SSL *ssl, int *clist, int clistlen);
        int SSL_CTX_set1_curves_list(SSL *ssl, char *list);

        int SSL_get1_curves(SSL *ssl, int *curves);
        int SSL_get_shared_curve(SSL *s, int n);

        int SSL_CTX_set_ecdh_auto(SSL_CTX *ctx, int onoff);
        int SSL_set_ecdh_auto(SSL *s, int onoff);

DESCRIPTION

       SSL_CTX_set1_curves() définit les courbes elliptiques prises en charge pour ctx à clistlen
       courbes dans le tableau clist. Le tableau est constitué de tous les identifiants de courbe
       dans l’ordre de préférence. Pour un client TLS, les courbes sont utilisées directement
       dans l’extension prise en charge. Pour un serveur TLS, les courbes sont utilisées pour
       déterminer l’ensemble des courbes partagées.

       SSL_CTX_set1_curves_list() définit les courbes prises en charge pour ctx dans la chaîne
       list. La chaîne est constituée d’une liste de noms ou identifiants séparés par des deux
       points, par exemple « P-521:P-384:P-256 ».

       SSL_set1_curves() et SSL_set1_curves_list() sont similaires aux précédentes sauf qu’elles
       définissent les courbes prises en charge pour les structures SSL ssl.

       SSL_get1_curves() renvoie l’ensemble des courbes prises en charge par un client dans
       l’extension des courbes prises en charge. Elle renvoie le nombre total de courbes prises
       en charge. Le paramètre curves peut être NULL pour simplement renvoyer le nombre de
       courbes dans le but d’allouer de la mémoire. Le tableau curves est sous la forme d’un
       ensemble d’identifiants de courbe dans un ordre préférentiel. Elle peut renvoyer 0 si le
       client ne renvoie pas d’extension de courbes prises en charge.

       SSL_get_shared_curve() renvoie n courbes partagées pour un SSL du côté serveur ssl. Si n
       est égal à -1, alors le nombre total de courbes partagées est renvoyé, et peut valoir
       zéro. Autrement que pour des buts de diagnostic, la plupart des applications ne seront
       intéressées que par la première courbe partagée, aussi n est normalement réglé à zéro. Si
       la valeur de n est hors limites, NID_undef est renvoyé.

       SSL_CTX_set_ecdh_auto() et SSL_set_ecdh_auto() règlent la sélection automatique de courbes
       pour le serveur ctx ou ssl à onoff. Si onoff vaut 1, alors la courbe de plus haute
       préférence est automatiquement employée pour les clefs temporaires ECDH utilisées durant
       l’échange de clefs.

       Toutes ces fonctions sont implémentées en utilisant des macros.

NOTES

       Si une application désire utiliser plusieurs de ces fonctions pour des besoins de
       configuration, soit en ligne de commande ou avec un fichier, l’utilisation de l’interface
       SSL_CONF est à préférer à l’analyse manuelle des options.

       Les fonctions SSL_CTX_set_ecdh_auto() et SSL_set_ecdh_auto() peuvent être utilisées pour
       qu’un serveur choisisse toujours la courbe la plus appropriée pour un client. Dans ce cas,
       les paramètres temporaires ECDH définis par le serveur seront outrepassés. Les versions
       précédentes d’OpenSSL pouvaient effectivement seulement utiliser une seule courbe ECDH
       définie en employant une fonction telle que SSL_CTX_set_ecdh_tmp(). Les nouvelles
       applications doivent juste appeler :

        SSL_CTX_set_ecdh_auto(ctx, 1);

       et elles prendront en charge ECDH automatiquement en utilisant la courbe partagée la plus
       adéquate.

VALEURS DE RETOUR

       SSL_CTX_set1_curves(), SSL_CTX_set1_curves_list(), SSL_set1_curves(),
       SSL_set1_curves_list(), SSL_CTX_set_ecdh_auto() et SSL_set_ecdh_auto() renvoient 1 en cas
       de réussite et 0 lors d’un échec.

       SSL_get1_curves() renvoie le nombre de courbes, pouvant être zéro.

       SSL_get_shared_curve() renvoie l’identifiant de la courbe partagée n ou NID_undef s’il
       n’existe pas de courbe partagée n, ou le nombre total de courbes partagées si n vaut -1.

       Lorsqu’appelée sur un client ssl, SSL_get_shared_curve() ne signifie rien et renvoie -1.

VOIR AUSSI

       SSL_CTX_add_extra_chain_cert(3)

HISTORIQUE

       Ces fonctions ont été introduites dans OpenSSL 1.0.2

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.