README.md · huge-dream/dvadmin-third

# dvadmin_third

#### 介绍
dvadmin-third 插件是dvadmin的一个第三方用户管理插件，支持微信、企业微信、钉钉、飞书、H5页面扫码登录，支持扩展微信、企业微信、钉钉、飞书等用户信息类，以及SSO单点登录等功能(部分功能开发中)。

## 功能支持项

- [ ] 扫码登录
  - [x] H5扫码登录
  - [x] 微信扫码登录
  - [x] 微信公众号扫码登录
  - [x] 钉钉扫码登录
  - [x] 飞书扫码登录
  - [ ] 企业微信扫码登录
  - [ ] 邮箱登录
  - [ ] 短信登录
  - [ ] QQ登录
- [ ] 支持用户扩展信息类(开发中)
  - [x] 微信用户信息
  - [x] 钉钉信息
  - [x] 飞书信息
  - [ ] QQ信息
  - [ ] 企业微信信息
- [ ] SSO单点登录(开发中)

## 使用说明

安装前端 dvadmin-third-web 插件进行配合使用
```shell
npm install dvadmin-third-web
```

使用pip安装软件包：

```shell
pip install dvadmin-third
```

### 方式二: 手动配置(推荐)
在INSTALLED_APPS 中注册app（注意先后顺序）
```python
INSTALLED_APPS = [
    ...
    'dvadmin_third'
]
```

在 application / urls.py 中注册url地址

```python
urlpatterns = [
    ...
    path(r'api/dvadmin_third/', include('dvadmin_third.urls')),
]
```

如果没有系统redis，请启动redis并添加配置 (./conf/env.example.py 及 ./conf/env.py中添加如下配置)

```python
# redis 配置
REDIS_PASSWORD = '' # 如果没密码就为空
REDIS_HOST = '127.0.0.1'
REDIS_URL = f'redis://:{REDIS_PASSWORD or ""}@{REDIS_HOST}:6379'

```

在 application / settings.py 下添加配置

```python
...
CACHES = { # 配置缓存
    "default": {
        "BACKEND": "django_redis.cache.RedisCache",
        "LOCATION": f'{REDIS_URL}/1', # 库名可自选1~16
        "OPTIONS": {
            "CLIENT_CLASS": "django_redis.client.DefaultClient",
        }
    },
}
```

### 安装依赖包
```shell
pip3 install -r requirements.txt
```

### 进行迁移及初始化

```shell
python3 manage.py makemigrations 
python3 manage.py migrate 
# 注意备份初始化信息
python3 manage.py init -y 
```

### 配置参数
1. 微信公众号扫码登录配置
登录微信测试公众号平台 https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login
![](./images/wechat_backend.png)
创建并自己关注一个测试公众号，拿到id等信息，在后面的dvadmin中配置
![](./images/wechat_getid.png)
配置好回调ip即可
![](./images/wechat_configureaddress.png)

2. 飞书扫码登录配置
登录飞书开放平台 https://open.feishu.cn/
![](./images/feishu_backend.png)
在飞书开放平台的控制台界面创建一个应用
![](./images/feishu_create.png)
拿到id等信息，在后面的dvadmin中配置
![](./images/feishu_getid.png)
配置好回调地址，要详细到整个路径(不包括?参数)
![](./images/feishu_configureaddress.png)

3. 钉钉扫码登录配置
登录钉钉开放平台 https://open.dingtalk.com/
![](./images/dingtalk_backend.png)
在控制台中创建一个应用
![](./images/dingtalk_create.png)
拿到id等信息，在后面的dvadmin中配置
![](./images/dingtalk_getid.png)
配置好回调ip即可
![](./images/dingtalk_configureaddress.png)

4. 拿到所有的信息配置
登录dvadmin的superadmin用户，在以下位置添加配置
![](./images/option_menu.png)
![](./images/options.png)

### 扫码登录时序图（auth2协议通用）
![](./wx_official_sequence_chart.jpg)

### 配置本地域名解析
修改域名解析比如windows系统可以修改 C:\Windows\System32\drivers\etc\hosts 文件，使用记事本打开 
添加的代码格式是 （127.0.0.1 aaa.bbb.com）不能加端口,意思是把 aaa.bbb.com 域名解析到本地的 127.0.0.1 上

huge-dream/dvadmin-third

简介

发行版

贡献者

语言

近期动态

huge-dream/dvadmin-third .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

语言

近期动态

搜索帮助

huge-dream/dvadmin-third