authentikate

DEVELOPMENT

This project is currently under development, and tightly integrates with the arkitekt project. While we are working on a more generic solution, the project API SHOULD be considered unstable. Please use at your own risk, and consider other solutions.

Idea

Authentikate is a library that provides a simple interface to validate tokens and retrieve corresponding user information inside a django application.

Usage

In order to initialize a herre client you need to specify a specific grant to retrieve the access_token. A grant constitutes a way of retrieving a Token in an asynchronous manner.

Installation

pip install authentikate

Configuration

INSTALLED_APPS = [
    "django.contrib.admin",
    "django.contrib.auth",
    "django.contrib.contenttypes",
    "django.contrib.sessions",
    "django.contrib.messages",
    "django.contrib.staticfiles",
    "guardian",
    "authentikate",
]


AUTH_USER_MODEL = "authentikate.User"

AUTHENTIKATE = {
    "KEY_TYPE": "RS256",
    "PUBLIC_KEY_PEM_FILE": "public_key.pem",
    "FORCE_CLIENT": False,

}

Authentication is done by using the authenticate_token method. This method takes a token and returns a user object if the token is valid. Otherwise it returns None.

```python
from authentikate import authenticate_token, authenticate_headers

def my_view(request):
    auth = authenticate_headers(request.HEADERS)
    if user is not None:
        # do something with user
    else:
        # do something else