Ë
|
¬`iO. ã ó¨ d dl mZ d dlmZ d dlmZ d dlmZmZ d dl m
|
Z
|
d dl m Z d dl mZmZ d dlmZ d Z ed
|
d d ¬ « Z G d de« Zd ZdZy)é )Ú unhexlify)ÚChaCha20)Ú
|
_HChaCha20)ÚPoly1305ÚBLAKE2s)Úget_random_bytes)Ú long_to_bytes)Ú _copy_bytesÚbord)Ú is_bufferc ó t dd| « S )NÚEnum© )Útype)Úenumss õr H:\项ç®\archive\æµè¯ç»\èæ¬\Change_password\venv_build\Lib\site-packages\Crypto/Cipher/ChaCha20_Poly1305.pyÚ_enumr , s Ü EÓ "Ð"ó é é é )ÚPROCESSING_AUTH_DATAÚPROCESSING_CIPHERTEXTÚPROCESSING_DONEc ó\ e Zd ZdZd Zd Zd ZddZddZd Z d Z
|
d
|
Z d Z d Z d Zd Zy)ÚChaCha20Poly1305CipherzÐChaCha20-Poly1305 and XChaCha20-Poly1305 cipher object.
|
Do not create it directly. Use :py:func:`new` instead.
|
|
:var nonce: The nonce with length 8, 12 or 24 bytes
|
:vartype nonce: byte string
|
c ó d| _ t j ||t ¬« | _ t j ||¬« | _ | j
|
j d« d| _ d| _ d| _ t j | _ y)z`Initialize a ChaCha20-Poly1305 AEAD cipher object
|
|
See also `new()` at the module level.)ÚupdateÚencryptÚdecryptÚdigestÚverify)ÚkeyÚnonceÚcipher)r# r$ é@ r N) Ú_nextr Únewr Ú_authenticatorÚ_cipherÚseekÚ_len_aadÚ_len_ctÚ_mac_tagÚ _CipherStatusr Ú_status)Úselfr# r$ s r Ú__init__z ChaCha20Poly1305Cipher.__init__= sh ð
|
|
ô 'll¨s¸%ÌÔ QÔä ||¨°5Ô9 Ø ×Ñ"Ô à Ø Ø Ü$×9Ñ9 r c ó¨ d| j vr t d« | xj t |« z c_ | j j |« y)a Protect the associated data.
|
|
Associated data (also known as *additional authenticated data* - AAD)
|
is the piece of the message that must stay in the clear, while
|
still allowing the receiver to verify its integrity.
|
An example is packet headers.
|
|
The associated data (possibly split into multiple segments) is
|
fed into :meth:`update` before any call to :meth:`decrypt` or :meth:`encrypt`.
|
If there is no associated data, :meth:`update` is not called.
|
|
:param bytes/bytearray/memoryview assoc_data:
|
A piece of associated data. There are no restrictions on its size.
|
r z update() method cannot be calledN)r' Ú TypeErrorr, Úlenr) r )r1 Údatas r r z ChaCha20Poly1305Cipher.updateO sB ð 4::Ñ %ÜÐ >Ó?Ð ?à TÑ" Ø ×Ñ×"Ñ" 4Õ(r c óæ | j t j k( sJ | j dz r.| j j dd| j dz z
|
z « t j | _ y )Né ó é )r0 r/ r r, r) r r ©r1 s r Ú_pad_aadz ChaCha20Poly1305Cipher._pad_aade sZ à||}× AÑ AÒAÐBÐAØ ==4Ò Ø × Ñ × &Ñ & w°"¸¿ ¹ ÈÑ8LÑ2MÑ'NÔ OÜ$×:Ñ: r Nc ó d| j vr t d« | j t j k( r| j « d| _ | j j ||¬« }| xj t |« z c_ | | j j |« |S | j j |« |S )a« Encrypt a piece of data.
|
|
Args:
|
plaintext(bytes/bytearray/memoryview): The data to encrypt, of any size.
|
Keyword Args:
|
output(bytes/bytearray/memoryview): The location where the ciphertext
|
is written to. If ``None``, the ciphertext is returned.
|
Returns:
|
If ``output`` is ``None``, the ciphertext is returned as ``bytes``.
|
Otherwise, ``None``.
|
r z!encrypt() method cannot be called©r r! ©Úoutput) r' r4 r0 r/ r r< r* r r- r5 r) r )r1 Ú plaintextr@ Úresults r r z ChaCha20Poly1305Cipher.encryptl s¤ ð DJJÑ &ÜÐ ?Ó@Ð @à <<=×=Ñ=Ò =Ø MMOà*
|
à ×%Ñ% i¸Ð%Ó?Ø IÑ& Ø >Ø × Ñ × &Ñ & vÔ .ð ð × Ñ × &Ñ & vÔ .Ø r c óH d| j vr t d« | j t j k( r| j « d| _ | xj t |« z c_ | j j |« | j j ||¬« S )a© Decrypt a piece of data.
|
|
Args:
|
ciphertext(bytes/bytearray/memoryview): The data to decrypt, of any size.
|
Keyword Args:
|
output(bytes/bytearray/memoryview): The location where the plaintext
|
is written to. If ``None``, the plaintext is returned.
|
Returns:
|
If ``output`` is ``None``, the plaintext is returned as ``bytes``.
|
Otherwise, ``None``.
|
r z!decrypt() method cannot be called©r r" r? ) r' r4 r0 r/ r r< r- r5 r) r r* r )r1 Ú
|
ciphertextr@ s r r z ChaCha20Poly1305Cipher.decrypt s~ ð DJJÑ &ÜÐ ?Ó@Ð @à <<=×=Ñ=Ò =Ø MMOà*
|
à JÑ' Ø ×Ñ×"Ñ" :Ô.Ø||×#Ñ# J°vÐ#Ó>Ð>r c óÖ | j r+| j t j k( sJ | j S | j t j k7 sJ | j t j k( r| j « | j dz r.| j j dd| j dz z
|
z « t j | _ | j j t | j d« ddd
« | j j t | j d« ddd
« | j j « | _ | j S )z=Finalize the cipher (if not done already) and return the MAC.r8 r9 r: é Néÿÿÿÿ) r. r0 r/ r r r< r- r) r r r, r! r; s r Ú _compute_macz#ChaCha20Poly1305Cipher._compute_mac¢ s ð ==Ø<<¤=×#@Ñ#@Ò@Ð AÐ@Ø==Ð à||}× <Ñ <Ò<Ð=Ð<à <<=×=Ñ=Ò =Ø MMOà <<$Ò Ø × Ñ × &Ñ & w°"¸¿ ¹ ÀtÑ8KÑ2LÑ'MÔ Nä$×4Ñ4 à ×Ñ×"Ñ"¤=°· ± ÀÓ#BÁ4ÀRÀ4Ñ#HÔIØ ×Ñ×"Ñ"¤=°· ± ¸qÓ#AÁ$ÀBÀ$Ñ#GÔHØ ×+Ñ+×2Ñ2Ó4 Ø}}Ð r c ób d| j vr t d« d| _ | j « S )zgCompute the *binary* authentication tag (MAC).
|
|
:Return: the MAC tag, as 16 ``bytes``.
|
r! z digest() method cannot be called)r! )r' r4 rI r; s r r! z ChaCha20Poly1305Cipher.digest¸ s2 ð 4::Ñ %ÜÐ >Ó?Ð ?Ø
|
à× Ñ Ó"Ð"r c ó~ dj | j « D cg c] }dt |« z c}« S c c}w )zCompute the *printable* authentication tag (MAC).
|
|
This method is like :meth:`digest`.
|
|
:Return: the MAC tag, as a hexadecimal string.
|
Ú z%02x)Újoinr! r )r1 Úxs r Ú hexdigestz ChaCha20Poly1305Cipher.hexdigestÄ s0 ð ww°$·+±+³-Ö@¨Q¤ a£Ó(Ò@ÓAÐAùÒ@s :c óF d| j vr t d« d| _ t d« }| j « t j
|
d|| j ¬« }t j
|
d||¬« }|j « |j « k7 r t d« y) aå Validate the *binary* authentication tag (MAC).
|
|
The receiver invokes this method at the very end, to
|
check if the associated data (if any) and the decrypted
|
messages are valid.
|
|
:param bytes/bytearray/memoryview received_mac_tag:
|
This is the 16-byte *binary* MAC, as received from the sender.
|
:Raises ValueError:
|
if the MAC does not match. The message has been tampered with
|
or the key is incorrect.
|
r" z3verify() cannot be called when encrypting a message)r" r: é )Ú digest_bitsr# r6 zMAC check failedN) r' r4 r rI r r( r. r! Ú
|
ValueError)r1 Úreceived_mac_tagÚsecretÚmac1Úmac2s r r" z ChaCha20Poly1305Cipher.verifyÍ s ð 4::Ñ %Üð 9ó :ð :à
|
ä! "Ó%à ×ÑÔä{{ s°Ø $§ ¡ ô/ä{{ s°Ø 0ô2ð ;;=DKKMÒ )Ü Ð /Ó0Ð 0ð *r c ó8 | j t |« « y)a@ Validate the *printable* authentication tag (MAC).
|
|
This method is like :meth:`verify`.
|
|
:param string hex_mac_tag:
|
This is the *printable* MAC.
|
:Raises ValueError:
|
if the MAC does not match. The message has been tampered with
|
or the key is incorrect.
|
N)r" r )r1 Ú hex_mac_tags r Ú hexverifyz ChaCha20Poly1305Cipher.hexverifyì s ð IkÓ*Õ+r c óD | j |« | j « fS )aH Perform :meth:`encrypt` and :meth:`digest` in one step.
|
|
:param plaintext: The data to encrypt, of any size.
|
:type plaintext: bytes/bytearray/memoryview
|
:return: a tuple with two ``bytes`` objects:
|
|
- the ciphertext, of equal length as the plaintext
|
- the 16-byte MAC tag
|
r> )r1 rA s r Úencrypt_and_digestz)ChaCha20Poly1305Cipher.encrypt_and_digestú s ð ||IÓ&¨¯ © « Ð5Ð5r c óJ | j |« }| j |« |S )aß Perform :meth:`decrypt` and :meth:`verify` in one step.
|
|
:param ciphertext: The piece of data to decrypt.
|
:type ciphertext: bytes/bytearray/memoryview
|
:param bytes received_mac_tag:
|
This is the 16-byte *binary* MAC, as received from the sender.
|
:return: the decrypted data (as ``bytes``)
|
:raises ValueError:
|
if the MAC does not match. The message has been tampered with
|
or the key is incorrect.
|
rD )r1 rE rT rA s r Údecrypt_and_verifyz)ChaCha20Poly1305Cipher.decrypt_and_verify s% ð LL Ó, Ø Ð$Ô%ØÐr )N)Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__r2 r r< r r rI r! rO r" rZ r\ r^ r r r r r 5 sD ñò:ò$)ò,;óó:?ò2 ò,
|
#òBò 1ò> ,ò 6ór r c óô | j d« }t |« dk7 r t d« | j dd« }| t d« }t |« dv r|}n1t |« d k( rt ||dd
|
« }d |d
|
d z }n t d « t |« s t d « | rt dt | « z « t ||« }t dd|« |_ |S # t $ r}t d|z « d}~ww xY w)a Create a new ChaCha20-Poly1305 or XChaCha20-Poly1305 AEAD cipher.
|
|
:keyword key: The secret key to use. It must be 32 bytes long.
|
:type key: byte string
|
|
:keyword nonce:
|
A value that must never be reused for any other encryption
|
done with this key.
|
|
For ChaCha20-Poly1305, it must be 8 or 12 bytes long.
|
|
For XChaCha20-Poly1305, it must be 24 bytes long.
|
|
If not provided, 12 ``bytes`` will be generated randomly
|
(you can find them back in the ``nonce`` attribute).
|
:type nonce: bytes, bytearray, memoryview
|
|
:Return: a :class:`Crypto.Cipher.ChaCha20.ChaCha20Poly1305Cipher` object
|
r# zMissing parameter %sNé zKey must be 32 bytes longr$ é )rG re é r: s z$Nonce must be 8, 12 or 24 bytes longz,nonce must be bytes, bytearray or memoryviewzUnknown parameters: ) ÚpopÚKeyErrorr4 r5 rS r r r Ústrr r
|
r$ )Úkwargsr# Úer$ Úchacha20_poly1305_noncer% s r r( r( s ð*4ØjjÓ ô 3x2~ÜÐ4Ó5Ð5à JJw Ó %EØ }Ü Ó$ä
|
5zWÑ Ø"'Ñ Ü UrÒ Üe C RjÓ)Ø"5¸¸b¸c¸
|
Ñ"BÑ äÐ?Ó@Ð@ä UÔ ÜÐFÓGÐGá ÜÐ.´°V³Ñ<Ó=Ð=ä # CÐ)@Ó AFÜ t T¨5Ó1FLØ Møô5 ò 4ÜÐ.°Ñ2Ó3Ð3ûð4ús C à C7Ã$C2Ã2C7rd N)Úbinasciir Ú Crypto.Cipherr ÚCrypto.Cipher.ChaCha20r Ú Crypto.Hashr r Ú Crypto.Randomr ÚCrypto.Util.numberr ÚCrypto.Util.py3compatr
|
r ÚCrypto.Util._raw_apir r r/ Úobjectr r( Úkey_sizer r r ú<module>rw sT ðõ> å "Ý -ß )å *å ,ß 3Ý *ò#ñ ¨1Ø,-Ø&'ô) ô
|
aVô aòH1ðj r
|
