NOM¶
SMIME_write_PKCS7 - Convertir une structure PKCS#7 au format S/MIME
SYNOPSIS¶
#include <openssl/pkcs7.h>
int SMIME_write_PKCS7(BIO *out, PKCS7 *p7, BIO *data, int flags);
DESCRIPTION¶
SMIME_write_PKCS7() ajoute les en-têtes MIME appropriés à
une structure PKCS#7 pour produire un message S/MIME.
out est le BIO où écrire les données.
p7 est la
structure
PKCS7 appropriée. Si le flux est activé, alors le
contenu doit être fourni dans l'argument
data.
flags est un
jeu d'attributs facultatif.
NOTES¶
Les attributs suivants peuvent être passés dans le paramètre
flags.
Si
PKCS7_DETACHED est défini, alors la signature en texte clair sera
utilisée. Cette option n'a de sens que pour signedData, où
PKCS7_DETACHED est aussi défini quand
PKCS7_sign() est
appelée.
Si l'attribut
PKCS7_TEXT est défini, les en-têtes MIME pour le
type
text/plain sont ajoutés au contenu. Cela n'a de sens que si
PKCS7_DETACHED est aussi défini.
Si l'attribut
PKCS7_STREAM est défini, un flux est
réalisé. Cet attribut ne devrait être défini que si
PKCS7_STREAM était aussi défini dans l'appel
précédent de
PKCS7_sign() ou
PKCS7_encrypt().
Si la signature en texte clair est utilisée et que
PKCS7_STREAM
n'est pas défini, alors les données doivent être lues deux
fois : une fois pour calculer la signature dans
PKCS7_sign(), et
une fois pour afficher le message S/MIME.
Si un flux est réalisé, le contenu est affiché au format BER en
utilisant un encodage construit de taille indéfinie, sauf dans le cas de
données signées avec contenu détaché où le contenu
est absent et alors le format DER est utilisé.
BOGUES¶
SMIME_write_PKCS7() encode toujours en base64 les structures PKCS#7, il
devrait y avoir une option permettant de désactiver cela.
VALEURS DE RETOUR¶
SMIME_write_PKCS7() renvoie
1 en cas de réussite et
0
en cas d'échec.
VOIR AUSSI¶
ERR_get_error(3),
PKCS7_sign(3),
PKCS7_verify(3),
PKCS7_encrypt(3) PKCS7_decrypt(3)
HISTORIQUE¶
SMIME_write_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.