NOM

       SSL_CTX_new - Créer un nouvel objet SSL_CTX comme cadre pour les fonctions avec TLS/SSL
       actif.

SYNOPSIS

        #include <openssl/ssl.h>

        SSL_CTX *SSL_CTX_new(const SSL_METHOD *method);

DESCRIPTION

       SSL_CTX_new() crée un nouvel objet SSL_CTX comme cadre pour établir des connexions avec
       TLS/SSL actif.

NOTES

       L'objet SSL_CTX utilise method comme méthode de connexion. Il existe des méthodes de type
       générique (pour utilisation client et serveur), un type uniquement serveur et un type
       uniquement client.method peut appartenir aux types suivants :

       SSLv2_method(void), SSLv2_server_method(void), SSLv2_client_method(void)
           Une connexion TLS/SSL établie avec ces méthodes ne comprendra que le protocole SSLv2.
           Un client enverra des messages hello client SSLv2 et indiquera qu'il ne comprend que
           SSLv2. Un serveur ne comprendra que les messages hello du client SSLv2.

       SSLv3_method(void), SSLv3_server_method(void), SSLv3_client_method(void)
           Un connexion TLS/SSL établie avec ces méthodes ne comprendra que le protocole SSLv3.
           Un client enverra des messages hello client SSLv3 et indiquera qu'il ne comprend que
           SSLv3. Un serveur ne comprendra que les messages hello client SSLv3. Cela veut surtout
           dire qu'il ne comprendra pas les messages hello client SSLv2 qui sont couramment
           utilisés pour des raisons de compatibilité. Voir SSLv23_*_method().

       TLSv1_method(void), TLSv1_server_method(void), TLSv1_client_method(void)
           Une connexion  TLS/SSL établie avec ces méthodes ne comprendra que le protocole TLSv1.
           Un client enverra des messages hello TLSv1 et indiquera qu'il ne comprend que TLSv1.
           Un serveur ne comprendra que les messages hello client TLSv1. Cela veut surtout dire
           qu'il ne comprendra pas les messages hello client SSLv2 qui sont couramment utilisés
           pour des raisons de compatibilité. Voir SSLv23_*_method(). Il ne comprendra pas non
           plus les messages hello client SSLv3.

       SSLv23_method(void), SSLv23_server_method(void), SSLv23_client_method(void)
           Une connexion TLS/SSL établie avec ces méthodes peut comprendre les protocoles SSLv2,
           SSLv3, TLSv1, TLSv1.1 et TLSv1.2

           Si la liste de chiffrements ne contient pas d’ensemble de chiffrements SSLv2 (la liste
           par défaut de chiffrements n'existe pas), ou si des extensions sont nécessaires (par
           exemple le nom de serveur), un client enverra des messages hello client TLSv1 incluant
           des extensions et indiquera qu'il comprend aussi TLSv1.1, TLSv1.2 et permettra de se
           rabattre sur SSLv3. Un serveur gérera les protocoles SSLv3, TLSv1, TLSv1.1 et TLSv1.2.
           C'est le meilleur choix s'il y a un souci de compatibilité.

           S'il existe des ensembles de chiffrement SSLv2 dans la liste de chiffrements, et si
           aucune extension n'est nécessaire, les clients utiliseront des hellos compatibles
           SSLv2, et SSLv2 sera accepté par les serveurs. Cela n'est pas recommandé en raison du
           caractère non sécurisé de SSLv2 et de la nature limitée du hello client SSLv2 qui
           interdit l'utilisation d'extensions.

       La liste des protocoles disponibles peut être ultérieurement limitée en utilisant les
       options SSL_OP_NO_SSLv2, SSL_OP_NO_SSLv3, SSL_OP_NO_TLSv1, SSL_OP_NO_TLSv1_1 et
       SSL_OP_NO_TLSv1_2 des fonctions SSL_CTX_set_options() ou SSL_set_options(). Avec ces
       options, il est possible de choisir SSLv23_server_method() par exemple et de pouvoir
       négocier avec tous les clients possibles, mais de n'autoriser que les protocoles les plus
       récents comme TLSv1, TLSv1.1 ou TLS v1.2.

       Des applications qui ne veulent jamais prendre en charge SSLv2 (même si la chaîne de
       chiffrements est configurée pour utiliser les ensembles de chiffrement SSLv2) peuvent
       utiliser l'option SSL_OP_NO_SSLv2.

       SSL_CTX_new() initialise la liste de chiffrements, la configuration du cache de sessions,
       le rappel, les clés et les certificats, ainsi que les options de ses valeurs par défaut.

VALEURS DE RETOUR

       Les valeurs suivantes peuvent être renvoyées :

       NULL
           La création d'un nouvel objet SSL_CTX a échoué. Vérifiez la pile d'erreur pour
           découvrir la raison de l'échec.

       Pointeur vers un objet SSL_CTX
           La valeur renvoyée pointe vers un objet SSL_CTX alloué.

VOIR AUSSI

       SSL_CTX_free(3), SSL_accept(3),ssl(3), SSL_set_connect_state(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.