fr::crypto::SMIME_read_PKCS7(3SSL)

NOM
SMIME_read_PKCS7 - Analyser un message S/MIME

SYNOPSIS
#include <openssl/pkcs7.h>

PKCS7 *SMIME_read_PKCS7(BIO *in, BIO **bcont);

DESCRIPTION
SMIME_read_PKCS7() analyse un message au format S/MIME.

in est un BIO où lire le message.

Si la signature en texte clair est utilisée, alors le contenu est mémorisé dans un tampon écrit dans *bcont, sinon *bcont est défini à NULL.

La structure PKCS#7 analysée est renvoyée, ou NULL en cas d'erreur.

NOTES
Si *bcont n'est pas NULL, alors le message est signé en texte clair. *bcont peut alors être passé à PKCS7_verify() avec l'attribut PKCS7_DETACHED activé.

Sinon, le type de la structure renvoyée peut être déterminé en utilisant PKCS7_type().

Pour permettre de futures fonctionnalités, si bcont n'est pas NULL, *bcont devrait être initialisé à NULL. Par exemple :

 BIO *cont = NULL;
 PKCS7 *p7;

 p7 = SMIME_read_PKCS7(in, &cont);

BOGUES
L'analyseur MIME utilisé par SMIME_read_PKCS7() est un peu primitif. Bien qu'il traite la plupart des messages S/MIME, les formats composés plus compliqués risquent de ne pas être gérés.

L'analyseur assume que la structure PKCS7 est toujours encodée en base64 et ne traitera pas le cas où elle est au format binaire ou utilise le format Quoted-Printable.

L'utilisation d'un BIO mémoire pour stocker le contenu signé limite la taille du message qui peut être traité, à cause de restrictions de la mémoire : une option de flux en une seule passe devrait être disponible.

VALEURS DE RETOUR
SMIME_read_PKCS7() renvoie une structure PKCS7 valable, ou NULL en cas d'erreur. L'erreur peut être obtenue à l'aide de ERR_get_error(3).

VOIR AUSSI
ERR_get_error(3), PKCS7_decrypt(3), PKCS7_encrypt(3), PKCS7_sign(3), PKCS7_verify(3), PKCS7_type(3), SMIME_read_PKCS7(3)

HISTORIQUE
SMIME_read_PKCS7() a été ajoutée dans OpenSSL 0.9.5

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.