基于Python 3.8 + Django 3.2的密码自助平台,AD用户自助修改密码,结合<钉钉>/<企业微信>应用免密码授权后可自行重置密码、解锁自己的账号。
Go to file
向乐🌌 bc04829070 ### 本次升级、修复,请使用最新版:
+ 升级Python版本为3.8
+ 升级Django到3.2
+ 修复用户名中使用\被转义的问题
+ 重写了dingding模块,因为dingding开发者平台接口鉴权的一些变动,之前的一些接口不能再使用,本次重写。
+ 重写了ad模块,修改账号的一些判断逻辑。
+ 重写了用户账号的格式兼容,现在用户账号可以兼容:username、DOMAIN\username、username@abc.com这三种格式。
+ 优化了整体的代码逻辑,去掉一些冗余重复的代码。
2021-04-23 15:37:54 +08:00
log ### 本次升级、修复,请使用最新版: 2021-04-23 15:37:54 +08:00
pwdselfservice ### 本次升级、修复,请使用最新版: 2021-04-23 15:37:54 +08:00
resetpwd ### 本次升级、修复,请使用最新版: 2021-04-23 15:37:54 +08:00
screenshot ### 本次升级、修复,请使用最新版: 2021-04-23 15:37:54 +08:00
static ### 本次升级、修复,请使用最新版: 2021-04-23 15:37:54 +08:00
templates ### 本次升级、修复,请使用最新版: 2021-04-23 15:37:54 +08:00
utils ### 本次升级、修复,请使用最新版: 2021-04-23 15:37:54 +08:00
.gitignore 添加自动安装脚本,方便快速部署上线。 2020-04-01 17:28:51 +08:00
LICENSE update license 2020-08-18 11:39:50 +08:00
auto-install.sh ### 本次升级、修复,请使用最新版: 2021-04-23 15:37:54 +08:00
manage.py ### 本次升级、修复,请使用最新版: 2021-04-23 15:37:54 +08:00
readme.md ### 本次升级、修复,请使用最新版: 2021-04-23 15:37:54 +08:00
requestment ### 本次升级、修复,请使用最新版: 2021-04-23 15:37:54 +08:00
uwsgi.ini 默认的 2021-04-19 08:41:22 +08:00
uwsgiserver 添加自动安装脚本,方便快速部署上线。 2020-04-01 17:28:51 +08:00

readme.md

初学Django时碰到的一个需求因为公司中很多员工在修改密码之后有一些关联的客户端或网页中的旧密码没有更新导致密码在尝试多次之后账号被锁为了减少这种让人头疼的重置解锁密码的操蛋工作自己做了一个自助修改小平台。

水平有限,代码写得不好,但是能用,有需要的可以直接拿去用。

场景说明:

因为本公司AD是早期已经在用用户的个人信息不是十分全面例如:用户手机号。
钉钉是后来才开始使用,钉钉默认是使用手机号登录。 用户自行重置密码时如果通过手机号来进行钉钉与AD之间的验证就行不通了。

新版本逻辑:

用户扫码通过之后通过临时授权码提取用户的unionid再通过unionid判断用户在本企业中是否存在。如果存在提取用户钉钉账号的邮箱通过邮箱转成账号将账号拿到AD中进行比对来验证账号在AD中是否存在并账号状态是激活的。满足以上条件的账号就会视为可自行重置密码。

提示:

AD必须使用SSL才能修改密码这里被坑了N久...
自行部署下AD的证书服务并颁发CA证书重启服务器生效。
具体教程百度一下,有很多。

本次升级、修复,请使用最新版:

  • 升级Python版本为3.8
  • 升级Django到3.2
  • 修复用户名中使用\被转义的问题
  • 重写了dingding模块因为dingding开发者平台接口鉴权的一些变动之前的一些接口不能再使用本次重写。
  • 重写了ad模块修改账号的一些判断逻辑。
  • 重写了用户账号的格式兼容现在用户账号可以兼容username、DOMAIN\username、username@abc.com这三种格式。
  • 优化了整体的代码逻辑,去掉一些冗余重复的代码。

线上环境需要的基础环境:

  • Python 3.8.9 (可自行下载源码包放到项目目录下,使用一键安装)
  • Nginx
  • Uwsgi

截图

截图1 截图2

钉钉必要条件:

