NOM

       SSL_CTX_set_msg_callback, SSL_CTX_set_msg_callback_arg, SSL_set_msg_callback, SSL_get_msg_callback_arg -
       Installer le rappel pour l’observation des messages de protocole

SYNOPSIS

        #include <openssl/ssl.h>

        void SSL_CTX_set_msg_callback(SSL_CTX *ctx, void (*cb)(int write_p, int version, int content_type, const
       void *tamp, size_t taille, SSL *ssl, void *arg));
        void SSL_CTX_set_msg_callback_arg(SSL_CTX *ctx, void *arg);

        void SSL_set_msg_callback(SSL *ssl, void (*cb)(int write_p, int version, int content_type, const void
       *tamp, size_t taille, SSL *ssl, void *arg));
        void SSL_set_msg_callback_arg(SSL *ssl, void *arg);

DESCRIPTION

       SSL_CTX_set_msg_callback() ou SSL_set_msg_callback() peuvent être utilisées pour définir une fonction de
       rappel de message cb pour observer tous les messages de protocole SSL/TLS (tels des messages d’initiation
       de connexion) qui sont reçus ou envoyés. SSL_CTX_set_msg_callback_arg() et SSL_set_msg_callback_arg()
       peuvent être utilisées pour définir l’argument arg de la fonction de rappel, qui est disponible pour
       toute application.

       SSL_CTX_set_msg_callback() et SSL_CTX_set_msg_callback_arg() précisent les réglages par défaut qui seront
       copiés dans les nouveaux objets SSL par SSL_new(3). SSL_set_msg_callback() et SSL_set_msg_callback_arg()
       changent les réglages existants d’un objet SSL. L’utilisation d’un pointeur 0 pour cb désactive le rappel
       de messages.

       Quand cb est appelé par la bibliothèque SSL/TLS pour un message de protocole, les arguments de la
       fonction ont les significations suivantes :

       write_p
           Cet indicateur est 0 lorsqu’un message de protocole est reçu et 1 lorsqu’un message est envoyé.

       version
           La  version du protocole à partir de laquelle la bibliothèque interprètera les messages de protocole.
           Actuellement c’est une parmi SSL2_VERSION, SSL3_VERSION et TLS1_VERSION (pour SSL  2.0,  SSL  3.0  et
           TLS 1.0, respectivement).

       content_type
           Pour  SSL  2.0,  c’est  toujours  0.  Pour  SSL  3.0 ou TLS 1.0, c’est une des valeurs de ContentType
           définies dans les spécifications de protocole  (change_cipher_spec(20),  alert(21),  handshake(22)  ;
           mais jamais application_data(23) car le rappel n’est demandé que pour des messages de protocole.

       tamp, taille
           tamp  pointe  vers un tampon contenant le message de protocole qui est constitué de taille octets. Le
           tampon n’est plus valable après que la fonction de rappel s'est terminée.

       ssl L’objet SSL qui a reçu ou envoyé le message.

       arg L’argument défini par l’utilisateur, facultativement  défini  par  SSL_CTX_set_msg_callback_arg()  ou
           SSL_set_msg_callback_arg().

NOTES

       Les  messages  de  protocole sont transmis à la fonction de rappel après déchiffrement et l’assemblage de
       morceaux où c’est autorisé (les limites d’enregistrement ne sont pas visibles).

       Si durant le processus, un message de protocole reçu conduit à une erreur, la fonction de rappel ne  sera
       pas appelée. Par exemple, la fonction de rappel ne verra jamais les messages considérés comme trop grands
       pour être traités.

       À  cause  de  la  négociation  automatique  de  version de protocole, version n’est pas inévitablement la
       version de protocole utilisée par l’expéditeur du message. Si un message ClientHello de TLS 1.0 est  reçu
       par un serveur uniquement SSL 3.0, version sera SSL3_VERSION.

VOIR AUSSI

       ssl(3), SSL_new(3)

HISTORIQUE

       SSL_CTX_set_msg_callback(),        SSL_CTX_set_msg_callback_arg(),        SSL_set_msg_callback()       et
       SSL_get_msg_callback_arg() ont été ajoutées dans OpenSSL 0.9.7.

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_set_msg_callback(3SSL)