**Django Session Security 指南**

Django Session Security 指南

django-session-securityA little javascript and middleware work together to ensure that the user was active during the past X minutes in any tab he has open. Otherwise, display a warning leaving a couple of minutes to show any kind of activity like moving the mouse. Otherwise, logout the user.项目地址:https://gitcode.com/gh_mirrors/dj/django-session-security

1. 目录结构及介绍

Django Session Security 是一个增强Django应用安全性的小工具，它通过JavaScript和中间件协同工作，确保用户在过去X分钟内任何打开的标签页中保持活动。项目结构大致如下：

• session_security: 这个目录包含了核心功能代码，包括视图、模板、JS脚本和CSS样式。
  • session_security/dialog.html: 用户会被显示的警告对话框模板。
  • session_security/all.html: 可能涉及全局使用的HTML片段。
  • session_security/script.js: 提供前端逻辑以监控用户活动的JavaScript文件。
  • session_security/style.css: 相关的样式表。
• test_project: 示例项目或测试环境，用于快速验证安装和配置。
• docs: 文档资料，详细介绍了如何设置和使用此插件。
• gitignore: 版本控制忽略文件列表。
• 根目录下还包括了常见的如setup.py（用于包发布）、.travis.yml（持续集成配置）等文件，以及一些管理和配置相关的文件。

2. 项目的启动文件介绍

在使用Django Session Security时，并没有特定的“启动文件”，其依赖于Django项目的标准结构和配置。但关键步骤在于整合到你的Django项目中，这通常涉及到修改以下几个部分：

• 在settings.py中，你需要配置几个关键设置来启用和调整Django Session Security的行为，比如SESSION_SECURITY_WARN_AFTER和SESSION_SECURITY_EXPIRE_AFTER定义用户被警告和自动注销前的时间。
• 需要在MIDDLEWARE设置中加入 'django.contrib.sessions.middleware.SessionMiddleware' 确保Session功能可用。Django Session Security是基于此进行工作的。

若要快速体验项目，开发者应关注示例项目(test_project)的manage.py作为项目的运行入口，通过执行命令如python manage.py runserver来启动开发服务器。

3. 项目的配置文件介绍

主要的配置发生在Django项目的settings.py文件中，Django Session Security提供了以下可自定义的设置项：

• WARN_AFTER: 警告用户其会话即将过期之前的时间（秒），默认为540秒。
• EXPIRE_AFTER: 自动注销用户之前的时间（秒），默认为600秒。
• PASSIVE_URLS: 一个URL列表，指定哪些请求不应算作用户活动，以免错误地重置用户最后的活跃时间。
• PASSIVE_URL_NAMES: 类似于PASSIVE_URLS，但是使用Django的URL名字而不是路径。
• SESSION_SECURITY_INSECURE: 若要允许项目在未设置安全标志的情况下运行，可以设置为True。

因此，要在Django应用中配置Django Session Security，你需要在settings.py中调整上述设置变量，根据你的安全需求来定制用户的会话行为。此外，确保已将SessionMiddleware添加至MIDDLEWARE链中，并且了解如何处理被动URL以避免误触发用户活动更新。

django-session-securityA little javascript and middleware work together to ensure that the user was active during the past X minutes in any tab he has open. Otherwise, display a warning leaving a couple of minutes to show any kind of activity like moving the mouse. Otherwise, logout the user.项目地址:https://gitcode.com/gh_mirrors/dj/django-session-security