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.

1.0.2a 1.0.2c                                      2015-12-31                 fr::ssl::SSL_CTX_set1_curves(3SSL)