fr::ssl::SSL_CTX_set_cipher_list(3SSL)

NOM
SSL_CTX_set_cipher_list, SSL_set_cipher_list - Choisir la liste des SSL_CIPHER disponibles

SYNOPSIS
 #include <openssl/ssl.h>

 int SSL_CTX_set_cipher_list(SSL_CTX *ctx, const char *str);
 int SSL_set_cipher_list(SSL *ssl, const char *str);

DESCRIPTION
SSL_CTX_set_cipher_list() définit la liste des algorithmes de chiffrement disponibles pour ctx en utilisant la chaîne de contrôle str. Le format de la chaîne est décrit dans ciphers(1). La liste d'algorithmes de chiffrement est héritée par tous les objets ssl créés à partir de ctx.

SSL_set_cipher_list() ne définit la liste des algorithmes de chiffrement que pour ssl.

NOTES
La chaîne de contrôle str devrait être universellement utilisable sans dépendre de détails de la configuration de bibliothèques (algorithmes de chiffrement compilés à l'intérieur). Ainsi, aucune vérification de syntaxe n'est effectuée. Les éléments qui ne sont pas reconnus, parce que les algorithmes de chiffrement correspondants ne sont pas compilés à l'intérieur, ou parce qu'ils n'ont pas été écrits correctement, sont simplement ignorés. Les échecs ne sont attribués que si aucun algorithme de chiffrement n'a pu être collecté.

Précision importante : l'inclusion d'un algorithme de chiffrement à utiliser dans la liste est une condition nécessaire. Du côté client, l'inclusion dans la liste est aussi suffisante. Du côté serveur, des restrictions supplémentaires s'appliquent. Tous les algorithmes de chiffrement ont des conditions nécessaires supplémentaires. Les algorithmes de chiffrement ADH n'ont pas besoin d'un certificat, mais les paramètres DH doivent avoir été définis. Tous les autres algorithmes de chiffrement ont besoin d'un certificat et d'une clef correspondants

Seul un algorithme de chiffrement RSA peut être choisi quand un certificat RSA est disponible. Les algorithmes de chiffrement RSA exportés avec une taille de clef de 512 bits pour la clef RSA ont besoin d'une clef RSA temporaire de 512 bits, puisque les clefs typiquement fournies ont une taille de 1024 bits (consultez SSL_CTX_set_tmp_rsa_callback(3)). Les algorithmes de chiffrement RSA utilisant EDH ont besoin d'un certificat et d'une clef et de paramètres DH supplémentaires (consultez SSL_CTX_set_tmp_dh_callback(3)).

Seul un algorithme de chiffrement DSA peut être choisi quand un certificat DSA est disponible. Les algorithmes de chiffrement DSA utilisent toujours un échange de clef DH, et ont par conséquent besoin de paramètres DH (consultez SSL_CTX_set_tmp_dh_callback(3)).

Quand ces conditions ne sont pas réunies pour un algorithme de chiffrement de la liste (par exemple un client qui ne gère que l'exportation d'algorithmes de chiffrement RSA avec une taille de clef asymétrique de 512 bits et que le serveur n'est pas configuré pour utiliser des clefs RSA temporaires), l'erreur « pas d'algorithme de chiffrement partagé » (SSL_R_NO_SHARED_CIPHER) est générée, et l'initialisation échouera.

VALEURS DE RETOUR
SSL_CTX_set_cipher_list() et SSL_set_cipher_list() renvoient 1 si un algorithme de chiffrement a pu être sélectionné et 0 en cas d'échec complet.

VOIR AUSSI
ssl(3), SSL_get_ciphers(3), SSL_CTX_use_certificate(3), SSL_CTX_set_tmp_rsa_callback(3), SSL_CTX_set_tmp_dh_callback(3), ciphers(1)

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.