3 š(ƒh”ã@s,dZddlmZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl mZmZddlmZmZmZddlmZejd ƒZGd d „d eƒZGd d „d eƒZdd„Zdd„Zdd„Zd#dd„ZGdd„deƒZ dde dfdd„Z!dde dfdd„Z"Gdd „d eƒ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/SHA1 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") u'hello' >>> signing.loads("ImhlbGxvIg:1QaUZC:YIye-ze3TTx7gtSv422nZA4sgmk-modified") ... BadSignature: Signature failed: ImhlbGxvIg:1QaUZC:YIye-ze3TTx7gtSv422nZA4sgmk-modified 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(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. é)Úunicode_literalsN)Úsettings)Úbaseconv)Úconstant_time_compareÚ salted_hmac)Ú force_bytesÚ force_strÚ force_text)Ú import_stringz^[A-z0-9-_=]*$c@seZdZdZdS)Ú BadSignaturez" Signature does not match N)Ú__name__Ú __module__Ú __qualname__Ú__doc__©rrú7/tmp/pip-install-q3hcpn_q/Django/django/core/signing.pyr 6sr c@seZdZdZdS)ÚSignatureExpiredz< Signature timestamp is older than required max_age N)r r rrrrrrr=srcCstj|ƒjdƒS)Nó=)Úbase64Úurlsafe_b64encodeÚstrip)ÚsrrrÚ b64_encodeDsrcCs dt|ƒ d}tj||ƒS)Nré)ÚlenrÚurlsafe_b64decode)rÚpadrrrÚ b64_decodeHsrcCstt|||ƒjƒƒS)N)rrÚdigest)ÚsaltÚvalueÚkeyrrrÚ base64_hmacMsr"ú%django.core.signing.get_cookie_signercCs$ttjƒ}ttjƒ}|d||dS)Nsdjango.http.cookies)r)r rZSIGNING_BACKENDrÚ SECRET_KEY)rÚSignerr!rrrÚget_cookie_signerQs  r&c@s eZdZdZdd„Zdd„ZdS)ÚJSONSerializerzW Simple wrapper around json to be used in signing.dumps and signing.loads. cCstj|ddjdƒS)Nú,ú:)Ú separatorszlatin-1)r(r))ÚjsonÚdumpsÚencode)ÚselfÚobjrrrr,\szJSONSerializer.dumpscCstj|jdƒƒS)Nzlatin-1)r+ÚloadsÚdecode)r.Údatarrrr0_szJSONSerializer.loadsN)r r rrr,r0rrrrr'Wsr'zdjango.core.signingFc Cs`|ƒj|ƒ}d}|r:tj|ƒ}t|ƒt|ƒdkr:|}d}t|ƒ}|rNd|}t||dj|ƒS)a‹ Returns URL-safe, sha1 signed base64 compressed JSON string. If key is None, settings.SECRET_KEY is used instead. If compress is True (not the default) checks if compressing using zlib can save some space. Prepends 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. FéTó.)r)r,ÚzlibÚcompressrrÚTimestampSignerÚsign) r/r!rÚ serializerr6r2Z is_compressedÚ compressedÚbase64drrrr,cs  r,cCs`tt||dj||dƒ}d}|dd…dkr>|dd…}d}t|ƒ}|rTtj|ƒ}|ƒj|ƒS)z} Reverse of dumps(), raises BadSignature if signature fails. The serializer is expected to accept a bytestring. )r)Úmax_ageFNr3r4T)rr7Úunsignrr5Ú decompressr0)rr!rr9r<r;r>r2rrrr0„s  r0c@s.eZdZd dd„Zdd„Zdd„Zd d „ZdS) r%Nr)cCsP|ptj|_t|ƒ|_tj|jƒr.td|ƒ‚t|pFd|jj |jj fƒ|_ dS)NzJUnsafe Signer separator: %r (cannot be empty or consist of only A-z0-9-_=)z%s.%s) rr$r!rÚsepÚ _SEP_UNSAFEÚmatchÚ ValueErrorÚ __class__r r r)r.r!r?rrrrÚ__init__šs   zSigner.__init__cCst|jd||jƒ}t|ƒS)NZsigner)r"rr!r)r.r Ú signaturerrrrE¥szSigner.signaturecCs"t|ƒ}tdƒ||j|j|ƒfS)Nz%s%s%s)rÚstrr?rE)r.r rrrr8ªsz Signer.signcCsZt|ƒ}|j|kr td|jƒ‚|j|jdƒ\}}t||j|ƒƒrJt|ƒStd|ƒ‚dS)NzNo "%s" found in valuer3zSignature "%s" does not match)rr?r ÚrsplitrrEr )r.Z signed_valuer Úsigrrrr=®s z Signer.unsign)Nr)N)r r rrDrEr8r=rrrrr%˜s r%cs2eZdZdd„Z‡fdd„Zd‡fdd„ Z‡ZS) r7cCstjjttjƒƒƒS)N)rÚbase62r-ÚintÚtime)r.rrrÚ timestampºszTimestampSigner.timestampcs0t|ƒ}tdƒ||j|jƒf}tt|ƒj|ƒS)Nz%s%s%s)rrFr?rLÚsuperr7r8)r.r )rCrrr8½szTimestampSigner.signNcsrtt|ƒj|ƒ}|j|jdƒ\}}tjj|ƒ}|dk rnt|t j ƒrJ|j ƒ}t j ƒ|}||krnt d||fƒ‚|S)zk Retrieve original value and check it wasn't signed more than max_age seconds ago. r3NzSignature age %s > %s seconds)rMr7r=rGr?rrIr1Ú isinstanceÚdatetimeÚ timedeltaÚ total_secondsrKr)r.r r<ÚresultrLZage)rCrrr=Âs   zTimestampSigner.unsign)N)r r rrLr8r=Ú __classcell__rr)rCrr7¸s r7)r#)%rÚ __future__rrrOr+ÚrerKr5Z django.confrZ django.utilsrZdjango.utils.cryptorrZdjango.utils.encodingrrr Zdjango.utils.module_loadingr Úcompiler@Ú Exceptionr rrrr"r&Úobjectr'r,r0r%r7rrrrÚ"s0       !