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.

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.