SYNOPSIS

#include <openssl/dsa.h>
 #include <openssl/engine.h>

void DSA_set_default_method(const DSA_METHOD *meth);

const DSA_METHOD *DSA_get_default_method(void);

int DSA_set_method(DSA *dsa, const DSA_METHOD *meth);

DSA *DSA_new_method(ENGINE *engine);

DSA_METHOD *DSA_OpenSSL(void);

DESCRIPTION

Une DSA_METHOD indique les fonctions qu’OpenSSL utilise pour les opérations DSA. En modifiant la méthode, les implémentations alternatives comme les accélérateurs matériels pourraient être utilisés. Important : consultez la section NOTES qui contient des renseignements importants sur la façon dont ces fonctions d’interface de programmation DSA sont concernées par l’utilisation des appels d’interface de programmation ENGINE.

Initialement, la DSA_METHOD par défaut est l’implémentation interne d’OpenSSL, telle que renvoyée par DSA_OpenSSL().

DSA_set_default_method() fait de meth la méthode par défaut pour toutes les structures DSA créées ensuite. Remarque : ce n’est vrai que tant qu’aucun ENGINE n’a été défini par défaut pour DSA, donc cette fonction n’est plus recommandée.

DSA_get_default_method() renvoie un pointeur vers la DSA_METHOD par défaut actuelle. Cependant, la signification de ce résultat dépend de l’utilisation ou non de l’interface de programmation ENGINE, donc cette fonction n’est plus recommandée.

DSA_set_method() sélectionne meth pour réaliser toutes les opérations utilisant la clef dsa. Cela remplacera la DSA_METHOD utilisée par la clef DSA et, si la méthode précédente a été fournie par un ENGINE, le traitement par cet ENGINE sera abandonné pendant la modification. Certaines clefs pourraient ne fonctionner qu’avec certaines implémentations de DSA_METHOD (par exemple à partir d’un module ENGINE qui prend en charge les clefs protégées matériellement) et, dans ces cas, essayer de modifier la DSA_METHOD pour la clef peut avoir des résultats inattendus.

DSA_new_method() alloue et initialise une structure DSA de telle sorte qu’engine sera utilisé pour les opérations DSA. Si engine est NULL, l’ENGINE par défaut pour les opérations DSA est utilisé, et si aucun ENGINE par défaut n’est défini, la DSA_METHOD contrôlée par DSA_set_default_method() est utilisée.

LA STRUCTURE DSA_METHOD

struct
 {
     /* nom de l’implémentation */
        const char *name;

     /* signer */
        DSA_SIG *(*dsa_do_sign)(const unsigned char *dgst, int dlen,
                                 DSA *dsa);
     /* précalculer k^-1 et r */
        int (*dsa_sign_setup)(DSA *dsa, BN_CTX *ctx_in, BIGNUM **kinvp,
                                 BIGNUM **rp);
     /* vérifier */
        int (*dsa_do_verify)(const unsigned char *dgst, int dgst_len,
                                 DSA_SIG *sig, DSA *dsa);
     /* calculer rr = a1^p1 * a2^p2 mod m (pourrait être NULL pour
                                           certaines implémentations) */
        int (*dsa_mod_exp)(DSA *dsa, BIGNUM *rr, BIGNUM *a1, BIGNUM *p1,
                                 BIGNUM *a2, BIGNUM *p2, BIGNUM *m,
                                 BN_CTX *ctx, BN_MONT_CTX *in_mont);
     /* calculer r = a ^ p mod m (pourrait être NULL pour
                                  certaines implémentations) */
        int (*bn_mod_exp)(DSA *dsa, BIGNUM *r, BIGNUM *a,
                                 const BIGNUM *p, const BIGNUM *m,
                                 BN_CTX *ctx, BN_MONT_CTX *m_ctx);
     /* appelée à DSA_new */
        int (*init)(DSA *DSA);
     /* appelée à DSA_free */
        int (*finish)(DSA *DSA);
        int flags;
        char *app_data; /* ? */
 } DSA_METHOD;

VALEURS DE RETOUR

DSA_OpenSSL() et DSA_get_default_method() renvoient des pointeurs vers les DSA_METHOD respectives.

DSA_set_default_method() ne renvoie rien.

DSA_set_method() renvoie une valeur non nulle si la meth a été définie correctement comme la méthode pour dsa (y compris le déchargement du traitement de l’ENGINE si la méthode précédente était fournie par un ENGINE).

DSA_new_method() renvoie NULL et positionne un code d'erreur qui peut être récupéré avec ERR_get_error(3) si l'allocation échoue. Sinon, elle renvoie un pointeur vers la structure nouvellement allouée.

NOTES

Depuis la version 0.9.7, les implémentations DSA_METHOD sont regroupées avec d’autres interfaces de programmation algorithmiques (par exemple RSA_METHOD, EVP_CIPHER, etc.) dans les modules ENGINE. Si un ENGINE par défaut est indiqué pour la fonctionnalité DSA utilisant une fonction d’interface de programmation ENGINE, cela remplacera tous les DSA par défaut définis en utilisant l’interface de programmation DSA (c’est-à-dire DSA_set_default_method()). Pour cette raison, l’interface de programmation ENGINE est la façon recommandée de contrôler les implémentations par défaut à utiliser dans les algorithmes cryptographiques DSA et autres.

HISTORIQUE

DSA_set_default_method(), DSA_get_default_method(), DSA_set_method(), DSA_new_method() et DSA_OpenSSL() ont été ajoutées dans OpenSSL 0.9.4.

DSA_set_default_openssl_method() et DSA_get_default_openssl_method() ont respectivement remplacé DSA_set_default_method() et DSA_get_default_method(), et DSA_set_method() et DSA_new_method() ont été modifiées pour utiliser des ENGINE plutôt que des DSA_METHOD pendant le développement de la version ENGINE d’OpenSSL 0.9.6. Pour 0.9.7, le traitement des valeurs par défaut dans l’interface de programmation ENGINE a été restructuré en revenant sur cette modification, pour que le comportement des autres fonctions ressemble plus au comportement précédent. Le comportement des valeurs par défaut dans l’interface de programmation ENGINE remplace maintenant de façon transparente le comportement des valeurs par défaut dans l’interface de programmation DSA sans modification nécessaire de ces prototypes de fonctions.

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.