Ë #CeL/ãó —ddlmZmZddlZddlmZddlmZddlm Z m Z m Z Gd„deje «Z Gd„d eje «Zy) é)ÚClassVarÚOptionalN)Úencoding)Ú exceptions)ÚEncryptedMessageÚ StringFixerÚrandomc óâ—eZdZUdZej j Zee e d<ej jZ ee e d<ej jZee e d<ej jZee e d<ej$fdedej(fd„Zd efd „Zd ej$fd ed eedej(d efd„Zd ej$fded eedej(d efd„Zy )Ú SecretBoxuS The SecretBox class encrypts and decrypts messages using the given secret key. The ciphertexts generated by :class:`~nacl.secret.Secretbox` include a 16 byte authenticator which is checked as part of the decryption. An invalid authenticator will cause the decrypt function to raise an exception. The authenticator is not a signature. Once you've decrypted the message you've demonstrated the ability to create arbitrary valid message, so messages you send are repudiable. For non-repudiable messages, sign them after encryption. Encryption is done using `XSalsa20-Poly1305`_, and there are no practical limits on the number or size of messages (up to 2â¶â´ messages, each up to 2â¶â´ bytes). .. _XSalsa20-Poly1305: https://doc.libsodium.org/secret-key_cryptography/secretbox#algorithm-details :param key: The secret key used to encrypt and decrypt messages :param encoder: The encoder class used to decode the given key :cvar KEY_SIZE: The size that the key is required to be. :cvar NONCE_SIZE: The size that the nonce is required to be. :cvar MACBYTES: The size of the authentication MAC tag in bytes. :cvar MESSAGEBYTES_MAX: The maximum size of a message which can be safely encrypted with a single key/nonce pair. ÚKEY_SIZEÚ NONCE_SIZEÚMACBYTESÚMESSAGEBYTES_MAXÚkeyÚencodercóò—|j|«}t|t«stjd«‚t |«|j k7r"tjd|j z«‚||_y)Nz'SecretBox must be created from 32 bytesú%The key must be exactly %s bytes long© ÚdecodeÚ isinstanceÚbytesÚexcÚ TypeErrorÚlenr Ú ValueErrorÚ_key©Úselfrrs ú+lib/python3.12/site-packages/nacl/secret.pyÚ__init__zSecretBox.__init__;sb€ðn‰n˜SÓ!ˆÜ˜#œuÔ%Ü—-‘-Ð IÓJÐ Jä ˆs‹8t—}‘}Ò $Ü—.‘.Ø7¸$¿-¹-ÑGóð ðˆ óÚreturncó—|jS©N©r©rs rÚ __bytes__zSecretBox.__bytes__Ió €Øy‰yÐr!NÚ plaintextÚnoncecó—|€t|j«}t|«|jk7r"tjd|jz«‚t j j|||j«}|j|«}|j|«}tj|||j||z««S)aL Encrypts the plaintext message using the given `nonce` (or generates one randomly if omitted) and returns the ciphertext encoded with the encoder. .. warning:: It is **VITALLY** important that the nonce is a nonce, i.e. it is a number used only once for any given key. If you fail to do this, you compromise the privacy of the messages encrypted. Give your nonces a different prefix, or have one side use an odd counter and one an even counter. Just make sure they are different. :param plaintext: [:class:`bytes`] The plaintext message to encrypt :param nonce: [:class:`bytes`] The nonce to use in the encryption :param encoder: The encoder to use to encode the ciphertext :rtype: [:class:`nacl.utils.EncryptedMessage`] ú'The nonce must be exactly %s bytes long) r r rrrÚnaclÚbindingsÚcrypto_secretboxrÚencoderÚ _from_parts)rr)r*rÚ ciphertextÚ encoded_nonceÚencoded_ciphertexts rÚencryptzSecretBox.encryptLs®€ð, ˆ=ܘ4Ÿ?™?Ó+ˆEä ˆu‹:˜Ÿ™Ò (Ü—.‘.Ø9¸D¿O¹OÑKóð ô—]‘]×3Ñ3Ø u˜dŸi™ió ˆ ð Ÿ™ uÓ-ˆ Ø$Ÿ^™^¨JÓ7Ðä×+Ñ+Ø Ø Ø N‰N˜5 :Ñ-Ó .ó ð r!r2có2—|j|«}|€|d|j}||jd}t|«|jk7r"tjd|jz«‚t j j|||j«}|S©aá Decrypts the ciphertext using the `nonce` (explicitly, when passed as a parameter or implicitly, when omitted, as part of the ciphertext) and returns the plaintext message. :param ciphertext: [:class:`bytes`] The encrypted message to decrypt :param nonce: [:class:`bytes`] The nonce used when encrypting the ciphertext :param encoder: The encoder used to decode the ciphertext. :rtype: [:class:`bytes`] Nr,) rr rrrr-r.Úcrypto_secretbox_openr)rr2r*rr)s rÚdecryptzSecretBox.decryptws€ð$—^‘^ JÓ/ˆ à ˆ=àÐ0 §¡Ð1ˆEØ# D§O¡OÐ$5Ð6ˆJä ˆu‹:˜Ÿ™Ò (Ü—.‘.Ø9¸D¿O¹OÑKóð ô—M‘M×7Ñ7Ø ˜˜tŸy™yó ˆ ðÐr!)Ú__name__Ú __module__Ú __qualname__Ú__doc__r-r.Úcrypto_secretbox_KEYBYTESr rÚintÚ__annotations__Úcrypto_secretbox_NONCEBYTESr Úcrypto_secretbox_MACBYTESrÚ!crypto_secretbox_MESSAGEBYTES_MAXrrÚ RawEncoderrÚEncoderr r'rrr5r9©r!rr r s-…ñð:#Ÿm™m×EÑE€Hˆhs‰mÓEØ $§ ¡ × IÑ I€J˜‘ ÓIØ"Ÿm™m×EÑE€Hˆhs‰mÓEð ‰ ×7Ñ7ðhØ ñó8ð 7?×6IÑ6Iñ Øð Ø#+×#3Ñ#3ó ð˜5óð "&Ø$,×$7Ñ$7ñ ) àð) ð˜‰ð) ð×!Ñ!ð ) ð ó ) ð\"&Ø$,×$7Ñ$7ñ "àð"ð˜‰ð"ð×!Ñ!ð "ð ô "r!r c ó¬—eZdZdZej j Zej jZ ej jZ ej jZ ejfdedej"fd„Zdefd„Zddejfd ed ed eedej"def d „Zddejfd ed ed eedej"def d„Zy)ÚAeaduñ The AEAD class encrypts and decrypts messages using the given secret key. Unlike :class:`~nacl.secret.SecretBox`, AEAD supports authenticating non-confidential data received alongside the message, such as a length or type tag. Like :class:`~nacl.secret.Secretbox`, this class provides authenticated encryption. An inauthentic message will cause the decrypt function to raise an exception. Likewise, the authenticator should not be mistaken for a (public-key) signature: recipients (with the ability to decrypt messages) are capable of creating arbitrary valid message; in particular, this means AEAD messages are repudiable. For non-repudiable messages, sign them after encryption. The cryptosystem used is `XChacha20-Poly1305`_ as specified for `standardization`_. There are `no practical limits`_ to how much can safely be encrypted under a given key (up to 2â¶â´ messages each containing up to 2â¶â´ bytes). .. _standardization: https://datatracker.ietf.org/doc/html/draft-irtf-cfrg-xchacha .. _XChacha20-Poly1305: https://doc.libsodium.org/secret-key_cryptography/aead#xchacha-20-poly1305 .. _no practical limits: https://doc.libsodium.org/secret-key_cryptography/aead#limitations :param key: The secret key used to encrypt and decrypt messages :param encoder: The encoder class used to decode the given key :cvar KEY_SIZE: The size that the key is required to be. :cvar NONCE_SIZE: The size that the nonce is required to be. :cvar MACBYTES: The size of the authentication MAC tag in bytes. :cvar MESSAGEBYTES_MAX: The maximum size of a message which can be safely encrypted with a single key/nonce pair. rrcóò—|j|«}t|t«stjd«‚t |«|j k7r"tjd|j z«‚||_y)Nz"AEAD must be created from 32 bytesrrrs rr z Aead.__init__Èsb€ð n‰n˜SÓ!ˆÜ˜#œuÔ%Ü—-‘-Ð DÓEÐ Eä ˆs‹8t—}‘}Ò $Ü—.‘.Ø7¸$¿-¹-ÑGóð ðˆ r!r"có—|jSr$r%r&s rr'zAead.__bytes__Ør(r!r!Nr)Úaadr*có’—|€t|j«}t|«|jk7r"tjd|jz«‚t j j||||j«}|j|«}|j|«}tj|||j||z««S)a@ Encrypts the plaintext message using the given `nonce` (or generates one randomly if omitted) and returns the ciphertext encoded with the encoder. .. warning:: It is vitally important for :param nonce: to be unique. By default, it is generated randomly; [:class:`Aead`] uses XChacha20 for extended (192b) nonce size, so the risk of reusing random nonces is negligible. It is *strongly recommended* to keep this behaviour, as nonce reuse will compromise the privacy of encrypted messages. Should implicit nonces be inadequate for your application, the second best option is using split counters; e.g. if sending messages encrypted under a shared key between 2 users, each user can use the number of messages it sent so far, prefixed or suffixed with a 1bit user id. Note that the counter must **never** be rolled back (due to overflow, on-disk state being rolled back to an earlier backup, ...) :param plaintext: [:class:`bytes`] The plaintext message to encrypt :param nonce: [:class:`bytes`] The nonce to use in the encryption :param encoder: The encoder to use to encode the ciphertext :rtype: [:class:`nacl.utils.EncryptedMessage`] r,) r r rrrr-r.Ú*crypto_aead_xchacha20poly1305_ietf_encryptrr0rr1)rr)rKr*rr2r3r4s rr5z Aead.encryptÛs°€ð< ˆ=ܘ4Ÿ?™?Ó+ˆEä ˆu‹:˜Ÿ™Ò (Ü—.‘.Ø9¸D¿O¹OÑKóð ô—]‘]×MÑMØ s˜E 4§9¡9ó ˆ ð Ÿ™ uÓ-ˆ Ø$Ÿ^™^¨JÓ7Ðä×+Ñ+Ø Ø Ø N‰N˜5 :Ñ-Ó .ó ð r!r2có4—|j|«}|€|d|j}||jd}t|«|jk7r"tjd|jz«‚t j j||||j«}|Sr7) rr rrrr-r.Ú*crypto_aead_xchacha20poly1305_ietf_decryptr)rr2rKr*rr)s rr9z Aead.decrypts‘€ð&—^‘^ JÓ/ˆ à ˆ=àÐ0 §¡Ð1ˆEØ# D§O¡OÐ$5Ð6ˆJä ˆu‹:˜Ÿ™Ò (Ü—.‘.Ø9¸D¿O¹OÑKóð ô—M‘M×LÑLØ ˜˜U D§I¡Ió ˆ ðÐr!)r:r;r<r=r-r.Ú+crypto_aead_xchacha20poly1305_ietf_KEYBYTESr Ú,crypto_aead_xchacha20poly1305_ietf_NPUBBYTESr Ú)crypto_aead_xchacha20poly1305_ietf_ABYTESrÚ3crypto_aead_xchacha20poly1305_ietf_MESSAGEBYTES_MAXrrrDrrEr r'rrr5r9rFr!rrHrHœs„ñ"ðH}‰}×HÑH€HØ—‘×KÑK€JØ}‰}×FÑF€Hà ‰ ×IÑIðð%-×$7Ñ$7ñà ðð×!Ñ!óð ˜5óð Ø!%Ø$,×$7Ñ$7ñ 1 àð1 ðð1 ð˜‰ð 1 ð ×!Ñ!ð 1 ð ó 1 ðlØ!%Ø$,×$7Ñ$7ñ #àð#ðð#ð˜‰ð #ð ×!Ñ!ð #ð ô #r!rH)ÚtypingrrÚ nacl.bindingsr-rrrÚ nacl.utilsrrr Ú Encodabler rHrFr!rúrXsFð÷&ãÝÝ"ß<Ñ<ôC×"Ñ" KôCôLUˆ8× Ñ ˜{õUr!