Metadata-Version: 2.4
Name: django-aai-eduhr
Version: 1.0.0
Summary: A Django application for integrating with the AAI@EduHr Single Sign-On (SSO) Service.
Author-email: Dino Aljević <dino.aljevic@uniri.hr>
License-Expression: MIT
Project-URL: Homepage, https://github.com/fidit-rijeka/django-aai-eduhr
Project-URL: Issues, https://github.com/fidit-rijeka/django-aai-eduhr/issues
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5.0
Classifier: Framework :: Django :: 5.1
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: django<5.0,>=4.2
Requires-Dist: djangosaml2<2.0.0,>=1.9.3
Requires-Dist: pysaml2<7.6.0,>=7.5.0
Requires-Dist: python-dateutil<2.10.0,>=2.9.0

# Django AAI@EduHr

`django-aai-eduhr` is a Django application designed to simplify the integration of your projects with AAI@EduHr, a 
SAML-based Single Sign-On (SSO) service.  It provides a ready-to-use authentication and authorization backend, with 
flexibility for customization and extensions. Additionally, the application includes a management command to quickly 
configure SAML settings, allowing you to focus on development without getting bogged down by configuration tasks.

*This project is not officially affiliated with University Computing Center of University of Zagreb or AAI@EduHr 
project.*

## Overview

Django AAI@EduHr version 1.0.0.

`django-aai-eduhr` is built on top of [djangosaml2](https://djangosaml2.readthedocs.io/) and 
[pysaml2](https://pysaml2.readthedocs.io/en/latest/) and shares much of its configuration with these libraries.

- Supported Python versions: 3.12+
- Supported Django versions: 4.2
- Supported pysaml2 versions: 7.5.x
- Supported djangosaml2 versions: 1.9.x
- Reference LDAP scheme: [hrEdu 1.3.1](https://wiki.srce.hr/download/attachments/65405172/AAI@EduHr-hrEduSheme-2010-v1.3.1.pdf?version=1&modificationDate=1727940424000&api=v2)

The application provides authentication backend with support for authorisation based on configurable
AAI@EduHr attributes. It also supports mapping of AAI data to your custom model fields, including 
related (child) models, and it can normalise multi-valued attributes by creating child model instances for each value.

In addition, the `manage.py aai_quickstart` simplifies the setup of basic SAML configuration, allowing you to 
dive into development right away.
