+ THiNRt^RIHuHt^RIHtHt^RIH t H t H t H t ^RI HtHt^RIHtR.t!RR]P&]P(]P*]P,4tR#)z!hash for SCRAM credential storageN)norm_hash_name pbkdf2_hmac)consteqsaslprep splitcomma to_native_str) ab64_decode ab64_encode) bascii_to_strscramcaa]tRt^toRtRtRtRt^ tRt Rt ^t Rt Rt .ROt.ROtRt]R4t]RRl4t]R 4t]R 4tR t]RV3R ll4tRV3R lltRRlt]R4tV3RltRRlt]RRl4tRtVtV;t #)r aThis class provides a format for storing SCRAM passwords, and follows the :ref:`password-hash-api`. It supports a variable-length salt, and a variable number of rounds. The :meth:`~passlib.ifc.PasswordHash.using` method accepts the following optional keywords: :type salt: bytes :param salt: Optional salt bytes. If specified, the length must be between 0-1024 bytes. If not specified, a 12 byte salt will be autogenerated (this is recommended). :type salt_size: int :param salt_size: Optional number of bytes to use when autogenerating new salts. Defaults to 12 bytes, but can be any value between 0 and 1024. :type rounds: int :param rounds: Optional number of rounds to use. Defaults to 100000, but must be within ``range(1,1<<32)``. :type algs: list of strings :param algs: Specify list of digest algorithms to use. By default each scram hash will contain digests for SHA-1, SHA-256, and SHA-512. This can be overridden by specify either be a list such as ``["sha-1", "sha-256"]``, or a comma-separated string such as ``"sha-1, sha-256"``. Names are case insensitive, and may use :mod:`!hashlib` or `IANA `_ hash names. :type relaxed: bool :param relaxed: By default, providing an invalid value for one of the other keywords will result in a :exc:`ValueError`. If ``relaxed=True``, and the error can be corrected, a :exc:`~passlib.exc.PasslibHashWarning` will be issued instead. Correctable errors include ``rounds`` that are too small or too large, and ``salt`` strings that are too long. .. versionadded:: 1.6 In addition to the standard :ref:`password-hash-api` methods, this class also provides the following methods for manipulating Passlib scram hashes in ways useful for pluging into a SCRAM protocol stack: .. automethod:: extract_digest_info .. automethod:: extract_digest_algs .. automethod:: derive_digest $scram$iilinearNc \VR4pVPV4pVPpV'g \R4hVPVP WB,3#)aHreturn (salt, rounds, digest) for specific hash algorithm. :type hash: str :arg hash: :class:`!scram` hash stored for desired user :type alg: str :arg alg: Name of digest algorithm (e.g. ``"sha-1"``) requested by client. This value is run through :func:`~passlib.crypto.digest.norm_hash_name`, so it is case-insensitive, and can be the raw SCRAM mechanism name (e.g. ``"SCRAM-SHA-1"``), the IANA name, or the hashlib name. :raises KeyError: If the hash does not contain an entry for the requested digest algorithm. :returns: A tuple containing ``(salt, rounds, digest)``, where *digest* matches the raw bytes returned by SCRAM's :func:`Hi` function for the stored password, the provided *salt*, and the iteration count (*rounds*). *salt* and *digest* are both raw (unencoded) bytes. ianazscram hash contains no digests)r from_stringchecksum ValueErrorsaltrounds)clshashalgselfchkmaps&&& 8/usr/lib/python3/dist-packages/passlib/handlers/scram.pyextract_digest_infoscram.extract_digest_infojsM>S&)t$=> >yy$++v{22c VPV4PpVR8XdV#VUu.uFp\WB4NK up#uupi)aReturn names of all algorithms stored in a given hash. :type hash: str :arg hash: The :class:`!scram` hash to parse :type format: str :param format: This changes the naming convention used by the returned algorithm names. By default the names are IANA-compatible; possible values are ``"iana"`` or ``"hashlib"``. :returns: Returns a list of digest algorithms; e.g. ``["sha-1"]`` r)ralgsr)rrformatr rs&&& rextract_digest_algsscram.extract_digest_algssB(t$)) V K7;DF c*"jjo 9"-fmmG.D"EFK+DF   / 1&&++C0 0 1!9&&33C889s E0?F0+F+G ca\\VP44pVPoRP V3RlVP 44pRVP W3,#)r0c 3b<"TF$q R\\SV,44 2xK& R#5i)r/N)r r ).0rrs& r "scram.to_string..s, JS3e1];vc{#;<= >)s,/z$scram$%d$%s$%s)r r rrjoinr r)rrr?rs& @r to_stringscram.to_stringsT[34(( JN))  !DKK#???rc t<Ve VeQhTp\SV`!R/VBpVeVPV4VnV#)N)superusing _norm_algs default_algs)rrPr kwdssubcls __class__s&&&, rrN scram.usingsM  ' ''L&&  #"%..">F  rc <\SV`!R/VBVPpVe"Ve \R4hVP V4pMxVe!VP VP 44pMTVP 'd8\VP4pVP V4V8Xg QRV: 24hM \R4hWn R#)Nz+checksum & algs kwds are mutually exclusivezinvalid default algs: zno algs list specifiedrL) rM__init__r RuntimeErrorrOkeys use_defaultslistrPr;r )rr rQ digest_maprSs&&, rrVscram.__init__ s  4 ]]  %"#PQQ??4(D  #??:??#45D    ))*D??4(D0 S4J4(2S S045 5 rc\V\4'g"\PP VRR4hVP 4F{wr4V\ VR48wd\RV: 24h\V4^ 8d\RV: 24h\V\4'dK\\PP VRR4h RV9d \R4hV#) dictrrz(malformed algorithm name in scram hash: z.SCRAM limits algorithm names to 9 characters: z raw bytesdigestssha-1-sha-1 must be in algorithm list of scram hash) r%r^r2r3ExpectedTypeErroritemsrrr6r&)rrrelaxedrrAs&&& r_norm_checksumscram._norm_checksum s(D))&&**8VZH H#>>+KCnS&11 #KC7!STT3x!| DSGLfe,,ff..v{INN, ( "LM Mrc \V\4'd \V4p\RV44p\;QJdRV4F 'gK RM RM !RV44'd \ R4hRV9d \ R4hV#)znormalize algs parameterc3:"TFp\VR4xK R#5i)rN)rrErs& rrF#scram._norm_algs..7sBTcnS&11Tsc3>"TFp\V4^ 8xK R#5i) N)r6ris& rrFrj8s,ts3x!|tsTFz-SCRAM limits alg names to max of 9 charactersr`ra)r%r9rsortedanyr)rr s&&rrOscram._norm_algs2sq dC d#DBTBB 3,t,333,t, , ,LM M $ LM M rc <\VP4PVP4'gR#\SV`!R/VB#)TrL)setr issupersetrPrM_calc_needs_update)rrQrSs&,rrsscram._calc_needs_update?s<499~(():):;;w)1D11rcaaaaVPoVPoVPoV'd S!SSSV4#\VVVV3RlVP44#)c3<<"TFqS!SSSV43xK R#5iNrL)rErrrrsecrets& rrF'scram._calc_checksum..QsPis$vtVS9:is)rrr)r^r )rrxrrrrs&f&@@@r_calc_checksumscram._calc_checksumIsIyy!! fc2 2PdiiPPPrc \P!V4VPV4pVPpV'g'\ RVP RVP R24hV'dR;rgVP 4FnwrVPW4p \V 4\V 48wd)\ RV R\V 4: R\V 4: 24h\W4'dRpKlRpKp V'dV'd \ R4hV#VPF.pW9gK VPW4p \WV,4u# \R 4h) z expected z hash, got z config string insteadFz mis-sized z digest in scram hash: z != Tz4scram hash verified inconsistently, may be corruptedzsha-1 digest not found!) r2validate_secretrrrnamercrzr6r _verify_algsAssertionError) rrxrfullrrcorrectfailedrrAothers &&&& rverify scram.verifySs6 6"t$CHH:[ :PQ  $ $G%||~ ++F8 v;#e*,$$SE)@VtTWX]T^Sab5))"G!F .6 !WXXN$$C}++F8uSk22% 677r)r )r salt_sizerr l)r`sha-256sha-512)rrzsha-224zsha-384r`)r)NNrw)F)!__name__ __module__ __qualname____firstlineno____doc__r~ setting_kwdsidentdefault_salt_size max_salt_sizedefault_rounds min_rounds max_rounds rounds_costrPrr classmethodrr"r)rrIrNrVrerOrsrzr__static_attributes____classdictcell__ __classcell__)rS __classdict__s@@rr r s4| D:L EMNJJK 3LIL D#3#3J==0BB8- - ^@  &$  2Q'8'8'8r)rpasslib.utils.handlersutilshandlersr2passlib.crypto.digestrr passlib.utilsrrrrpasslib.utils.binaryrr passlib.utils.compatr __all__ HasRounds HasRawSaltHasRawChecksumGenericHandlerr rLrrrsQ'##=FF9.   m8BLL"--):):B