SMIME_read_CMS(3) Analyser un message S/MIME

SYNOPSIS

#include <openssl/cms.h>

CMS_ContentInfo *SMIME_read_CMS(BIO *in, BIO **bcont);

DESCRIPTION

SMIME_read_CMS() 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 CMS_ContentInfo 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é à CMS_verify() avec l'attribut CMS_DETACHED activé.

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

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

 BIO *cont = NULL;
 CMS_ContentInfo *cms;
 cms = SMIME_read_CMS(in, &cont);

BOGUES

L'analyseur MIME utilisé par SMIME_read_CMS() 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 CMS_ContentInfo 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_CMS() renvoie une structure CMS_ContentInfo valable, ou NULL en cas d'erreur. L'erreur peut être obtenue à l'aide de ERR_get_error(3).

HISTORIQUE

SMIME_read_CMS() a été ajoutée dans OpenSSL 0.9.8

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.