.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{ . if \nF \{ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "fr::crypto::hmac 3SSL" .TH fr::crypto::hmac 3SSL "2015-12-31" "1.0.2a 1.0.2c" "OpenSSL" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NOM" .IX Header "NOM" \&\s-1HMAC,\s0 HMAC_CTX_init, HMAC_Init, HMAC_Update, HMAC_Init_ex, HMAC_Final, HMAC_CTX_cleanup, HMAC_cleanup \- message d'authentification de message \s-1HMAC\s0 .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& #include \& \& unsigned char *HMAC(const EVP_MD *evp_md, const void *key, \& int key_len, const unsigned char *d, int n, \& unsigned char *md, unsigned int *md_len); \& \& void HMAC_CTX_init(HMAC_CTX *ctx); \& \& int HMAC_Init(HMAC_CTX *ctx, const void *key, int key_len, \& const EVP_MD *md); \& int HMAC_Init_ex(HMAC_CTX *ctx, const void *key, int key_len, \& const EVP_MD *md, ENGINE *impl); \& int HMAC_Update(HMAC_CTX *ctx, const unsigned char *data, int len); \& int HMAC_Final(HMAC_CTX *ctx, unsigned char *md, unsigned int *len); \& \& void HMAC_CTX_cleanup(HMAC_CTX *ctx); \& void HMAC_cleanup(HMAC_CTX *ctx); .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\s-1HMAC\s0 est un \s-1MAC \s0(code d'authentification de message), c'est\-à\-dire une fonction de hachage à clé utilisée pour l'authentification des messages, qui est basé sur une fonction de hachage. .PP \&\fB\s-1HMAC\s0\fR() calcule le code d'authentification du message faisant \fIn\fR octets à \fId\fRen utilisant la fonction de hachage \fIevp_md\fR et la clé \fIkey\fR qui a une longueur de \fIkey_len\fR octets. .PP Elle place le résultat dans \fImd\fR (qui doit avoir de l'espace pour la sortie de la fonction de hachage, qui n'est pas plus de \fB\s-1EVP_MAX_MD_SIZE\s0\fR octets). Si \fImd\fR est \s-1NULL,\s0 le condensé est placé dans un tableau statique. La taille de la sortie est placée dans \fImd_len\fR, sauf si elle est \&\s-1NULL.\s0 .PP \&\fIevp_md\fR peut être \fBEVP_sha1\fR(), \fBEVP_ripemd160\fR(), etc. .PP \&\fBHMAC_CTX_init\fR() initialise un \fB\s-1HMAC_CTX\s0\fR avant sa première utilisation. Elle doit être appelée. .PP \&\fBHMAC_CTX_cleanup\fR() efface la clé et toutes autres données de \fB\s-1HMAC_CTX\s0\fR et libère toutes ressources associées. Elle doit être appelée quand \&\fB\s-1HMAC_CTX\s0\fR n'est plus utilisée. .PP \&\fBHMAC_cleanup\fR() est un alias pour \fBHMAC_CTX_cleanup\fR() qui est incluse pour être compatible avec la version 0.9.6b, elle est obsolète. .PP Les fonctions suivantes peuvent être utiles si le message n'est pas stocké en entier dans la mémoire : .PP \&\fBHMAC_Init\fR() initialise une structure \fB\s-1HMAC_CTX\s0\fR pour utiliser une fonction de hachage \fIevp_md\fR et sa clé \fIkey\fR qui est de longueur \&\fIkey_len\fR octets. Elle est obsolète et est uniquement incluse pour une compatibilité avec OpenSSL 0.9.6b. .PP \&\fBHMAC_Init_ex\fR() initialise ou réutilise une structure \fB\s-1HMAC_CTX\s0\fR pour utiliser la fonction \fIevp_md\fR et la clé \fIkey\fR. Elles peuvent toutes les deux être \s-1NULL,\s0 dans ce cas, celle existante sera réutilisée. \fBHMAC_CTX_init\fR() aurait dû être appelée avant la première utilisation d'un \fB\s-1HMAC_CTX\s0\fR dans cette fonction. \fBN.B\fR : \fBHMAC_Init\fR() avait un comportement indéfini dans les versions précédentes d'OpenSSL — l'échec de passage à \fBHMAC_Init_ex\fR() dans les programmes qui l'attendent les fera s'arrêter. .PP \&\fBHMAC_Update\fR() peut être appelée de façon répétée avec des morceaux du message qui doit être authentifié (\fIlen\fR octets à \fIdata\fR). .PP \&\fBHMAC_Final\fR() place le code du message d'authentification dans \fImd\fR, qui doit avoir de l'espace pour la sortie de la fonction de hachage. .SH "VALEURS DE RETOUR" .IX Header "VALEURS DE RETOUR" \&\fB\s-1HMAC\s0\fR() renvoie un pointeur vers le code d'authentification du message ou \&\s-1NULL\s0 si une erreur se produit. .PP \&\fBHMAC_Init_ex\fR(), \fBHMAC_Update\fR() et \fBHMAC_Final\fR() renvoient 1 en cas de succès, 0 en cas d'échec. .PP \&\fBHMAC_CTX_init\fR() et \fBHMAC_CTX_cleanup\fR() ne renvoient pas de valeurs. .SH "MISE EN CONFORMITÉ" .IX Header "MISE EN CONFORMITÉ" \&\s-1RFC 2104\s0 .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fBevp\fR(3), \fBsha\fR(3) .SH "HISTORIQUE" .IX Header "HISTORIQUE" \&\fBHMAC_CTX_init\fR(), \fBHMAC_Init_ex\fR() et \fBHMAC_CTX_cleanup\fR() sont disponibles depuis la version 0.9.7 d'OpenSSL. .PP \&\fBHMAC_CTX_init\fR(), \fBHMAC_Init_ex\fR() et \fBHMAC_CTX_cleanup\fR() sont disponibles depuis la version 0.9.7 d'OpenSSL. .PP \&\fBHMAC_Init_ex\fR(), \fBHMAC_Update\fR() et \fBHMAC_Final\fR() ne renvoyaient pas de valeurs dans les versions antérieures à OpenSSL 1.0.0. .SH "TRADUCTION" .IX Header "TRADUCTION" La traduction de cette page de manuel est maintenue par les membres de la liste . Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr-extra.