ó ø¢TQc@s{dZddlmZddlZddlZddlZddlZddlmZddl m Z ddl m Z ddl mZmZddlmZmZmZdd lmZd efd „ƒYZd efd „ƒYZd„Zd„Zd„Zdd„Zdefd„ƒYZddee d„Z!ddedd„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 deserialised 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(tImproperlyConfigured(tbaseconv(tconstant_time_comparet salted_hmac(t force_bytest force_strt force_text(t import_modulet BadSignaturecBseZdZRS(u" Signature does not match (t__name__t __module__t__doc__(((s,../Django//lib/python/django/core/signing.pyR 3stSignatureExpiredcBseZdZRS(u< Signature timestamp is older than required max_age (R R R (((s,../Django//lib/python/django/core/signing.pyR:scCstj|ƒjdƒS(Nt=(tbase64turlsafe_b64encodetstrip(ts((s,../Django//lib/python/django/core/signing.pyt b64_encodeAscCs&dt|ƒ d}tj||ƒS(NRi(tlenRturlsafe_b64decode(Rtpad((s,../Django//lib/python/django/core/signing.pyt b64_decodeEscCstt|||ƒjƒƒS(N(RRtdigest(tsalttvaluetkey((s,../Django//lib/python/django/core/signing.pyt base64_hmacJsu%django.core.signing.get_cookie_signercCs³tj}|jddƒ\}}yt|ƒ}Wn)tk r\}td||fƒ‚nXyt||ƒ}Wn)tk r›}td||fƒ‚nX|dtjd|ƒS(Nu.iu&Error importing cookie signer %s: "%s"udjango.http.cookiesR( RtSIGNING_BACKENDtrsplitR t ImportErrorRtgetattrtAttributeErrort SECRET_KEY(RtmodpathtmoduletattrtmodtetSigner((s,../Django//lib/python/django/core/signing.pytget_cookie_signerNs tJSONSerializercBs 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,../Django//lib/python/django/core/signing.pyR.cscCstj|jdƒƒS(Nulatin-1(R-tloadstdecode(R0tdata((s,../Django//lib/python/django/core/signing.pyR2fs(R R R R.R2(((s,../Django//lib/python/django/core/signing.pyR+^s 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( R1RRt serializerR8R4t is_compressedt compressedtbase64d((s,../Django//lib/python/django/core/signing.pyR.js   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_ageiR5( RR:tunsignR6R9RR7t decompressR2(RRRR<R@R?RBR4((s,../Django//lib/python/django/core/signing.pyR2‹s'   R)cBs5eZdddd„Zd„Zd„Zd„ZRS(u:cCsVt|ƒ|_t|ptjƒ|_t|pId|jj|jjfƒ|_dS(Nu%s.%s( tstrtsepRR#Rt __class__R R R(R0RRDR((s,../Django//lib/python/django/core/signing.pyt__init__¡s cCs&t|jd||jƒ}t|ƒS(Nusigner(RRRR(R0Rt signature((s,../Django//lib/python/django/core/signing.pyRG¨scCs/t|ƒ}tdƒ||j|j|ƒfS(Nu%s%s%s(RRCRDRG(R0R((s,../Django//lib/python/django/core/signing.pyR;­s cCs‚t|ƒ}|j|kr1td|jƒ‚n|j|jdƒ\}}t||j|ƒƒrnt|ƒStd|ƒ‚dS(NuNo "%s" found in valueiuSignature "%s" does not match(RRDR RRRGR(R0t signed_valueRtsig((s,../Django//lib/python/django/core/signing.pyRA±s  N(R R tNoneRFRGR;RA(((s,../Django//lib/python/django/core/signing.pyR)Ÿs  R:cBs&eZd„Zd„Zdd„ZRS(cCstjjttjƒƒƒS(N(Rtbase62R/tintttime(R0((s,../Django//lib/python/django/core/signing.pyt timestamp½scCsDt|ƒ}tdƒ||j|jƒf}tt|ƒj|ƒS(Nu%s%s%s(RRCRDRNtsuperR:R;(R0R((s,../Django//lib/python/django/core/signing.pyR;Às "cCstt|ƒj|ƒ}|j|jdƒ\}}tjj|ƒ}|dk r‰t j ƒ|}||kr‰t d||fƒ‚q‰n|S(NiuSignature age %s > %s seconds( ROR:RARRDRRKR3RJRMR(R0RR@tresultRNtage((s,../Django//lib/python/django/core/signing.pyRAÅs  N(R R RNR;RJRA(((s,../Django//lib/python/django/core/signing.pyR:»s  (%R t __future__RRR-RMR7t django.confRtdjango.core.exceptionsRt django.utilsRtdjango.utils.cryptoRRtdjango.utils.encodingRRRtdjango.utils.importlibR t ExceptionR RRRRR*tobjectR+RJR6R.R2R)R:(((s,../Django//lib/python/django/core/signing.pyt"s,         !