NOM

       SSL_CTX_sess_set_new_cb, SSL_CTX_sess_set_remove_cb, SSL_CTX_sess_set_get_cb,
       SSL_CTX_sess_get_new_cb, SSL_CTX_sess_get_remove_cb, SSL_CTX_sess_get_get_cb - Fournir des
       fonctions de rappel pour la mise en cache de sessions externe du côté serveur

SYNOPSIS

        #include <openssl/ssl.h>

        void SSL_CTX_sess_set_new_cb(SSL_CTX *ctx,
                                     int (*new_session_cb)(SSL *, SSL_SESSION *));
        void SSL_CTX_sess_set_remove_cb(SSL_CTX *ctx,
                  void (*remove_session_cb)(SSL_CTX *ctx, SSL_SESSION *));
        void SSL_CTX_sess_set_get_cb(SSL_CTX *ctx,
                  SSL_SESSION (*get_session_cb)(SSL *, unsigned char *, int, int *));

        int (*SSL_CTX_sess_get_new_cb(SSL_CTX *ctx))(struct ssl_st *ssl, SSL_SESSION *sess);
        void (*SSL_CTX_sess_get_remove_cb(SSL_CTX *ctx))(struct ssl_ctx_st *ctx, SSL_SESSION *sess);
        SSL_SESSION *(*SSL_CTX_sess_get_get_cb(SSL_CTX *ctx))(struct ssl_st *ssl, unsigned char *data, int len, int *copy);

        int (*new_session_cb)(struct ssl_st *ssl, SSL_SESSION *sess);
        void (*remove_session_cb)(struct ssl_ctx_st *ctx, SSL_SESSION *sess);
        SSL_SESSION *(*get_session_cb)(struct ssl_st *ssl, unsigned char *data,
                      int len, int *copy);

DESCRIPTION

       SSL_CTX_sess_set_new_cb() configure la fonction de rappel qui est automatiquement appelée
       chaque fois qu'une nouvelle session a été négociée.

       SSL_CTX_sess_set_remove_cb() configure la fonction de rappel qui est automatiquement
       appelée chaque fois qu'une session a été supprimée par le moteur SSL, parce qu'elle est
       considérée fautive ou parce que la session est devenue obsolète par dépassement de la
       valeur du délai d'expiration.

       SSL_CTX_sess_set_get_cb() configure la fonction de rappel qui est appelée chaque fois
       qu'un client SSL/TLS a proposé de reprendre une session mais qu'elle ne peut pas être
       trouvée dans le cache de sessions interne (voir SSL_CTX_set_session_cache_mode(3)),
       (seulement pour les serveurs SSL/TLS)

       SSL_CTX_sess_get_new_cb(), SSL_CTX_sess_get_remove_cb(), et SSL_CTX_sess_get_get_cb()
       permettent de récupérer les pointeurs de fonction des fonctions de rappel fournies. Si une
       fonction de rappel n'a pas été configurée, le pointeur NULL est renvoyé.

NOTES

       Afin de permettre la mise en cache externe de session, la synchronisation avec le cache
       interne de session est réalisée par les fonctions de rappel.Dans les fonctions de rappel,
       la session peut être sauvegardée sur le disque ou mise dans une base de données en
       utilisant l'interface d2i_SSL_SESSION(3).

       La fonction new_session_cb() est appelée chaque fois qu'une nouvelle session a été
       négociée et que la mise en cache de sessions est activée (voir
       SSL_CTX_set_session_cache_mode(3)). La fonction new_session_cb() est passée à la connexion
       ssl et à la session SSL sess. Si le rappel renvoie 0, la session sera à nouveau
       immédiatement supprimée.

       La fonction remove_session_cb() est appelée chaque fois que le moteur SSL supprime une
       session du cache interne. Cela se produit quand la session est supprimée parce qu'elle est
       expirée ou quand une connexion n'a pas été fermée proprement. Cela arrive aussi pour
       toutes les sessions dans le cache de sessions interne lorsque SSL_CTX_free(3) est appelée.
       La fonction remove_session_cb() est passée à ctx et à la session SSL sess. Elle ne renvoie
       aucun message.

       La fonction get_session_cb() est seulement appelée sur les serveurs SSL/TLS avec
       l'identifiant de session proposé par le client. La fonction get_session_cb() est toujours
       appelée, même si la mise en cache de session a été désactivée. La fonction
       get_session_cb() est passée à la connexion ssl, l'identifiant de session de longueur
       length à l'emplacement mémoire data. Avec le paramètre copy le rappel peut nécessiter que
       le moteur SSL incrémente le compteur de références de l'objet SSL_SESSION. Normalement, le
       compteur de références n'est pas incrémenté et ainsi la session ne doit pas être
       explicitement libérée avec SSL_SESSION_free(3).

VOIR AUSSI

       ssl(3), d2i_SSL_SESSION(3), SSL_CTX_set_session_cache_mode(3), SSL_CTX_flush_sessions(3),
       SSL_SESSION_free(3), SSL_CTX_free(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.