创建企业内部应用

  • 在钉钉工作台中通过“自建应用”创建应用选择“企业内部开发”创建H5微应用或小程序在应用首页中获取应用的AgentId、AppKey、AppSecret。
  • 应用需要权限:身份验证、消息通知、通讯录只读权限、手机号码信息、邮箱等个人信息、智能人事,范围是全部员工或自行选择
  • 应用安全域名和IP一定要配置否则无法返回接口数据。

参考截图配置: 截图3 截图4 截图5

移动接入应用--登录权限:

登录中开启扫码登录,配置回调域名:“https://pwd.abc.com/callbackCheck” 其中pwd.abc.com请按自己实际域名来并记录相关的appId、appSecret。

参考截图配置: 截图6

使用脚本自动快速部署只适合Centos其它发行版本的Linux请自行修改相关命令。

我添加了一个快速自动部署脚本,可快速自动部署完成当前项目上线。

把整个项目目录上传到新的服务器上

chmod +x auto-install.sh
./auto-install.sh

等待所有安装完成

脚本安装完成之后,按自己实际的配置修改项目配置文件:

修改pwdselfservice/local_settings.py中的参数按自己的实际参数修改

# AD配置
# AD主机可以是IP或主机域名例如可以是:abc.com或172.16.122.1
AD_HOST = '修改为自己的'

# 用于登录AD做用户信息验证的账号 需要有修改用户账号密码的权限。
# 账号格式使用DOMAIN\USERNAME例如abc\pwdadmin
AD_LOGIN_USER = '修改为自己的'

# 密码
AD_LOGIN_USER_PWD = '修改为自己的'

# BASE DN账号的查找DN路径例如'DC=abc,DC=com'可以指定到OU之下例如'OU=RD,DC=abc,DC=com'。
BASE_DN = '修改为自己的'

# 钉钉配置
# 钉钉接口地址,不可修改
DING_URL = "https://oapi.dingtalk.com/sns"

# 钉钉企业ID
DING_CORP_ID = '修改为自己的'

# 钉钉E应用
DING_AGENT_ID = '修改为自己的'
DING_APP_KEY = '修改为自己的'
DING_APP_SECRET = '修改为自己的'

# 钉钉移动应用接入
DING_SELF_APP_ID = '修改为自己的'
DING_SELF_APP_SECRET = '修改为自己的'

# Crypty key 通过generate_key生成可不用修改
CRYPTO_KEY = b'dp8U9y7NAhCD3MoNwPzPBhBtTZ1uI_WWSdpNs6wUDgs='

# COOKIE 超时单位是秒,可不用修改
TMPID_COOKIE_AGE = 300

# 主页域名index.html中的钉钉跳转等需要指定域名如果是脚本自动部署以下域名会自动替换。
HOME_URL = 'PWD_SELF_SERVICE_DOMAIN'

以上配置修改完成之后,则可以通过配置的域名直接访问。

手动部署

按自己实际的配置修改项目配置参数:

修改pwdselfservice/local_settings.py中的参数按自己的实际参数修改

# ########## AD配置修改为自己的
# AD主机可以是IP或主机域名例如可以是: abc.com或172.16.122.1
AD_HOST = r'修改成自己的'

# AD域控的DOMAIN名例如abc、abc.com
AD_DOMAIN = r'修改成自己的'

# 用于登录AD做用户信息处理的账号需要有修改用户账号密码或信息的权限。
# AD账号例如pwdadmin
AD_LOGIN_USER = r'修改成自己的'
# 密码
AD_LOGIN_USER_PWD = r'修改为自己的'

# BASE DN账号的查找DN路径例如'DC=abc,DC=com'可以指定到OU之下例如'OU=RD,DC=abc,DC=com'。
BASE_DN = r'修改成自己的'

# 是否启用SSL,
# 注意AD必须使用SSL才能修改密码这里被坑了N久...,自行部署下AD的证书服务并颁发CA证书重启服务器生效。具体教程百度一下有很多。
AD_USE_SSL = True
# 连接的端口如果启用SSL默认是636否则就是389
AD_CONN_PORT = 636


# ########## 钉钉
# 钉钉配置
# 钉钉接口主地址,不可修改
DING_URL = r'https://oapi.dingtalk.com'

# 钉钉企业ID <CorpId>,修改为自己的
DING_CORP_ID = '修改为自己的'

