drf-iam 0.2.11

IAM-style roles and permissions for Django Rest Framework

DRF-IAM (Django REST Framework - Identity and Access Management)

A powerful Django application that provides Role-Based Access Control (RBAC) for Django REST Framework applications. Easily manage permissions and roles across your API endpoints.

Features

• 🔒 Role-Based Access Control (RBAC)
• 🎯 Custom policy names for viewsets
• 🔄 Seamless integration with Django's User model
• ⚡ Easy to set up and configure
• 📚 Comprehensive documentation

Installation

pip install drf-iam

Quick Start

1. Add drf_iam to your INSTALLED_APPS in settings.py:

INSTALLED_APPS = [
    ...
    'drf_iam',
]

2. Add the Role relationship to your User model:

from django.contrib.auth.models import AbstractUser
from drf_iam.models import Role

class User(AbstractUser):
    role = models.ForeignKey(Role, on_delete=models.SET_NULL, null=True)

3. Run migrations:

python manage.py makemigrations
python manage.py migrate

4. Use in your viewsets:

from rest_framework import viewsets
from drf_iam.permissions import IAMPermission

class UserViewSet(viewsets.ModelViewSet):
    permission_classes = [IAMPermission]
    iam_policy_name = "users"  # Optional: Custom policy name for this viewset

Documentation

For detailed documentation, visit https://drf-iam.readthedocs.io/

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.