SMIME_READ_CMS(3SSL)

NOM
SMIME_read_CMS_ex, SMIME_read_CMS - Analyser un message S/MIME

SYNOPSIS
 #include <openssl/cms.h>

 CMS_ContentInfo *SMIME_read_CMS_ex(BIO *bio, int flags, BIO **bcont,
                                    CMS_ContentInfo **cms);
 CMS_ContentInfo *SMIME_read_CMS(BIO *in, BIO **bcont);

DESCRIPTION
SMIME_read_CMS() parses a message in S/MIME format.

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.

SMIME_read_CMS_ex() is similar to SMIME_read_CMS() but optionally a previously created cms CMS_ContentInfo object can be supplied as well as some flags. To create a cms object use CMS_ContentInfo_new_ex(3). If the flags argument contains CMS_BINARY then the input is assumed to be in binary format and is not translated to canonical form. If in addition SMIME_ASCIICRLF is set then the binary input is assumed to be followed by CR and LF characters, else only by an LF character. If flags is 0 and cms is NULL then it is identical to SMIME_read_CMS().

NOTES
If *bcont is not NULL then the message is clear text signed. *bcont can then be passed to CMS_verify() with the CMS_DETACHED flag set.

Otherwise the type of the returned structure can be determined using 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
The MIME parser used by SMIME_read_CMS() is somewhat primitive. While it will handle most S/MIME messages more complex compound formats may not work.

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 RENVOYÉES
SMIME_read_CMS_ex() and SMIME_read_CMS() return a valid CMS_ContentInfo structure or NULL if an error occurred. The error can be obtained from ERR_get_error(3).

VOIR AUSSI
ERR_get_error(3), CMS_sign(3), CMS_verify(3), CMS_encrypt(3), CMS_decrypt(3)

HISTORIQUE
The function SMIME_read_CMS_ex() was added in OpenSSL 3.0.

COPYRIGHT
Copyright 2008-2021 Les auteurs du projet OpenSSL. Tous droits réservés.

Sous licence Apache 2.0 (la « Licence »). Vous ne pouvez utiliser ce fichier que conformément à la Licence. Vous trouverez une copie dans le fichier LICENSE de la distribution du source ou à l'adresse <https://www.openssl.org/source/license.html>.

TRADUCTION
La traduction française de cette page de manuel a été créée par David Prévot <david@tilapin.org>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 (https://www.gnu.org/licenses/gpl-3.0.html) concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.