fr::crypto::OPENSSL_config(3SSL)

NOM
OPENSSL_config, OPENSSL_no_config - Fonctions simples de configuration d’OpenSSL

SYNOPSIS

 #include <openssl/conf.h>

 void OPENSSL_config(const char *config_name);
 void OPENSSL_no_config(void);

DESCRIPTION
OPENSSL_config() configure OpenSSL avec le fichier de configuration standard openssl.cnf en utilisant config_name. Si config_name est NULL, alors le nom par défaut openssl_conf sera utilisé. Toutes les erreurs seront ignorées. Les appels suivants d’OPENSSL_config() n’auront aucun effet. Le format du fichier de configuration est documenté dans la page de manuel config(5).

OPENSSL_no_config() désactive la configuration. Si elle est appelée avant OPENSSL_config(), aucune configuration n’aura lieu.

NOTES
Toutes les nouvelles applications devraient très préférablement appeler OPENSSL_config() ou les fonctions plus sophistiquées comme CONF_modules_load() lors de l’initialisation (c’est-à-dire avant de commencer un nouveau processus léger). En faisant cela, une application n’a pas besoin de garder trace de toutes les options de configuration et de nouvelles fonctionnalités peuvent être prises en charge automatiquement.

OPENSSL_config() peut aussi être appelée automatiquement quand une application appelle OPENSSL_add_all_algorithms() en compilant une application avec le symbole de préprocesseur OPENSSL_LOAD_CONF défini. Ainsi, la configuration peut être ajoutée sans modification des sources.

La variable d’environnement OPENSSL_CONF peut être définie pour indiquer l’emplacement du fichier de configuration.

Les configurations d’OBJECT ASN1 et d’ENGINE peuvent actuellement être réalisées, les prochaines versions d’OpenSSL ajouteront de nouvelles options de configuration.

Plusieurs raisons justifient la recommandation d’utiliser les routines de configuration d’OpenSSL. Par exemple, la nouvelle fonctionnalité ENGINE a été ajoutée à OpenSSL 0.9.7. Dans OpenSSL 0.9.7, les fonctions de contrôle peuvent être prises en charge par les ENGINE, cela peut être utilisé (entre autres) pour charger des ENGINE dynamiques depuis des bibliothèques partagées (DSO). Cependant, très peu d’applications prennent actuellement en charge l’interface de contrôle et donc très peu peuvent charger et utiliser des ENGINE dynamiques. De même, à l’avenir, des ENGINE plus sophistiqués nécessiteront certaines opérations de contrôle pour les personnaliser. Si une application appelle OPENSSL_config(), elle n’a pas besoin de savoir ou s’inquiéter des opérations de contrôle d’ENGINE car elles peuvent être réalisées en modifiant un fichier de configuration.

Les applications devraient libérer la configuration lors de la fermeture de l’application en appelant CONF_modules_free().

RESTRICTIONS
La fonction OPENSSL_config() est conçue pour être une fonction très simple à « appeler et oublier ». Par conséquent, son comportement est assez limité. Elle ignore toutes les erreurs silencieusement et ne peut par exemple charger que depuis l’emplacement standard du fichier de configuration.

C’est cependant bien mieux que rien. Les applications qui ont besoin d’un contrôle plus fin de leur fonctionnalité de configuration devraient utiliser les fonctions de configuration comme CONF_load_modules() directement.

VALEURS DE RETOUR
Ni OPENSSL_config() ni OPENSSL_no_config() ne renvoient de valeur.

VOIR AUSSI
CONF_load_modules_file(3), CONF_modules_free(3), config(5)

HISTORIQUE
OPENSSL_config() et OPENSSL_no_config() sont apparues pour la première fois 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.