ó ÌŸ!^c@s’dZddlmZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl mZmZddlmZmZmZddlmZejd ƒZd efd „ƒYZd efd „ƒYZd„Zd„Zd„Zdd„Zdefd„ƒYZ dde e"d„Z#dde dd„Z$defd„ƒYZ%de%fd„ƒYZ&dS(u` 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. iÿÿÿÿ(tunicode_literalsN(tsettings(tbaseconv(tconstant_time_comparet salted_hmac(t force_bytest force_strt force_text(t import_stringu^[A-z0-9-_=]*$t BadSignaturecBseZdZRS(u" Signature does not match (t__name__t __module__t__doc__(((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyR 6stSignatureExpiredcBseZdZRS(u< Signature timestamp is older than required max_age (R R R (((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyR =scCstj|ƒjdƒS(Nt=(tbase64turlsafe_b64encodetstrip(ts((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyt b64_encodeDscCs&dt|ƒ d}tj||ƒS(NRi(tlenRturlsafe_b64decode(Rtpad((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyt b64_decodeHscCstt|||ƒjƒƒS(N(RRtdigest(tsalttvaluetkey((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyt base64_hmacMsu%django.core.signing.get_cookie_signercCs2ttjƒ}ttjƒ}|d|d|ƒS(Nsdjango.http.cookiesR(RRtSIGNING_BACKENDRt SECRET_KEY(RtSignerR((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pytget_cookie_signerQstJSONSerializercBs eZdZd„Zd„ZRS(uW Simple wrapper around json to be used in signing.dumps and signing.loads. cCstj|ddƒjdƒS(Nt separatorsu,u:ulatin-1(u,u:(tjsontdumpstencode(tselftobj((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyR$\scCstj|jdƒƒS(Nulatin-1(R#tloadstdecode(R&tdata((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyR(_s(R R R R$R((((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyR!Ws udjango.core.signingc Cs“|ƒj|ƒ}t}|r[tj|ƒ}t|ƒt|ƒdkr[|}t}q[nt|ƒ}|rzd|}nt|d|ƒj|ƒS(u‹ 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. it.R( R$tFalsetzlibtcompressRtTrueRtTimestampSignertsign( R'RRt serializerR.R*t is_compressedt compressedtbase64d((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyR$cs   cCs„tt|d|ƒj|d|ƒƒ}t}|d dkrP|d}t}nt|ƒ}|rttj|ƒ}n|ƒj|ƒS(u} Reverse of dumps(), raises BadSignature if signature fails. The serializer is expected to accept a bytestring. Rtmax_ageiR+( RR0tunsignR,R/RR-t decompressR((RRRR2R6R5R8R*((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyR(„s'   RcBs5eZdddd„Zd„Zd„Zd„ZRS(u:cCsu|p tj|_t|ƒ|_tj|jƒrFtd|ƒ‚nt|phd|jj |jj fƒ|_ dS(NuJUnsafe Signer separator: %r (cannot be empty or consist of only A-z0-9-_=)u%s.%s( RRRRtsept _SEP_UNSAFEtmatcht ValueErrort __class__R R R(R&RR9R((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyt__init__šs cCs&t|jd||jƒ}t|ƒS(Nusigner(RRRR(R&Rt signature((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyR?¥scCs/t|ƒ}tdƒ||j|j|ƒfS(Nu%s%s%s(RtstrR9R?(R&R((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyR1ªs cCs‚t|ƒ}|j|kr1td|jƒ‚n|j|jdƒ\}}t||j|ƒƒrnt|ƒStd|ƒ‚dS(NuNo "%s" found in valueiuSignature "%s" does not match(RR9R trsplitRR?R(R&t signed_valueRtsig((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyR7®s  N(R R tNoneR>R?R1R7(((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyR˜s  R0cBs&eZd„Zd„Zdd„ZRS(cCstjjttjƒƒƒS(N(Rtbase62R%tintttime(R&((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyt timestampºscCsDt|ƒ}tdƒ||j|jƒf}tt|ƒj|ƒS(Nu%s%s%s(RR@R9RHtsuperR0R1(R&R((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyR1½s "cCs®tt|ƒj|ƒ}|j|jdƒ\}}tjj|ƒ}|dk rªt |t j ƒrr|j ƒ}nt j ƒ|}||krªtd||fƒ‚qªn|S(uk Retrieve original value and check it wasn't signed more than max_age seconds ago. iuSignature age %s > %s secondsN(RIR0R7RAR9RRER)RDt isinstancetdatetimet timedeltat total_secondsRGR (R&RR6tresultRHtage((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyR7Âs  N(R R RHR1RDR7(((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyR0¸s  ('R t __future__RRRKR#treRGR-t django.confRt django.utilsRtdjango.utils.cryptoRRtdjango.utils.encodingRRRtdjango.utils.module_loadingRtcompileR:t ExceptionR R RRRR tobjectR!RDR,R$R(RR0(((s=/var/www/Virtualenvs/nocn/build/Django/django/core/signing.pyt"s0           !