§ ÁÞMhãóº—dZddlmZddlmZddlmZmZddlm Z m Z ddl m Z m Z mZgd¢Ze jZ Gd „d e¦«Zefd"d„Zefd"d„Zd#d„Zd$d„Zd%d „Zd!S)&a> Low-level functions if you want to build your own higher level abstractions. .. warning:: This is a "Hazardous Materials" module. You should **ONLY** use it if you're 100% absolutely sure that you know what you're doing because this module is full of land mines, dragons, and dinosaurs with laser guns. é)Ú annotations)ÚEnum)ÚAnyÚLiteral)ÚffiÚlibé)Ú HashingErrorÚVerificationErrorÚVerifyMismatchError)ÚARGON2_VERSIONÚTyperÚ hash_secretÚhash_secret_rawÚ verify_secretcó<—eZdZdZejZejZej Z dS)rzX Enum of Argon2 variants. Please see :doc:`parameters` on how to pick one. N) Ú__name__Ú __module__Ú __qualname__Ú__doc__rÚArgon2_dÚDÚArgon2_iÚIÚ Argon2_idÚID©óúP/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/argon2/low_level.pyrr(s/€€€€€ððð Œ €AØ Œ €AØ Œ€B€B€BrrÚsecretÚbytesÚsaltÚ time_costÚintÚ memory_costÚ parallelismÚhash_lenÚtypeÚversionÚreturncóæ—tj|||t|¦«||j¦«dz}t jd|¦«} tj|||t jd|¦«t|¦«t jd|¦«t|¦«tj|| ||j|¦ « } | tjkrtt| ¦«¦«‚t j | ¦«S)a© Hash *secret* and return an **encoded** hash. An encoded hash can be directly passed into :func:`verify_secret` as it contains all parameters and the salt. Args: secret: Secret to hash. salt: A salt_. Should be random and different for each secret. type: Which Argon2 variant to use. version: Which Argon2 version to use. For an explanation of the Argon2 parameters see :class:`argon2.PasswordHasher`. Returns: An encoded Argon2 hash. Raises: argon2.exceptions.HashingError: If hashing fails. .. versionadded:: 16.0.0 .. _salt: https://en.wikipedia.org/wiki/Salt_(cryptography) r úchar[]ú uint8_t[]) rÚargon2_encodedlenÚlenÚvaluerÚnewÚ argon2_hashÚNULLÚ ARGON2_OKr Ú error_to_strÚstring) r r"r#r%r&r'r(r)ÚsizeÚbufÚrvs rrr4sä€õN ÔØ Ø Ø Ý ‰IŒIØ Ø ŒJñ  ô ð ñ ð õ Œ'(˜DÑ !Ô !€CÝ ŒØØØÝ Œ ˜VÑ$Ô$Ý ˆF‰ Œ Ý Œ ˜TÑ"Ô"Ý ˆD‰ Œ Ý ŒØØ Ø Ø Œ Øñ ô €Bð SŒ]ÒÐÝ<¨Ñ+Ô+Ñ,Ô,Ð,å Œ:c‰?Œ?Ðrcó¦—tjd|¦«}tj|||tjd|¦«t |¦«tjd|¦«t |¦«||tjd|j|¦ « } | tjkrtt| ¦«¦«‚ttj ||¦«¦«S)z— Hash *password* and return a **raw** hash. This function takes the same parameters as :func:`hash_secret`. .. versionadded:: 16.0.0 r-r) rr1rr2r/r3r0r4r r5r!Úbuffer) r r"r#r%r&r'r(r)r8r9s rrr{s´€õ" Œ'+˜xÑ (Ô (€Cå ŒØØØÝ Œ ˜VÑ$Ô$Ý ˆF‰ Œ Ý Œ ˜TÑ"Ô"Ý ˆD‰ Œ Ø ØÝ ŒØ Ø Œ Øñ ô €Bð SŒ]ÒÐÝ<¨Ñ+Ô+Ñ,Ô,Ð,å •”˜C Ñ*Ô*Ñ +Ô +Ð+rÚhashú Literal[True]cóT—tjtjd|¦«tjd|¦«t |¦«|j¦«}|tjkrdS|tjkrtt|¦«¦«‚tt|¦«¦«‚)aB Verify whether *secret* is correct for *hash* of *type*. Args: hash: An encoded Argon2 hash as returned by :func:`hash_secret`. secret: The secret to verify whether it matches the one in *hash*. type: Type for *hash*. Raises: argon2.exceptions.VerifyMismatchError: If verification fails because *hash* is not valid for *secret* of *type*. argon2.exceptions.VerificationError: If verification fails for other reasons. Returns: ``True`` on success, raise :exc:`~argon2.exceptions.VerificationError` otherwise. .. versionadded:: 16.0.0 .. versionchanged:: 16.1.0 Raise :exc:`~argon2.exceptions.VerifyMismatchError` on mismatches instead of its more generic superclass. r,r-T) rÚ argon2_verifyrr1r/r0r4ÚARGON2_VERIFY_MISMATCHr r5r )r<r r(r9s rrr£s€õ< Ô Ý Œ˜$ÑÔÝ Œ ˜VÑ$Ô$Ý ˆF‰ Œ Ø Œ ñ  ô €Bð SŒ]ÒÐ؈tà SÔ 'Ò'Ð'Ý!¥,¨rÑ"2Ô"2Ñ3Ô3Ð3å L¨Ñ,Ô,Ñ -Ô -Ð-rÚcontextrcó,—tj||¦«S)a¦ Direct binding to the ``argon2_ctx`` function. .. warning:: This is a strictly advanced function working on raw C data structures. Both Argon2's and *argon2-cffi*'s higher-level bindings do a lot of sanity checks and housekeeping work that *you* are now responsible for (e.g. clearing buffers). The structure of the *context* object can, has, and will change with *any* release! Use at your own peril; *argon2-cffi* does *not* use this binding itself. Args: context: A CFFI Argon2 context object (i.e. an ``struct Argon2_Context`` / ``argon2_context``). type: Which Argon2 variant to use. You can use the ``value`` field of :class:`Type`'s fields. Returns: An Argon2 error code. Can be transformed into a string using :func:`error_to_str`. .. versionadded:: 16.0.0 )rÚ argon2_ctx)rAr(s rÚcorerDÑs€õ: Œ>˜' 4Ñ (Ô (Ð(rÚerrorÚstrcót—tjtj|¦«¦« d¦«S)zê Convert an Argon2 error code into a native string. Args: error: An Argon2 error code as returned by :func:`core`. Returns: A human-readable string describing the error. .. versionadded:: 16.0.0 Úascii)rr6rÚargon2_error_messageÚdecode)rEs rr5r5ñs-€õ Œ:•cÔ.¨uÑ5Ô5Ñ 6Ô 6× =Ò =¸gÑ FÔ FÐFrN)r r!r"r!r#r$r%r$r&r$r'r$r(rr)r$r*r!)r<r!r r!r(rr*r=)rArr(r$r*r$)rEr$r*rF)rÚ __future__rÚenumrÚtypingrrÚ_argon2_cffi_bindingsrrÚ exceptionsr r r Ú__all__ÚARGON2_VERSION_NUMBERr rrrrrDr5rrrúrRs^ðððð#Ð"Ð"Ð"Ð"Ð"àÐÐÐÐÐØÐÐÐÐÐÐÐà*Ð*Ð*Ð*Ð*Ð*Ð*Ð*àLÐLÐLÐLÐLÐLÐLÐLÐLÐLð ð ð €ðÔ*€ðð ð ð ð ð ˆ4ñ ô ð ð("ðDðDðDðDðDð^"ð%,ð%,ð%,ð%,ð%,ðP+.ð+.ð+.ð+.ð\)ð)ð)ð)ð@ Gð Gð Gð Gð Gð Gr