161 lines
31 KiB
Plaintext
161 lines
31 KiB
Plaintext
|
rust
|
|||
|
|
¤{ #rustc 1.96.0 (ac68faa20 2026-05-25)ÁíàÄTËŸ ÜJîÄ)'ß\¥! -3d1337db07d0b3aeÁ digestÁ ’Bp„ êNR2¢[•„ -9fa09ce0ec266148Á ¤²XctÔ'ÐÓ©z¨É½Ó -a4945860e1c53b00Á ¤°ð ¾ä-±($²ï=©Ã -7e98a21bfd32b0edÁÀ뉊 ]!ÜÛê(¹Þ—šên -5be7b69c3ff7b5b8Á –�òÖÀH•‘P IÓHã#£ -055f30b747f859b6Á rustc_std_workspace_coreÁCçß^ò½èÝ$Çÿ+Cé -c4878ee60b2242c9Á ŸÃï+Ñ]ŠqB<ÏïW# -8dd1dd90e70d0b6aÁ miniz_oxideÁ€š»J(P>àö÷g\K -1eb618da2918ab7fÁ adler2ÁÆ;+Þ®5¥ÌýÝ°¦ÛLˆ -f7919172d268e069Á hashbrownÁPäV9ÒÆèÜ�"ÊÖVŽ\ -0fc2184a5da6723aÁ rustc_std_workspace_allocÁs&ØòØy¯s•bæ!‰ýŠ -97e4bf30be240674Á
|
|||
|
|
std_detectÁhŠBîÙºÌI®Ë�Å�š -9dbbf8346ba7ac8bÁ rustc_demangleÁûë9´Ç×@Œ�’ùXFº -f33013f239bf9f14Á cfg_ifÁÜLh�ž§Œaã¯>� -0a71c8f33a838301Á addr2lineÁ׎Þ!]8V$É@@T· -e618e6be60e87ba2Á gimliÁ¸
|
|||
|
|
°µ~Î1‹Ñt ðÁ€w -1f7768a68858f670Á objectÁ
|
|||
|
|
áPÃ?À¶¼QHJ¥� -914cd6a4dbe590d1Á memchrÁ›º«8Ór2Ù $¨ûib‚ -cf21ca6f2bb15dcdÁë
|
|||
|
|
‹ás «LÖ€îâƒ×ɯŒ -ee6f3747e38367f0Á
|
|||
|
|
crypto_commonÁÑ2˸8áÝüV…Ãsã š§ -7e84bbd992443341Á
|
|||
|
|
generic_arrayÁç"„wÑÒÕµµ¥;è -1fbbe396c4d2fae7Á typenumÁ/-;@ú¨_z,Ö -6209550d9c65d0a6Á block_bufferÁl²>O;-bsò D’¶ Á -fa8e2dfb5eb7e256Á subtleÁÞ Os&¡A ¹]ujO -cb07c5ee900298efÁ À ´ »À|• í optimÁ
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
!
|
|||
|
|
HmacÁ -•
|
|||
|
|
HmacCoreÁ /• /_ / opad_digestÁ / ipad_digestÁ
|
|||
|
|
4• 4ƒ
|
|||
|
|
7•
|
|||
|
|
9• 9
|
|||
|
|
BufferKindÁ
|
|||
|
|
<• < KeySizeÁ
|
|||
|
|
?• ? BlockSizeÁ
|
|||
|
|
B• B
|
|||
|
|
OutputSizeÁ
|
|||
|
|
E• Eæ E new_from_sliceÁ
|
|||
|
|
I• I
|
|||
|
|
update_blocksÁ
|
|||
|
|
L• L finalize_fixed_coreÁ N
|
|||
|
|
P• P resetÁ
|
|||
|
|
|
|||
|
|
S• S write_alg_nameÁ
|
|||
|
|
V• V× simpleÁ Y YYYYYYYYY Y
|
|||
|
|
Y Y Y
|
|||
|
|
YYYYYYYYY p• pà Ys• Yu• uæ u·
|
|||
|
|
Yy• y¥ Y|• |”
|
|||
|
|
Y•
|
|||
|
|
finalize_intoÁ Y‚• ‚× Y…• …Ÿ Yˆ• ˆ finalize_into_resetÁ
|
|||
|
|
IPADÁ OPADÁ get_der_keyÁ ‘• Y
|
|||
|
|
SimpleHmacÁ “• “_ “ opad_keyÁ “ ipad_keyÁ Y ˜• ˜ƒ 6
|
|||
|
|
G
|
|||
|
|
H
|
|||
|
|
K
|
|||
|
|
K
|
|||
|
|
N
|
|||
|
|
N
|
|||
|
|
N
|
|||
|
|
R
|
|||
|
|
U
|
|||
|
|
U
|
|||
|
|
X
|
|||
|
|
X
|
|||
|
|
X
|
|||
|
|
w
|
|||
|
|
x
|
|||
|
|
{
|
|||
|
|
{
|
|||
|
|
�
|
|||
|
|
„
|
|||
|
|
„
|
|||
|
|
„
|
|||
|
|
‡
|
|||
|
|
Š
|
|||
|
|
Š
|
|||
|
|
‘
|
|||
|
|
š
|
|||
|
|
Ø / / Ü 1_
|
|||
|
|
2ø
|
|||
|
|
3Š
|
|||
|
|
0šT‰DÔ$î • ø” —” #” ” ” /” •” ™” +” -” ¿c” Ø “ “ Ê •_ Y –ë Y —û Y ™õè؈ûjÑ #Æ øÆ /Æ ÆÆ Æ ÊÆ ¿cÆ +Æ ÍÆ 4 /˜ “7 /s “9 /< /p “? /B /| “E /u “I /L /P /… “S /V /‚ “y “ “ˆ “Ø|ø — # / • ™+- ¿cÆ ÊÍ 6 0x36Á \¨ 0x5CÁ
|
|||
|
|
Y��‘í _4 MacÁ Ú ù BlockÁ,ý
|
|||
|
|
BlockSizeUserÁl„ DigestÁ4˜ ± Ê $Ì - ŒÜ DÒ / �ÊTí “ Žü ¬$ ü L I Generic implementation of Hash-based Message Authentication Code (HMAC).Á M ú üQN K To use it you will need a cryptographic hash function implementation whichÁ ü J G implements the [`digest`] crate traits. You can find compatible cratesÁ üë< 9 (e.g. [`sha2`]) in the [`RustCrypto/hashes`] repository.Á ¨ ú ü¬L I This crate provides two HMAC implementation [`Hmac`] and [`SimpleHmac`].Á üùH E The first one is a buffered wrapper around block-level [`HmacCore`].Á üÂJ G Internally it uses efficient state representation, but works only withÁ ü�J G hash functions which expose block-level API and consume blocks eagerlyÁ üØF C (e.g. it will not work with the BLAKE2 family of hash functions).Á üŸJ G On the other hand, [`SimpleHmac`] is a bit less efficient memory-wise,Á üêK H but works with all hash functions which implement the [`Digest`] trait.Á ¶ ú tº # ExamplesÁ üÉG D Let us demonstrate how to use HMAC using the SHA-256 hash function.Á ‘ ú ü•N K In the following examples [`Hmac`] is interchangeable with [`SimpleHmac`].Á ä ú üè To get authentication code:Á ˆ ú \Œ ```rustÁ ¬˜ use sha2::Sha256;Á Ô® use hmac::{Hmac, Mac};Á ÌÉ use hex_literal::hex;Á ã ú üç# // Create alias for HMAC-SHA256Á ü‹ # type HmacSha256 = Hmac<Sha256>;Á ¯ ú ü³ I F let mut mac = HmacSha256::new_from_slice(b"my secret and secure key")Á üý 1 . .expect("HMAC can take key of any size");Á ü¯
|
|||
|
|
! mac.update(b"input message");Á Ñ
|
|||
|
|
ú üÕ
|
|||
|
|
K H // `result` has type `CtOutput` which is a thin wrapper around array ofÁ ü¡ 7 4 // bytes for providing constant time equality checkÁ üÙ let result = mac.finalize();Á üú F C // To get underlying array use `into_bytes`, but be careful, sinceÁ üÁ N K // incorrect use of the code value may permit timing attacks which defeatsÁ ü�
|
|||
|
|
. + // the security provided by the `CtOutput`Á ü¿
|
|||
|
|
) & let code_bytes = result.into_bytes();Á Ìé
|
|||
|
|
let expected = hex!("Á üƒ( % 97d2a569059bbcd8ead4444ff99071f4Á ü¬( % c01d005bcefe0d3567e1be628e5fdcd9Á <Õ ");Á üÝ- * assert_eq!(code_bytes[..], expected[..]);Á <‹ ```Á “ ú Ô— To verify the message:Á ² ú \¶ Ð" ¼Â # use sha2::Sha256;Á äÚ # use hmac::{Hmac, Mac};Á Ü÷ # use hex_literal::hex;Á ü“% " # type HmacSha256 = Hmac<Sha256>;Á ü¹I º$ üƒ1 �% µ ú ü¹! È% Û ú Üß let code_bytes = hex!("Á üû( ô) ü¤( ¦* <Í ×* üÕX U // `verify_slice` will return `Ok(())` if code is correct, `Err(MacError)` otherwiseÁ ü®/ , mac.verify_slice(&code_bytes[..]).unwrap();Á <Þ ž+ æ ú Üê # Block and input sizesÁ ü†P M Usually it is assumed that block size is larger than output size. Due to theÁ ü×P M generic nature of the implementation, this edge case must be handled as wellÁ ü¨Q N to remove potential panic. This is done by truncating hash output to the hashÁ Ìú block size if needed.Á ” ú ü˜& # [`digest`]: https://docs.rs/digestÁ ü¿" [`sha2`]: https://docs.rs/sha2Á üâ? < [`RustCrypto/hashes`]: https://github.com/RustCrypto/hashesÁ Dhttps://raw.githubusercontent.com/RustCrypto/media/26acc39f/logo.svgÁ„– ×3lº https://docs.rs/hmac/0.12.1Álõ
|
|||
|
|
Y��‘íÏ _Þ ìñ ù € —& ¶> ± Ê Q - ŒÜ b / �Ês “ ŽÏ Ï Ï Þ Þ \Ò ñ 4ä ´ä & & > > L¤ ,¨ -/°\ ‘
|
|||
|
|
š$ �
|
|||
|
|
|
|||
|
|
¥$ �
|
|||
|
|
× 1 `
|
|||
|
|
ž,6 ‰f
|
|||
|
|
ResetÁ,d +
|
|||
|
|
EagerÁ,‹ R
|
|||
|
|
|
|||
|
|
AlgorithmNameÁlª -
|
|||
|
|
€,¹
|
|||
|
|
—lÀ
|
|||
|
|
BufferÁ4Ï “
|
|||
|
|
BufferKindUserÁt× —
|
|||
|
|
CoreProxyÁLç î
|
|||
|
|
CoreWrapperÁ\ò “
|
|||
|
|
FixedOutputCoreÁ|‡ ™
|
|||
|
|
OutputSizeUserÁt˜
|
|||
|
|
|
|||
|
|
UpdateCoreÁT¨ •
|
|||
|
|
KeyÁ Ï
|
|||
|
|
! KeySizeUserÁ\Ô #
|
|||
|
|
" IsLessÁ4ÿ Õ$
|
|||
|
|
$ LeÁ‡ †!
|
|||
|
|
%¨<‹ ó
|
|||
|
|
& U256Á$” ƒ
|
|||
|
|
'
|
|||
|
|
HashMarkerÁTŸ °
|
|||
|
|
(
|
|||
|
|
InvalidLengthÁl« J
|
|||
|
|
)ö: K
|
|||
|
|
) KeyInitÁ<º /
|
|||
|
|
* MacMarkerÁLÃ ø
|
|||
|
|
+°4Î
|
|||
|
|
,,¾Á²µ¥¨$*›ž�’l\�4oœ}tüo/\_PSDG25éìÍвµœŸüoÝ‘”z}üo�mp^aQT@C),êìÓÕÄÆ„õ ÔÚ Generic HMAC instance.Á$þ • . . ÍìÑ ƒ““ Ò8 •í� – bufferÁ� É1 ïÀ« ”FH ´ß ü£; 8 Generic core HMAC instance, which operates over blocks.Á Dê • 0 0 è> ó îÑ Lƒ °Ñ ï T› •Ê@ T° ™Ê@ |Å —Ê@ üß" Ê@˜ RR ¢7 î_ȼbÞ? ”î ³ Ê@ <Œ ØÊ@ ,ž Õ$Ê@ šAšA UIntÁ �A msbÁ žA lsbÁ o¤¸ëW¨6ÌšAšA í@ �Aú@ žAˆA o¤¸ëW¨6ÌšAšA í@ �Aú@ žAˆA o¤¸ëW¨6ÌšAšA í@ �Aú@ žAˆA o¤¸ëW¨6ÌšAšA í@ �Aú@ žAˆA o¤¸ëW¨6ÌšAšA í@ �Aú@ žAˆA o¤¸ëW¨6ÌšAšA í@ �Aú@ žAˆA o¤¸ëW¨6ÌšAšA í@ �Aú@ žAˆA o¤¸ëW¨6ÌšAšA í@ �Aú@ žAˆA o¤¸ëW¨6ÌÆAÆAÇA UTermÁ ~é.š›@Á Ó.Ó.Ô. B1Á jÛ85ÖËÕ ½.½.¾. B0Á ÿ³2‹ŒÌ« ¸F¸F¸F¸F¸F¸F¸F dÐ ó ÚAãA ×$ <“” 0šT‰DÔ$î 123}€ |¢4¢
|
|||
|
|
/ / Ê@¤·\·
|
|||
|
|
/ / Ê@¤ï »ŸŒ×ÌÑ\ï
|
|||
|
|
/ / Ê@üˆÃ • 5 5 ‡A”ž ´@L³ Ã@TË Ù@Tà è@|õ ÷@ü� " è> � µA<¼ ÄA,Î ÓAd€
|
|||
|
|
úF<Ã
|
|||
|
|
”6 Ù 6 ,. ¼Ò
|
|||
|
|
,Õ
|
|||
|
|
› ›” ” 4 Û
|
|||
|
|
4
|
|||
|
|
6Ñ$Ü
|
|||
|
|
üÃ Ç • 8 8 ‡A”Ý
|
|||
|
|
´@Lò Ã@TŠ
|
|||
|
|
Ù@TŸ
|
|||
|
|
è@|´
|
|||
|
|
÷@üÎ
|
|||
|
|
" è> È µA<û
|
|||
|
|
ÄA,� ÓAd¿ úF<‚” #% ü�Ì • : : ‡A”¯ ´@LÄ Ã@TÜ Ù@Tñ è@|† ÷@ü " è> • µA<Í ÄA,ß ÓAd‘ úF<Ô”; ˜ )+ |ãTè 9 9 ‘AüÿÉ • = = ‡A”› ´@L° Ã@TÈ Ù@TÝ è@|ò ÷@üŒ" è> „ µA<¹ ÄA,Ë ÓAdý úF<À”> $ (* dÏ<Ô < < ÚAü—Ë • @ @ ‡A”µ ´@LÊ Ã@Tâ Ù@T÷ è@|Œ ÷@ü¦" è> œ µA<Ó ÄA,å ÓAd— úF<Ú”A (* téLî ? ? ÚAü³Ì • C C ‡A”Ò ´@Lç Ã@Tÿ Ù@T” è@|© ÷@üÃ" è> ¸ µA<ð ÄA,‚ ÓAd´ úF<÷”D ! (* |†T‹ B B Ê@ !üÓÅ • F F ‡A”ë ´@L€ Ã@T˜ Ù@T è@| ÷@üÜ " è> Ø µA<‰ ÄA,› ÓAdÍ úF<� ”GH 0 1 H G 35 üµ ¸ œ œ’’ GenericArrayÁ • dataÁ 2=d×úÙ—¨” $ ” E Á E
|
|||
|
|
GÑ keyÁ ¼ ü® <t± � �
|
|||
|
|
¨ Ö¿Ù¿ Ú¿« Û¿ˆ Ü¿ Ý¿Þ¿ˆ ‚†f|Â
|
|||
|
|
”JJKö: „O5ϸ{± E Å E
|