a Lcfh%@s>dZddlZddlZddlZddlZddlZddlZddlmZddl m Z m Z ddl m Z ddlmZddlmZddlmZed Zd ZGd d d eZGd ddeZddZddZddZddZd+ddZddZd,ddZGdd d Z dd!e d"fd#d$Z!dd!e ddfd%d&Z"Gd'd(d(Z#Gd)d*d*e#Z$dS)-a_ Functions for creating and restoring url-safe signed JSON objects. The format used looks like this: >>> signing.dumps("hello") 'ImhlbGxvIg:1QaUZC:YIye-ze3TTx7gtSv422nZA4sgmk' There are two components here, separated by a ':'. The first component is a URLsafe base64 encoded JSON of the object passed to dumps(). The second component is a base64 encoded hmac/SHA-256 hash of "$first_component:$secret" signing.loads(s) checks the signature and returns the deserialized object. If the signature fails, a BadSignature exception is raised. >>> signing.loads("ImhlbGxvIg:1QaUZC:YIye-ze3TTx7gtSv422nZA4sgmk") 'hello' >>> signing.loads("ImhlbGxvIg:1QaUZC:YIye-ze3TTx7gtSv42-modified") ... BadSignature: Signature "ImhlbGxvIg:1QaUZC:YIye-ze3TTx7gtSv42-modified" does not match You can optionally compress the JSON prior to base64 encoding it to save space, using the compress=True argument. This checks if compression actually helps and only applies compression if the result is a shorter string: >>> signing.dumps(list(range(1, 20)), compress=True) '.eJwFwcERACAIwLCF-rCiILN47r-GyZVJsNgkxaFxoDgxcOHGxMKD_T7vhAml:1QaUaL:BA0thEZrp4FQVXIXuOvYJtLJSrQ' The fact that the string is compressed is signalled by the prefixed '.' at the start of the base64 JSON. There are 65 url-safe characters: the 64 used by url-safe base64 and the ':'. These functions make use of all of them. N)settings)constant_time_compare salted_hmac)RemovedInDjango51Warning force_bytes) import_string)_lazy_re_compilez^[A-z0-9-_=]*$Z>0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyzc@seZdZdZdS) BadSignaturezSignature does not match.N__name__ __module__ __qualname____doc__rrP/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/django/core/signing.pyr 6sr c@seZdZdZdS)SignatureExpiredz3Signature timestamp is older than required max_age.Nr rrrrr<srcCsT|dkr dS|dkrdnd}t|}d}|dkrLt|d\}}t||}q(||S)Nr0->)absdivmodBASE62_ALPHABET)ssignencoded remainderrrr b62_encodeBsrcCsT|dkr dSd}|ddkr,|dd}d}d}|D]}|dt|}q4||S)Nrrrr)rindex)rrdecodeddigitrrr b62_decodeNs  r$cCst|dS)N=)base64urlsafe_b64encodestrip)rrrr b64_encode[sr)cCs dt| d}t||S)Nr%)lenr&urlsafe_b64decode)rpadrrr b64_decode_sr.sha1cCstt||||dS)N algorithm)r)rdigestdecode)saltvaluekeyr1rrr base64_hmacdsr7cCs dt|S)Nsdjango.http.cookiesr)r6rrr_cookie_signer_keyjsr8%django.core.signing.get_cookie_signercCs&ttj}|ttjtttj|dS)N)r6 fallback_keysr4)rrZSIGNING_BACKENDr8 SECRET_KEYmapSECRET_KEY_FALLBACKS)r4Signerrrrget_cookie_signeros   r?c@s eZdZdZddZddZdS)JSONSerializerzW Simple wrapper around json to be used in signing.dumps and signing.loads. cCstj|dddS)N),:) separatorslatin-1)jsondumpsencode)selfobjrrrrF~szJSONSerializer.dumpscCst|dS)NrD)rEloadsr3)rHdatarrrrJszJSONSerializer.loadsN)r r rrrFrJrrrrr@xsr@zdjango.core.signingFcCst||dj|||dS)a Return URL-safe, hmac signed base64 compressed JSON string. If key is None, use settings.SECRET_KEY instead. The hmac algorithm is the default Signer algorithm. If compress is True (not the default), check if compressing using zlib can save some space. Prepend a '.' to signify compression. This is included in the signature, to protect against zip bombs. Salt can be used to namespace the hash, so that a signed string is only valid for a given namespace. Leaving this at the default value or re-using a salt value across different parts of your application without good cause is a security risk. The serializer is expected to return a bytestring. )r6r4) serializercompress)TimestampSigner sign_object)rIr6r4rLrMrrrrFs rFcCst|||dj|||dS)z| Reverse of dumps(), raise BadSignature if signature fails. The serializer is expected to accept a bytestring. )r6r4r:)rLmax_age)rN unsign_object)rr6r4rLrPr:rrrrJs rJc@sVeZdZddddddddZdddZdd Zd d Zed fd dZefddZ dS)r>NrBr6sepr4r1r:c Gs|ptj|_|dur|ntj|_||_|ps (  r>cs2eZdZddZfddZdfdd ZZS) rNcCstttS)N)rinttime)rHrrr timestampszTimestampSigner.timestampcs d||j|f}t|Srd)rSrrsuperrrerWrrrszTimestampSigner.signNcsjt|}||jd\}}t|}|durft|tjrB|}t |}||krft d||f|S)zk Retrieve original value and check it wasn't signed more than max_age seconds ago. rNzSignature age %s > %s seconds) rsrhrfrSr$ isinstancedatetime timedelta total_secondsrqr)rHr5rPresultrrZagertrrrhs   zTimestampSigner.unsign)N)r r rrrrrh __classcell__rrrtrrNs rN)r/)r9)%rr&rvrErqrXrjZ django.confrZdjango.utils.cryptorrZdjango.utils.deprecationrZdjango.utils.encodingrZdjango.utils.module_loadingrZdjango.utils.regex_helperr r\r Exceptionr rrr$r)r.r7r8r?r@rFrJr>rNrrrrsD#           d