Django-Guardian 与 Django Admin 的权限管理集成指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00386/article/details/148552887

Django-Guardian 与 Django Admin 的权限管理集成指南

django-guardian 项目地址: https://gitcode.com/gh_mirrors/dja/django-guardian

前言

Django 自带的 Admin 后台是一个功能强大且广泛使用的内容管理系统，但默认情况下它只支持模型级别的权限控制。在实际开发中，我们经常需要更细粒度的对象级别权限管理。这正是 django-guardian 项目的用武之地，它为 Django Admin 提供了无缝的对象权限管理集成方案。

核心概念

1. Django 默认权限系统

Django 默认提供三种权限级别：

模型级别权限（Model-level permissions）
对象级别权限（Object-level permissions）
用户/组权限（User/Group permissions）

2. django-guardian 的增强

django-guardian 主要增强了对象级别的权限控制，允许管理员为单个模型实例设置权限。

集成步骤详解

1. 基础模型定义

首先定义一个需要对象权限控制的模型，这里以博客文章（Post）为例：

from django.db import models

class Post(models.Model):
    title = models.CharField('标题', max_length=64)
    slug = models.SlugField(max_length=64)
    content = models.TextField('内容')
    created_at = models.DateTimeField(auto_now_add=True, db_index=True)

    class Meta:
        permissions = (
            ('hide_post', '可以隐藏文章'),  # 自定义权限
        )
        get_latest_by = 'created_at'

    def __str__(self):
        return self.title

2. 传统 Admin 注册方式

如果不使用对象权限，常规的 Admin 注册方式如下：

from django.contrib import admin
from posts.models import Post

class PostAdmin(admin.ModelAdmin):
    prepopulated_fields = {"slug": ("title",)}
    list_display = ('title', 'slug', 'created_at')
    search_fields = ('title', 'content')
    ordering = ('-created_at',)
    date_hierarchy = 'created_at'

admin.site.register(Post, PostAdmin)

3. 集成 django-guardian

要实现对象权限管理，只需将 ModelAdmin 替换为 GuardedModelAdmin：

from django.contrib import admin
from posts.models import Post
from guardian.admin import GuardedModelAdmin

class PostAdmin(GuardedModelAdmin):
    prepopulated_fields = {"slug": ("title",)}
    list_display = ('title', 'slug', 'created_at')
    search_fields = ('title', 'content')
    ordering = ('-created_at',)
    date_hierarchy = 'created_at'

admin.site.register(Post, PostAdmin)

功能特性

1. 对象权限管理界面

注册后，在 Admin 的模型变更页面会出现：

新增"Object permissions"按钮
位于"History"按钮旁边
点击后可管理该特定对象的权限

2. 支持的权限操作

为用户/组分配对象权限
批量权限管理
权限继承控制

最佳实践

1. 性能优化

对于大型数据集，建议：

重写 get_queryset 方法优化查询
使用 select_related 减少数据库查询

2. 自定义权限显示

可以重写 get_obj_perms_base_context 方法来自定义权限管理界面的显示内容。

3. 结合模板标签

在模板中可以使用 guardian 的模板标签检查对象权限：

{% load guardian_tags %}
{% if request.user|has_obj_perm:'change_post' %}
   <!-- 显示编辑按钮 -->
{% endif %}

常见问题解答

Q: 为什么看不到"Object permissions"按钮？ A: 请检查：

是否正确继承了 GuardedModelAdmin
用户是否有足够的权限
是否在模型 Meta 中定义了 permissions

Q: 如何限制某些用户只能看到自己创建的对象？ A: 可以重写 get_queryset 方法：

def get_queryset(self, request):
    qs = super().get_queryset(request)
    if not request.user.is_superuser:
        return qs.filter(created_by=request.user)
    return qs