# 钉钉企业内部开发内部H5微应用或小程序用于读取企业内部用户信息
DING_AGENT_ID = r'修改为自己的'
DING_APP_KEY = r'修改为自己的'
DING_APP_SECRET = r'修改为自己的'

# 移动应用接入 主要为了实现通过扫码拿到用户的unioid
DING_MO_APP_ID = r'修改为自己的'
DING_MO_APP_SECRET = r'修改为自己的'

# 执行python3 ./resetpwd/utils/crypto.py 生成
# 可自行生成后替换
CRYPTO_KEY = b'dp8U9y7NAhCD3MoNwPzPBhBtTZ1uI_WWSdpNs6wUDgs='

# COOKIE 超时单位是秒,可不用修改
TMPID_COOKIE_AGE = 300

# 主页域名钉钉跳转等需要指定域名格式pwd.abc.com。
HOME_URL = 'PWD_SELF_SERVICE_DOMAIN'

手动部署

自行安装完python3之后使用python3目录下的pip3进行安装依赖

我自行安装的Python路径为/usr/local/python3

项目目录下的requestment文件里记录了所依赖的相关python模块安装方法

  • /usr/local/python3/bin/pip3 install -r requestment 等待所有模块安装完成之后进行下一步。

安装完依赖后,直接执行 /usr/local/python3/bin/python3 manager.py runserver x.x.x.x:8000 即可临时访问项目线上不适用这种方法线上环境请使用uwsgi。

修改uwsig.ini配置:

IP和路径按自己实际路径修改

[uwsgi]
http-socket = PWD_SELF_SERVICE_IP:PWD_SELF_SERVICE_PORT

chdir = PWD_SELF_SERVICE_HOME
 
module = pwdselfservice.wsgi:application

master = true
 
processes = 4
 
threads = 4
 
max-requests = 2000
 
chmod-socket = 755
 
vacuum = true

#设置缓冲
post-buffering = 4096

#设置静态文件
static-map = /static=PWD_SELF_SERVICE_HOME/static

#设置日志目录
daemonize = PWD_SELF_SERVICE_HOME/log/uwsgi.log

通过uwsgiserver启动

其中PWD_SELF_SERVICE_HOME是你自己的服务器当前项目的目录请自行修改 将以下脚本修改完之后,复制到/etc/init.d/,给予执行权限。 uwsgiserver:

#!/bin/sh

INI="PWD_SELF_SERVICE_HOME/uwsgi.ini"
UWSGI="/usr/share/python-3.6.9/bin/uwsgi"
PSID=`ps aux | grep "uwsgi"| grep -v "grep" | wc -l`

if [ ! -n "$1" ]
then
    content="Usages: sh uwsgiserver [start|stop|restart]"
    echo -e "\033[31m $content \033[0m"
    exit 0
fi

if [ $1 = start ]
then
    if [ `eval $PSID` -gt 4 ]
    then
        content="uwsgi is running!"
        echo -e "\033[32m $content \033[0m"
        exit 0
    else
        $UWSGI $INI
        content="Start uwsgi service [OK]"
        echo -e "\033[32m $content \033[0m"
    fi

elif [ $1 = stop ];then
    if [ `eval $PSID` -gt 4 ];then
        killall -9 uwsgi
    fi
    content="Stop uwsgi service [OK]"
    echo -e "\033[32m $content \033[0m"
elif [ $1 = restart ];then
    if [ `eval $PSID` -gt 4 ];then
        killall -9 uwsgi
    fi
    $UWSGI --ini $INI
    content="Restart uwsgi service [OK]"
    echo -e "\033[32m $content \033[0m"

else
    content="Usages: sh uwsgiserver [start|stop|restart]"
    echo -e "\033[31m $content \033[0m"
fi

脚本内的路径按自己实际情况修改

自行部署Nginx然后添加Nginx配置

Nginx配置

Nginx Server配置

  • proxy_pass的IP地址改成自己的服务器IP
  • 配置可自己写一个vhost或直接加在nginx.conf中
server {
    listen  80;
    server_name pwd.abc.com;

    location / {
        proxy_pass         http://192.168.x.x:8000;
        proxy_set_header   Host              $host;
        proxy_set_header   X-Real-IP         $remote_addr;
        proxy_set_header   X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;
    }
	access_log  off;
}
  • 执行Nginx reload操作重新加载配置