Skip to main content

Django Private URL

Project description

build pypi

This application helps You easy and flexibly implement different features that need use private url for users like registration confirmation, password recovery, access to paid content and so on.

Low level API provides You full control and allow:

  • limiting private url by time and hits

  • auto removing urls that won’t be used

  • knowing number of hits, date of first and last hit for each url

  • controlling token generator

  • saving additional data in JSON format and using it at url hits

  • processing succeeded or failed hits using django signals and controlling server responses

Installation

Requirements:

  • Django v1.8+

1. Install django-privateurl.

  • Via pip:

    $ pip install django-privateurl
  • Via setuptools:

    $ easy_install django-privateurl

For install development version use git+https://github.com/liminspace/django-privateurl.git@develop instead django-privateurl.

2. Set up settings.py in your django project.

INSTALLED_APPS = (
  ...,
  'privateurl',
)

3. Add url pattern in urls.py:

urlpatterns = [
    ...
    url(r'^private/', include('privateurl.urls', namespace='privateurl')),
]

4. Run migrate:

$ manage.py migrate

Usage

First you need create PrivateUrl using create class method:

PrivateUrl.create(action, user=None, expire=None, data=None, hits_limit=1, auto_delete=False,
                  token_size=None, replace=False, dashed_piece_size=None)
  • action – is a slug that using in url and allow distinguish one url of another

  • user – is user instance that you can get in request process

  • expire – is expiration date for private url. You can set datetime or timedelta

  • data – is additional data that will be saved as JSON. Setting a dict object is good idea

  • hits_limit – is limit of requests. Set 0 for unlimit

  • auto_delete – set True if you want remove private url object when it will be not available

  • token_size – set length of token. You can set number of size or tuple with min and max size. Keep None for using value from settings.PRIVATEURL_DEFAULT_TOKEN_SIZE

  • replace – set True if you want remove old exists private url for user and action before creating one

  • dashed_piece_size – split token with dash every N symbols. Keep None for using value from settings.PRIVATEURL_DEFAULT_TOKEN_DASHED_PIECE_SIZE

For example:

from privateurl.models import PrivateUrl

purl = PrivateUrl.create('registration-confirmation', user=user)
user.send_email(
    subject='Registration confirmation',
    body='Follow the link for confirm your registration: {url}'.format(
        url=purl.get_absolute_url(),
    ),
)

For catch private url request you have to create receiver for privateurl_ok signal:

from django.dispatch import receiver
from dju_privateurl.signals import privateurl_ok, privateurl_fail

@receiver(privateurl_ok)
def registration_confirm(request, obj, action, **kwargs):
    if action != 'registration-confirmation':
        return
    if obj.user:
        obj.user.registration_confirm(request=request)

if you want process invalid private url, you can create receiver for privateurl_fail signal:

from django.dispatch import receiver
from dju_privateurl.signals import privateurl_fail

@receiver(privateurl_fail)
def registration_confirm_fail(request, obj, action, **kwargs):
    if action != 'registration-confirmation':
        return
    if obj:
        # private url is expired or has exceeded ``hits_limit``
        pass
    else:
        # private url doesn't exists or token in url is not correct
        pass

After processing privateurl_ok signal will be redirected to root page /.

After processing privateurl_fail signal will be raised Http404 exception.

If you want change this logic you can return dict with key response in receiver:

from django.shortcuts import redirect, render
from django.dispatch import receiver
from dju_privateurl.signals import privateurl_ok, privateurl_fail

@receiver(privateurl_ok)
def registration_confirm(request, obj, action, **kwargs):
    if action != 'registration-confirmation':
        return
    if obj.user:
        obj.user.registration_confirm(request=request)
        obj.user.login()
        return {'response': redirect('user_profile')}

@receiver(privateurl_fail)
def registration_confirm_fail(request, obj, action, **kwargs):
    if action != 'registration-confirmation':
        return
    return {'response': render(request, 'error_pages/registration_confirm_fail.html', status=404)}

For getting data you need use method get_data():

@receiver(privateurl_ok)
def registration_confirm(request, obj, action, **kwargs):
    ...
    data = obj.get_data()
    ...

Settings

PRIVATEURL_URL_NAMESPACE – namespace that you setted in urls.py. By default it is privateurl.

PRIVATEURL_DEFAULT_TOKEN_SIZE – default size of token that will be generated using create or generate_token methods. By default it is (8, 64).

PRIVATEURL_DEFAULT_TOKEN_DASHED_PIECE_SIZE – default number of size of pieces that joined by dash that using in create or generate_token methods. By default it is 12.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-privateurl-1.1.0.tar.gz (10.1 kB view details)

Uploaded Source

Built Distribution

django_privateurl-1.1.0-py2.py3-none-any.whl (15.9 kB view details)

Uploaded Python 2Python 3

File details

Details for the file django-privateurl-1.1.0.tar.gz.

File metadata

File hashes

Hashes for django-privateurl-1.1.0.tar.gz
Algorithm Hash digest
SHA256 d7ff1a3e98d1ed4934be4a0e36f64cada2290a7ec0ef1fd2954b683f2697a1b2
MD5 ac0e7fd6fc31aaa54061ba65235dc8db
BLAKE2b-256 6b7e7bf586d2305a64c6254b9df255f13d4e4ac4b647c85219f825c5edef3995

See more details on using hashes here.

File details

Details for the file django_privateurl-1.1.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for django_privateurl-1.1.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 f1b18b1ade5deba32c6cc4ad5a1ff846be7bcbaca3dac98367ee0171b1fa095f
MD5 f829901d1e58192506c5b032b13c5be1
BLAKE2b-256 735f3093f62ec33483436aa70637bade5ea10c46f3a846757754fd77e9afe23b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page