Django集成CAS单点登录的方法示例

下面我将详细讲解“Django集成CAS单点登录的方法示例”的完整攻略：

1. 什么是CAS单点登录？

CAS（Central Authentication Service） 是一种单点登录协议，它可以让用户在一次登录之后访问多个应用而不需要重复认证。CAS通过把用户的身份在 CAS Server 上进行认证并生成 Service Ticket，然后将它发送给应用进行登录，从而实现 SSO。

2. Django集成CAS单点登录

2.1 安装django-cas-ng

首先，我们需要安装 django-cas-ng。可以通过 pip 安装：

pip install django-cas-ng

2.2 配置settings.py

在settings.py中添加如下配置项：

AUTHENTICATION_BACKENDS = [
    'django.contrib.auth.backends.ModelBackend',
    'cas.backends.CASBackend',
]

CAS_SERVER_URL = 'https://cas.example.com'
CAS_LOGOUT_COMPLETELY = True

# 可选配置，配置允许访问的用户列表
CAS_ALLOWED_USERS = ['testuser', 'testuser2']

2.3 配置urls.py

在urls.py中添加如下配置项：

from django.urls import path, include

urlpatterns = [
    path('accounts/', include('cas.urls')),
    # ... 其他路由
]

2.4 实现login_required装饰器

除了上面的配置，我们还需要实现 login_required 装饰器。因为 django-cas-ng 的 login_required 要求用户已经登录。

from django.contrib.auth.decorators import login_required
from django.urls import reverse_lazy
from django_cas_ng.backends import CASBackend
from django_cas_ng.utils import get_cas_client

cas_client = get_cas_client()

def cas_login(request):
    """CAS登录"""
    callback_url = reverse_lazy('cas_callback')
    return cas_client.login(callback_url)

def cas_logout(request):
    """CAS登出"""
    cas_client = CASBackend()
    cas_client.logout(request)
    return redirect('login')

@login_required(login_url='cas_login')
def index(request):
    """登录后首页"""
    return HttpResponse('You are logged in.')

def cas_callback(request):
    """CAS登录回调函数"""
    user = CASBackend().authenticate(request, ticket=request.GET.get('ticket'), service=request.build_absolute_uri())

    if user and user.is_active:
        login(request, user)
        return redirect('index')
    else:
        return HttpResponse('认证失败！')

2.5 演示测试

添加了以上配置后，我们就可以简单验证登录/登出是否正常工作了。运行django服务后，访问CAS服务，可以看到通常的CAS登录界面。输入合法的用户名密码后，用户被重定向回网站根目录，可以看到 You are logged in. 的提示信息。然后，我们点击应用的“登出”按钮，此时用户被重定向回 CAS 登出页面。如果 CAS 的 logout_complete 配置为 True，用户还将被自动登出应用程序。

3. 可能遇到的问题

3.1 CAS服务端SSL证书验证失败

django-cas-ng 默认将 SSL 证书验证开启，因此在使用 https 的 CAS 服务时可能会遇到 SSL 证书验证失败的问题。为了解决这个问题，可以通过设置 CAS_SERVER_SSL_VERIFY 在发起 CAS 访问时禁用 SSL 证书校验，如下：

CAS_SERVER_SSL_VERIFY = False

3.2 登录重定向问题

使用 django-cas-ng 进行单点登录时，如果在登录后跳转到指定的页面时，需要在服务端设置一些参数，以便能够成功传递服务端的验证。参照上面的例子，cas_client.login(callback_url) 中的 callback_url 值就是重定向后的页面。

在读取完本文之后，你应该能够完成 Django 的 CAS 单点登录。通过以上方法，在 CAS 服务中进行用户验证，可以减少用户密码泄露的风险。同时，让用户无需为每个服务进行单独的认证，也增加了用户的便利性。