如何重写Django Rest Framework可浏览API的默认登录页面

核心问题原因 #

DRF可浏览API默认绑定Django自带的登录视图，即便你设置了LOGIN_URL，仍需通过路由覆盖或DRF配置调整，让登录按钮直接关联到你的Okta登录页。

解决方案步骤 #

1. 修正全局登录配置 #

在项目settings.py中完善登录相关配置，同时适配DRF的认证权限规则：

# 指定自定义登录页地址
LOGIN_URL = '/signin/'
# 登录成功后默认跳转回API页面（按需调整）
LOGIN_REDIRECT_URL = '/api/'

REST_FRAMEWORK = {
    # 配置你的Okta认证类（替换为项目实际使用的Okta认证实现）
    'DEFAULT_AUTHENTICATION_CLASSES': [
        'your_app.authentication.OktaJWTAuthentication',
    ],
    # 确保未登录用户能查看API页面并触发登录按钮
    'DEFAULT_PERMISSION_CLASSES': [
        'rest_framework.permissions.IsAuthenticatedOrReadOnly',
    ],
}

2. 覆盖DRF默认登录路由 #

在项目根urls.py中，替换DRF自带的api-auth/login/路由，直接重定向到你的Okta登录页：

from django.urls import path, include
from django.shortcuts import redirect

urlpatterns = [
    # 项目其他业务路由...
    # 替换DRF默认登录路由，直接跳转到自定义登录页
    path('api-auth/login/', lambda request: redirect('/signin/')),
    # 保留DRF的其他api-auth路由（用于登出等功能）
    path('api-auth/', include('rest_framework.urls', namespace='rest_framework')),
]

3. 确认Okta登录页视图有效性 #

保证/signin/对应的视图已正确配置Okta OAuth2认证逻辑，示例如下（以第三方库结合Okta为例）：

# views.py
from oauth2_provider.views import AuthorizationView

class OktaLoginView(AuthorizationView):
    client_id = '你的Okta客户端ID'
    redirect_uri = 'http://my-app/auth/callback/'
    # 补充Okta认证所需的其他配置参数

并在urls.py中完成路由映射：

path('signin/', OktaLoginView.as_view(), name='okta_signin'),

验证方法 #

启动服务后访问DRF可浏览API页面，点击右上角「登录」按钮，应直接跳转至http://my-app/signin/完成Okta认证，认证成功后自动返回API页面。

内容的提问来源于stack exchange，提问作者najeeb