Mara ACL documentation

Welcome to Mara ACL’s documentation. This is one of the core modules of the Mara Framework offering simple ACL user permission management.

It uses a simple design:

• Authentication of users is handled externally, e.g. through a OAuth2 Proxy. An upstream authentication app manages authentication and then adds a http header identifying the user to each authenticated request.

• Each user is assigned a single role.

• Permissions are not based on urls, but on application-defined “resources”. Thus, checking of permissions needs to be done in the application.

User’s Guide

This part of the documentation focuses on step-by-step instructions how to use this extension.

• Installation
  • Python Version
  • Dependencies
  • Install Mara ACL
• Authentication
  • OAuth2 proxy
  • Microsoft MSAL
• User and permission management
  • Automatic user creation
  • Managing permissions for users and roles
• Configuration
  • Mara Configuration Values

Additional Notes

Legal information and changelog are here for the interested.

• License
  • MIT Source License
• Changelog
  • 2.1.1 (2022-06-17)
  • 2.1.0 (2022-03-16)
  • 2.0.1 (2020-01-24)
  • 2.0.0 (2019-04-12)
  • 1.5.0 (2019-02-13)
  • 1.4.0 (2018-04-08)
  • 1.3.0 (2018-03-19)
  • 1.2.0 (2017-12-30)
  • 1.1.0 (2017-09-21)
  • 1.0.0 - 1.0.4 (2017-03-10)