o eh%@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-_=]*$>0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyzc@eZdZdZdS) BadSignaturezSignature does not match.N__name__ __module__ __qualname____doc__rrF/var/www/html/venv/lib/python3.10/site-packages/django/core/signing.pyr 6r c@r )SignatureExpiredz3Signature timestamp is older than required max_age.Nr rrrrr<rrcCsZ|dkrdS|dkr dnd}t|}d}|dkr)t|d\}}t||}|dks||S)Nr0->)absdivmodBASE62_ALPHABET)ssignencoded remainderrrr b62_encodeBs r!cCsT|dkrdSd}|ddkr|dd}d}d}|D] }|dt|}q||S)Nrrrr)rindex)rrdecodeddigitrrr b62_decodeNs  r'cCst|dS)N=)base64urlsafe_b64encodestrip)rrrr b64_encode[r,cCs dt| d}t||S)Nr()lenr)urlsafe_b64decode)rpadrrr b64_decode_sr2sha1cCstt||||dS)N algorithm)r,rdigestdecode)saltvaluekeyr5rrr base64_hmacds r;cCs dt|S)Nsdjango.http.cookiesr)r:rrr_cookie_signer_keyjs r<%django.core.signing.get_cookie_signercCs&ttj}|ttjtttj|dS)N)r: fallback_keysr8)rrSIGNING_BACKENDr< SECRET_KEYmapSECRET_KEY_FALLBACKS)r8Signerrrrget_cookie_signeros  rDc@s eZdZdZddZddZdS)JSONSerializerzW Simple wrapper around json to be used in signing.dumps and signing.loads. cCstj|dddS)N),:) separatorslatin-1)jsondumpsencode)selfobjrrrrK~szJSONSerializer.dumpscCst|dS)NrI)rJloadsr7)rMdatarrrrOr-zJSONSerializer.loadsN)rrrrrKrOrrrrrExs rEzdjango.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. )r:r8) serializercompress)TimestampSigner sign_object)rNr:r8rQrRrrrrKs rKcCst|||dj|||dS)z| Reverse of dumps(), raise BadSignature if signature fails. The serializer is expected to accept a bytestring. )r:r8r>)rQmax_age)rS unsign_object)rr:r8rQrUr>rrrrOs rOc@sVeZdZddddddddZdddZdd Zd d Zed fd dZefddZ dS)rCNrGr:sepr8r5r>c Gs|ptj|_|dur |ntj|_||_|pd|jj|jjf|_ |p#d|_ |rMt j d|jjdt ddt|gdD]\}}|sF|dkrLt|||qrX __class__rrr8r5warningswarnrzipsetattr _SEP_UNSAFEmatch ValueError) rMr:rXr8r5r>argsargattrrrr__init__s<     zSigner.__init__cCs"|p|j}t|jd|||jdS)Nsignerr4)r:r;r8r5)rMr9r:rrr signatures zSigner.signaturecCsd||j||fSNz%s%s%s)rXrirMr9rrrrsz Signer.signcCsd|j|vr td|j||jd\}}|jg|jD]}t||||r+|Sqtd|)NzNo "%s" found in valuer"zSignature "%s" does not match)rXr rsplitr:r>rri)rM signed_valuer9sigr:rrrunsigns  z Signer.unsignFcCs\||}d}|rt|}t|t|dkr|}d}t|}|r)d|}||S)ae Return URL-safe, hmac signed base64 compressed JSON string. 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. The serializer is expected to return a bytestring. Fr"T.)rKzlibrRr/r,r7r)rMrNrQrRrP is_compressed compressedbase64drrrrTs    zSigner.sign_objectcKsX|j|fi|}|dddk}|r|dd}t|}|r&t|}||S)Nr".)rorLr2rq decompressrO)rM signed_objrQkwargsrtrvrPrrrrV s   zSigner.unsign_objectN) rrrrgrirrorErTrVrrrrrCs ( rCcs2eZdZddZfddZdfdd ZZS) rScCstttSry)r!inttime)rMrrr timestampr-zTimestampSigner.timestampcs d||j|f}t|Srj)rXr|superrrkr\rrrs zTimestampSigner.signNcsjt|}||jd\}}t|}|dur3t|tjr!|}t |}||kr3t d||f|S)zk Retrieve original value and check it wasn't signed more than max_age seconds ago. r"NzSignature age %s > %s seconds) r}rorlrXr' isinstancedatetime timedelta total_secondsr{r)rMr9rUresultr|ager~rrros   zTimestampSigner.unsignry)rrrr|rro __classcell__rrr~rrSs rS)r3)r=)%rr)rrJr{r]rq django.confrdjango.utils.cryptorrdjango.utils.deprecationrdjango.utils.encodingrdjango.utils.module_loadingrdjango.utils.regex_helperr rar Exceptionr rr!r'r,r2r;r<rDrErKrOrCrSrrrrsF#            d