Scroll to navigation

fr::ssl::SSL_CTX_add_session(3SSL) OpenSSL fr::ssl::SSL_CTX_add_session(3SSL)

NOM

SSL_CTX_add_session, SSL_add_session, SSL_CTX_remove_session, SSL_remove_session - manipuler le cache de sessions

SYNOPSIS

 #include <openssl/ssl.h>
 int SSL_CTX_add_session(SSL_CTX *ctx, SSL_SESSION *c);
 int SSL_add_session(SSL_CTX *ctx, SSL_SESSION *c);
 int SSL_CTX_remove_session(SSL_CTX *ctx, SSL_SESSION *c);
 int SSL_remove_session(SSL_CTX *ctx, SSL_SESSION *c);

DESCRIPTION

SSL_CTX_add_session() ajoute la session c au contexte ctx. Le compteur de références pour la session c est incrémenté de 1. S'il existe déjà une session avec le même identifiant de session, la session ancienne est supprimée en appelant SSL_SESSION_free(3).

SSL_CTX_remove_session() supprime la session c du contexte ctx. SSL_SESSION_free(3) est appelée une fois pour c.

SSL_add_session() et SSL_remove_session() sont synonymes pour leurs équivalents SSL_CTX_*().

NOTES

Quand on ajoute une nouvelle session au cache des sessions interne, l'existence d'une session portant déjà le même identifiant de session est vérifiée. Si c'est le cas, ces deux sessions sont considérées identiques. Si la même session est conservée dans un objet SSL_SESSION différent, l'ancienne session est supprimée et remplacée par la nouvelle session. Si la session est vraiment identique (l'objet SSL_SESSION est identique), SSL_CTX_add_session() est sans effet et la valeur 0 est renvoyée.

Lorsqu'un serveur SSL_CTX est configuré avec le réglage SSL_SESS_CACHE_NO_INTERNAL_STORE, le cache interne n'est pas automatiquement rempli par les nouvelles sessions négociées par l'implémentation de SSL/TLS, même si le cache interne fera automatiquement l'objet d'une recherche lors d'une requête de reprise de session (la dernière peut être supprimée par la fonction SSL_SESS_CACHE_NO_INTERNAL_LOOKUP). Ainsi, l'application peut utiliser directement SSL_CTX_add_session() pour obtenir un contrôle total des sessions qui peuvent être reprises si on le souhaite.

VALEURS DE RETOUR

Toutes les fonctions peuvent renvoyer les valeurs suivantes :

0
 L’opération a échouée. Si c’est lors d’une opération d’addition, un essai
 d’ajout de la même session (identique) a été fait. Si c’est lors d’une
 opération de suppression, la session n’a pas été trouvée dans le cache.
    
1
 L’opération est réussie.
    

VOIR AUSSI

ssl(3), SSL_CTX_set_session_cache_mode(3), SSL_SESSION_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.

2015-12-31 1.0.2a 1.0.2c