Apply suggestions from code review

deronnax · christopheNan · JulienPalard · deronnax · commit d34aca6ad0a0 · 2020-03-08T20:31:43.000+01:00
Co-Authored-By: Christophe Nanteuil &lt;35002064+christopheNan@users.noreply.github.com&gt;
Co-Authored-By: Julien Palard &lt;julien@palard.fr&gt;
diff --git a/library/hmac.po b/library/hmac.po
@@ -17,7 +17,7 @@ msgstr ""
 
 #: ../Doc/library/hmac.rst:2
 msgid ":mod:`hmac` --- Keyed-Hashing for Message Authentication"
-msgstr ":mod:`hmac` — Hachage à clé pour authentification des messages"
+msgstr ":mod:`hmac` — Authentification de messages par hachage en combinaison avec une clé secrète"
 
 #: ../Doc/library/hmac.rst:10
 msgid "**Source code:** :source:`Lib/hmac.py`"
@@ -36,12 +36,13 @@ msgid ""
 "object to use.  It may be any name suitable to :func:`hashlib.new`. Despite "
 "its argument position, it is required."
 msgstr ""
-"Retourne un nouvel objet HMAC.  *key* est un objet *byte*  ou *bytearray* "
-"donnant la clé secrète.  Si *msg* est présent, un appel à ``update(msg)`` "
-"est effectué. *digestmod* est le nom de l’algorithme de hachage, le "
-"constructeur de *digest* ou le module de l'objet HMAC à utiliser.  Il peut "
-"s'agir de n'importe quel nom approprié pour :func:`hashlib.new`. Bien qu’il "
-"soit un argument positionnel, il est requis."
+"Renvoie un nouvel objet HMAC.  *key* est un objet *byte* ou *bytearray* "
+"donnant la clé secrète.  Si *msg* est présent, un appel à ``update(msg)`` est "
+"effectué. *digestmod* permet de choisir l’algorithme à utiliser par l’objet "
+"HMAC, il accepte un nom de fonction de hachage (peut être tout ce qui "
+"convient :func:`hashlib.new`), un constructeur de fonction de hachage ou un "
+"module implémentant la PEP 247. Bien qu’il soit après *msg*, *digestmod* est "
+"un paramètre obligatoire."
 
 #: ../Doc/library/hmac.rst:25
 msgid ""
@@ -72,7 +73,7 @@ msgid ""
 "The parameters *key*, *msg*, and *digest* have the same meaning as in :func:"
 "`~hmac.new`."
 msgstr ""
-"Renvoie l'empreinte cryptographique de *msg* pour une *key* secrète et un "
+"Renvoie le condensat de *msg* correspondant à la clé secrète *key* et à l'algorithme "
 "*digest* donné. La fonction est équivalente à ``HMAC(key, msg, digest)."
 "digest()``, mais elle utilise une implémentation optimisée en C ou *inline*, "
 "qui est plus rapide pour les messages dont la taille leur permet de tenir en "
@@ -115,9 +116,9 @@ msgid ""
 "given to the constructor.  It may contain non-ASCII bytes, including NUL "
 "bytes."
 msgstr ""
-"Renvoie l'empreinte cryptographique des octets passés à la méthode :meth:"
+"Renvoie le condensat des octets passés à la méthode :meth:"
 "`update` jusque là. L'objet *bytes* renvoyé sera de la même longueur que la "
-"*digest_size* du *digest* donné au constructeur. Il peut contenir des octets "
+"*digest_size* de la fonction de hachage donnée au constructeur. Il peut contenir des octets "
 "qui ne sont pas dans la table ASCII, y compris des octets NUL."
 
 #: ../Doc/library/hmac.rst:72
@@ -127,10 +128,10 @@ msgid ""
 "`compare_digest` function instead of the ``==`` operator to reduce the "
 "vulnerability to timing attacks."
 msgstr ""
-"Si l'on compare la sortie de :meth:`digest` avec celle d'un *digest* obtenu "
+"Si vous devez vérifier la sortie de :meth:`digest` avec un condensat obtenu par ailleurs "
 "par un service extérieur durant une routine de vérification, il est "
 "recommandé d'utiliser la fonction :func:`compare_digest` au lieu de "
-"l'opérateur ``==`` afin de réduire la vulnérabilité aux attaques basées sur "
+"l'opérateur ``==`` afin de réduire la vulnérabilité aux attaques temporelles."
 "les temps de réponse."
 
 #: ../Doc/library/hmac.rst:80
@@ -139,10 +140,10 @@ msgid ""
 "length containing only hexadecimal digits.  This may be used to exchange the "
 "value safely in email or other non-binary environments."
 msgstr ""
-"Comme :meth:`digest` sauf que ce *digest* est retourné en tant que chaîne de "
+"Comme :meth:`digest` sauf que ce condensat est renvoyé en tant que chaîne de "
 "caractères de taille doublée contenant seulement des chiffres hexadécimaux. "
 "Cela permet d’échanger le résultat sans problèmes par e-mail ou dans d'autres "
-"environnements non binaires."
+"environnements ne gérant pas les données binaires."
 
 #: ../Doc/library/hmac.rst:86
 msgid ""
@@ -151,7 +152,7 @@ msgid ""
 "`compare_digest` function instead of the ``==`` operator to reduce the "
 "vulnerability to timing attacks."
 msgstr ""
-"Si l'on compare la sortie de :meth:`hexdigest` avec celle d'un *digest* "
+"Si l'on compare la sortie de :meth:`hexdigest` avec celle d'un condensat connu "
 "obtenu par un service extérieur durant une routine de vérification, il est "
 "recommandé d'utiliser la fonction :func:`compare_digest` au lieu de "
 "l'opérateur ``==`` afin de réduire la vulnérabilité aux attaques basées sur "
@@ -197,10 +198,10 @@ msgid ""
 "either :class:`str` (ASCII only, as e.g. returned by :meth:`HMAC."
 "hexdigest`), or a :term:`bytes-like object`."
 msgstr ""
-"Retourne ``a == b``. Cette fonction utilise une approche destinée à prévenir "
-"l'analyse des temps de réponse en évitant les comportements de court circuit "
-"basés sur le contenu, ce qui la rend appropriée pour de la cryptographie. "
-"*a* et *b* doivent être du même type : soit :class:`str` (caractères ASCII "
+"Renvoie ``a == b``. Cette fonction a été conçue pour prévenir "
+"les attaques temporelles en évitant l'implémentation de courts-circuits "
+"basés sur le contenu, ce qui la rend appropriée pour de la cryptographie. *a* "
+"et *b* doivent être du même type : soit :class:`str` (caractères ASCII "
 "seulement, comme retourné par :meth:`HMAC.hexdigest` par exemple), ou :term:"
 "`bytes-like object`."
 
@@ -211,7 +212,7 @@ msgid ""
 "*a* and *b*—but not their values."
 msgstr ""
 "Si *a* et *b* sont de longueurs différentes ou si une erreur se produit, une "
-"attaque basée sur les temps de réponse pourrait en théorie révéler des "
+"attaque temporelle pourrait en théorie obtenir des "
 "informations sur les types et longueurs de *a* et de *b*, mais pas sur leurs "
 "valeurs."
 
