Skip to main content

A Django app to only allow access to certain pages based on IP addresses.

Project description

1 Welcome to django-ip-whitelist’s documentation!

Version:

0.1.4

Source:

https://github.com/maykinmedia/django-ip-whitelist

Keywords:

Django IP Whitelist, IP whitelist, pip package

PythonVersion:

3.9

Build status Code quality checks black Coverage status Documentation Status

python-versions django-versions pypi-version

This package provides a Django middleware that allows you to whitelist IP addresses that are allowed to access your site.

By default the user’s IP needs to conform to the IP whitelist in order to access the Django admin. You can either specify individual IP addresses or IP ranges, and the whitelist is manageable via the Django admin.

2 Installation

2.1 Requirements

  • Python 3.8 or above

  • setuptools 40.8.0 or above

  • Django 3.2 or newer

2.2 Install

pip install django-ip-whitelist

Add ip_whitelist to your INSTALLED_APPS:

INSTALLED_APPS = [
    ...
    'ip_whitelist',
    ...
]

3 Usage

Add the middleware to your MIDDLEWARE setting:

MIDDLEWARE = [
    ...
    'ip_whitelist.middleware.IPWhitelistMiddleware',
    ...
]

Add the IP addresses you want to whitelist to your settings.py:

WHITELIST_IPS = [
    ...
    '127.0.0.1',
    ...
]

Add the WHITELIST_IP_RANGES to your settings.py:

WHITELIST_IP_RANGES = [
    ...
    '
    ...
]

Add the OUTSIDE_IP_DISALLOWED_PATHS to your settings.py with disallowed URLs:

OUTSIDE_IP_DISALLOWED_PATHS = (
    ...
    '/admin',
    ...
)

3.1 Migrations

Run the migrations:

python manage.py migrate

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-ip-whitelist-0.1.4.tar.gz (7.2 kB view details)

Uploaded Source

Built Distribution

django_ip_whitelist-0.1.4-py3-none-any.whl (8.5 kB view details)

Uploaded Python 3

File details

Details for the file django-ip-whitelist-0.1.4.tar.gz.

File metadata

  • Download URL: django-ip-whitelist-0.1.4.tar.gz
  • Upload date:
  • Size: 7.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/5.1.0 pkginfo/1.7.0 requests/2.28.1 requests-toolbelt/0.9.1 tqdm/4.64.1 CPython/3.9.2

File hashes

Hashes for django-ip-whitelist-0.1.4.tar.gz
Algorithm Hash digest
SHA256 3698946363289fb2e4380f9f3cfc56613a78cb6ae516f17bfacf63a406bde1b2
MD5 71564f6e5207c50d11b7f2ec177e2239
BLAKE2b-256 853161fdc281df8d439533272cf95a72dcd0a3e810428b93f426f7d26219781f

See more details on using hashes here.

File details

Details for the file django_ip_whitelist-0.1.4-py3-none-any.whl.

File metadata

  • Download URL: django_ip_whitelist-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 8.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/5.1.0 pkginfo/1.7.0 requests/2.28.1 requests-toolbelt/0.9.1 tqdm/4.64.1 CPython/3.9.2

File hashes

Hashes for django_ip_whitelist-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 2fb07631a58b53db9f2b6daedfa27f0cca42ad45d2c72d52bb68a325983ceb72
MD5 4f6586fe5acbbd95511557a210a75896
BLAKE2b-256 cbd5449142b9548a674ef31503fbe3f0d25cbffd1ef09915f721aedcf06c13ca

See more details on using hashes here.

Supported by

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