Skip to main content

Strong, Simple, (now async!) and Precise security for Sanic APIs

Project description

Latest Published Version Build Testing Status Supported Python versions Documentation Build Status Codecov Report https://static.pepy.tech/personalized-badge/sanic-beskar?period=total&units=international_system&left_color=grey&right_color=orange&left_text=Downloads Codacy Badge Interrogate Badge Security Status Code style: black

sanic-beskar

Strong, Simple, and Precise security for Sanic APIs

This project’s beginning was fully lifted from the awesome Flask-Praetorian.

Why beskar? Why not – what is better than star wars (provided you ignore the fact ~the mandolorian~ was almost as lame as ~book of boba fett~)? Superior armour should be used if you want superior protection.

This package aims to provide that. Using token implemented by either PySETO or PyJWT, sanic-beskar uses a very simple interface to make sure that the users accessing your API’s endpoints are provisioned with the correct roles for access.

The goal of this project is to offer simplistic protection, without forcing nonsense, excessivly complicatated implementation, or mandated/opinionated ORM usage. Providing this usability for small scaled Sanic applications, while allowing the flexibility and scalability for enterprise grade solutions, separates this from your other options.

The sanic-beskar package can be used to:

  • Hash passwords for storing in your database

  • Verify plaintext passwords against the hashed, stored versions

  • Generate authorization tokens upon verification of passwords

  • Check requests to secured endpoints for authorized tokens

  • Supply expiration of tokens and mechanisms for refreshing them

  • Ensure that the users associated with tokens have necessary roles for access

  • Parse user information from request headers for use in client route handlers

  • Support inclusion of custom user claims in tokens

  • Register new users using email verification

  • Support OTP authentication as a dual factor

  • Provide RBAC based protection of endpoints and resources

All of this is provided in a very simple to configure and initialize flask extension. Though simple, the security provided by sanic-beskar is strong due to the usage of the proven security technology of PASETO or JWT, along with python’s PassLib package.

Super-quick Start

  • requirements: python versions 3.7+

  • install through pip: $ pip install sanic-beskar

  • minimal usage example: example/basic.py

Documentation

The complete documentation can be found at the sanic-beskar home page

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

sanic_beskar-2.3.3.post1.tar.gz (31.6 kB view hashes)

Uploaded Source

Built Distribution

sanic_beskar-2.3.3.post1-py3-none-any.whl (34.8 kB view hashes)

Uploaded Python 3

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