Basic auth utilities for Django.

Tested under...

• Python
  • 2.7
  • 3.6
  • 3.7
• Django
  • 1.11
  • 2.1
  • 2.2

pip install django-basicauth

from basicauth.decorators import basic_auth_required

@basic_auth_required
def myview(request):
    ...

or by a middleware.

MIDDLEWARE = (
    'basicauth.middleware.BasicAuthMiddleware',
    ...
)

The name of MIDDLEWARE settings is MIDDLEWARE_CLASSES on Django 1.8.

To apply basic auth for specific requests, Use target_test argument.

In the below code, anonymous users will be required Basic Auth Authenticated users can pass it without Basic ... header.

from basicauth.decorators import basic_auth_required

@basic_auth_required(
    target_test=lambda request: not request.user.is_authenticated
)
def myview(request):
    ...

target_test accepts typing.Callable[[HttpRequest], bool], and if the callable returns True, Basic Auth will be required.

To apply @basic_auth_required decorator to Class Based Views, use django.utils.decorators.method_decorator.

from django.utils.decorators import method_decorator
from basicauth.decorators import basic_auth_required

@method_decorator(basic_auth_required, name='dispatch')
class YourView(TemplateView):
    template_name = "my-template.html"

• BASICAUTH_USERS (required): Dictionary including keys as username and values as passwords.
• BASICAUTH_REALM: realm string, default is "Secure resource".
• BASICAUTH_DISABLE: Disable all of barriers by this library.