{
"info": {
"author": "Md Nazrul Islam",
"author_email": "email2nazrul@gmail.com",
"bugtrack_url": null,
"classifiers": [
"Development Status :: 4 - Beta"
],
"description": "HACS(Hybrid Access Control System)\r\n==================================\r\n.. image:: https://badge.fury.io/py/django-hacs.svg\r\n :target: https://pypi.python.org/pypi/django-hacs/\r\n.. image:: https://travis-ci.org/nazrulworld/django-hybrid-access-control-system.svg?branch=master\r\n :target: https://travis-ci.org/nazrulworld/django-hybrid-access-control-system\r\n.. image:: https://coveralls.io/repos/github/nazrulworld/django-hybrid-access-control-system/badge.svg?branch=master\r\n :target: https://coveralls.io/github/nazrulworld/django-hybrid-access-control-system?branch=master\r\n\r\nThe full featured advanced ``Access Control System`` powered by `Django `_. `HACS` provides enterprise standard authorization system,\r\nit also covers IAM(Identity and Access Management).\r\n\r\nFeatures\r\n--------\r\n1. **Django MultiSite:** Support to run `multiple sites `_ with single config file(settings), this is dynamic process, so you can add unlimited sites.\r\n\r\n2. **Firewall/Access Control:** Complete firewall features for your application, almost similar fashion of `IP Table `_\r\n a. Custom URL schema: applicable applicable on site, user & group's rules.\r\n b. HTTP Methods filter: applicable on site, user & group's rules.\r\n c. Maintenance Mode: applicable on only site's rules.\r\n d. Regex patterned URL blacklist: applicable on site, user & group's rules.\r\n e. Regex patterned URL whitelist: applicable on site, user & group's rules.\r\n\r\n3. **Advanced Authorization: (coming)** Committed to be more than combination of `Django Guardian `_ and `Django Authority `_ but definitely base idea could be from those.\r\n\r\n4. **Audit Trial: (coming)** This is the part of IAM (Identity and Access Management)\r\n\r\nInstallation\r\n------------\r\n\r\nInstall ``django-hacs``, simply use `pip` or `easy_install` ::\r\n\r\n ~$ pip install django-hacs\r\n or\r\n ~$ easy_install django-hacs\r\n\r\nInstall most recent (dev) version of ``django-hacs`` ::\r\n\r\n ~$ git clone https://github.com/nazrulworld/django-hybrid-access-control-system.git django-hacs\r\n ~$ cd django-hacs\r\n ~$ python setup.py install\r\n\r\nConfiguration\r\n-------------\r\nAdd ``django-hacs`` at INSTALLED_APPS ::\r\n\r\n INSTALLED_APPS = (\r\n .................,\r\n 'django.contrib.contentypes',\r\n 'django.contrib.sites',\r\n 'hacs'\r\n )\r\n\r\nAdd middleware classes from ``django-hacs`` and also make sure `django.contrib.sites.middleware.CurrentSiteMiddleware`\r\nis added::\r\n\r\n MIDDLEWARE_CLASSES = [\r\n ............................\r\n 'django.contrib.sites.middleware.CurrentSiteMiddleware',\r\n 'hacs.middleware.DynamicRouteMiddleware',\r\n 'hacs.middleware.FirewallMiddleware',\r\n ]\r\n\r\nOptionally define the writable location, where generated urlconf modules will be stored, default location is ``path to hacs/generated`` ::\r\n\r\n HACS_GENERATED_URLCONF_DIR = \"your desired directory location\"\r\n\r\nInitialize ``django-hacs`` environment and this the starting point::\r\n\r\n ~$ python manage.py init_hacs\r\n >>> provide your information\r\n\r\nDependencies\r\n------------\r\n- Django 1.9.x or higher\r\n\r\n\r\nDocumentation\r\n-------------\r\n\r\nFull documentation for end users can be found in the \"docs\" folder, and is also available online at http://django-hacs.readthedocs.org/\r\n\r\n\r\nRouting Rules Management\r\n------------------------\r\nWe have two ways to do that.\r\n**Django Admin**\r\n1. Make sure ``admin`` app is installed and ``hacs.urls`` is added into ``urlconf``. i.e ``url(r'^hacs/', include(('hacs.urls', 'hacs'), namespace='hacs'))``\r\n2. Go to ``http://{host}/admin/hacs/``. From there you can manage (add, edit, delete). More details could be found at documentation.\r\n\r\n**Django Management Tool**\r\n1. Download sample routing file from `https://github.com/nazrulworld/django-hybrid-access-control-system/blob/master/sample/routes-minimal.json `_\r\n2. Fill with required information. You can just copy/paste and fill as much as you need, just make sure about valid json and all entries are under one list.\r\n3. Save the json file and keep in mind the location\r\n4. Go to terminal and `cd` to `manage.py`::\r\n\r\n ~$ python manage.py import_route -S \r\n\r\nDeploy ``django-hacs``\r\n----------------------\r\n\r\n1. You can either follow above instruction and create new routing schema.\r\n2. If you have already routing schema at local and that are ready for production.\r\n 1. Export from local ``~$ python manage.py export_route -d