Django集成CAS与OAuth2认证系统实战指南

小岛来信

发布时间：2026-10-13| 4人浏览过

原创

本文详细介绍如何在Django项目中结合CAS协议与OAuth2构建统一的认证系统。通过配置django-mama-cas作为服务端，django-cas-ng作为客户端，实现用户统一认证与单点登录。文章涵盖核心代码配置、服务注册、Ticket验证流程及OAuth2状态参数处理，并解决同Host Cookie冲突等常见部署问题，为多系统间的安全访问提供完整解决方案。

CAS认证方案概述

CAS

Solution

采用CAS作为核心认证协议，确保系统间身份验证的一致性。
将系统A设定为主要认证提供方（Provider），负责统一的用户身份管理。
系统A保留完整的用户数据库，而其余业务系统如xxx/www等不独立维护用户信息，所有认证逻辑均依托于A的实现。
实现步骤
- 当用户在xxx系统选择登录时，页面跳转至LMS的CAS认证界面。CAS服务端读取数据库完成身份校验后，将用户重定向回xxx系统界面，并在URL中附加ticket参数，同时在浏览器端写入相关Cookie以维持会话状态。
- xxx系统在接收到URL中的ticket后，需向CAS服务端发送请求以验证该ticket的有效性。
- 验证通过后，xxx系统允许用户访问其内部受保护资源。

Django服务端与客户端配置

django代码

初始化一个client项目


django-admin startproject cas-client

Install Dependencies


pip install django-mama-cas # server
pip install django-cas-ng # client

Server


# settings.py
INSTALLED_APPS = (
  'mama_cas',
)

# 允许退出登录，可选项
MAMA_CAS_ENABLE_SINGLE_SIGN_OUT = True

# 重要！，service是client的IP，是个数组，可以在后面添加SERVICE的HOST:PORT。
MAMA_CAS_SERVICES = [
  {
    'SERVICE': 'http://127.0.1.1:8000',
    'CALLBACKS': [
      'mama_cas.callbacks.user_model_attributes',   # 返回除了password的所有Field
      # 'mama_cas.callbacks.user_name_attributes',  # 只返回 username
    ],
    'LOGOUT_ALLOW': True,
    'LOGOUT_URL': 'http://127.0.1.1:8000/accounts/callback',
  },
]

# urls.py
url(r'', include('mama_cas.urls')),

不要忘记：


python3 manage.py migrate

Client


# settings.py
INSTALLED_APPS = (
  # ... other installed apps
  'django_cas_ng',
)

AUTHENTICATION_BACKENDS = (
  'django.contrib.auth.backends.ModelBackend',
  'django_cas_ng.backends.CASBackend',
)

# 也就是LMS的地址
CAS_SERVER_URL = 'http://127.0.0.1:8000'
CAS_VERSION = '3'

# 存入所有CAS 服务端返回的user数据。
CAS_APPLY_ATTRIBUTES_TO_USER = True

# urls.py
import django_cas_ng.views as cas_views
url(r'^accounts/login$', cas_views.login, name='cas_ng_login'),
url(r'^accounts/logout$', cas_views.logout, name='cas_ng_logout'),
url(r'^accounts/callback$', cas_views.views.callback, name='cas_ng_proxy_callback'),

Also: