django-allauth是集成的Django应用程序,用于解决网站身份验证,用户的注册登录及账户管理,以及第三方(社交)账户的身份验证。
既然你知道并准备使用django-allauth,所以本文假定你已经掌握了基本的django知识(比如会用django搭建Web App,甚至是一个小型博客网站)。
安装与基本配置
安装
1
|
pip install django - allauth |
基本配置
1.在你项目的settings.py里 加上 以下相对应的代码
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
|
TEMPLATES = [ { 'BACKEND' : 'django.template.backends.django.DjangoTemplates' , 'DIRS' : [], 'APP_DIRS' : True , 'OPTIONS' : { 'context_processors' : [ 'django.template.context_processors.request' , ], }, }, ] AUTHENTICATION_BACKENDS = ( 'django.contrib.auth.backends.ModelBackend' , 'allauth.account.auth_backends.AuthenticationBackend' , ) INSTALLED_APPS = ( # 这两个django本身的app也是需要的,但不需要重复添加 'django.contrib.auth' , 'django.contrib.sites' , 'allauth' , 'allauth.account' , 'allauth.socialaccount' , # 下面是django-allauth目前支持的社交账号,加上你需要的就行了,不用全加上: 'allauth.socialaccount.providers.amazon' , # 亚马逊 'allauth.socialaccount.providers.angellist' , 'allauth.socialaccount.providers.asana' , 'allauth.socialaccount.providers.auth0' , 'allauth.socialaccount.providers.authentiq' , 'allauth.socialaccount.providers.baidu' , # 百度 'allauth.socialaccount.providers.basecamp' , 'allauth.socialaccount.providers.bitbucket' , 'allauth.socialaccount.providers.bitbucket_oauth2' , 'allauth.socialaccount.providers.bitly' , 'allauth.socialaccount.providers.coinbase' , 'allauth.socialaccount.providers.dataporten' , 'allauth.socialaccount.providers.daum' , 'allauth.socialaccount.providers.digitalocean' , 'allauth.socialaccount.providers.discord' , 'allauth.socialaccount.providers.douban' , # 豆瓣 'allauth.socialaccount.providers.draugiem' , 'allauth.socialaccount.providers.dropbox' , 'allauth.socialaccount.providers.dwolla' , 'allauth.socialaccount.providers.edmodo' , 'allauth.socialaccount.providers.eveonline' , 'allauth.socialaccount.providers.evernote' , 'allauth.socialaccount.providers.facebook' , 'allauth.socialaccount.providers.feedly' , 'allauth.socialaccount.providers.fivehundredpx' , 'allauth.socialaccount.providers.flickr' , 'allauth.socialaccount.providers.foursquare' , 'allauth.socialaccount.providers.fxa' , 'allauth.socialaccount.providers.github' , # GitHub 'allauth.socialaccount.providers.gitlab' , 'allauth.socialaccount.providers.google' , 'allauth.socialaccount.providers.hubic' , 'allauth.socialaccount.providers.instagram' , 'allauth.socialaccount.providers.kakao' , 'allauth.socialaccount.providers.line' , 'allauth.socialaccount.providers.linkedin' , 'allauth.socialaccount.providers.linkedin_oauth2' , 'allauth.socialaccount.providers.mailru' , 'allauth.socialaccount.providers.mailchimp' , 'allauth.socialaccount.providers.meetup' , 'allauth.socialaccount.providers.naver' , 'allauth.socialaccount.providers.odnoklassniki' , 'allauth.socialaccount.providers.openid' , 'allauth.socialaccount.providers.orcid' , 'allauth.socialaccount.providers.paypal' , 'allauth.socialaccount.providers.persona' , 'allauth.socialaccount.providers.pinterest' , 'allauth.socialaccount.providers.reddit' , 'allauth.socialaccount.providers.robinhood' , 'allauth.socialaccount.providers.shopify' , 'allauth.socialaccount.providers.slack' , 'allauth.socialaccount.providers.soundcloud' , 'allauth.socialaccount.providers.spotify' , 'allauth.socialaccount.providers.stackexchange' , 'allauth.socialaccount.providers.stripe' , 'allauth.socialaccount.providers.trello' , 'allauth.socialaccount.providers.tumblr' , 'allauth.socialaccount.providers.twentythreeandme' , 'allauth.socialaccount.providers.twitch' , 'allauth.socialaccount.providers.twitter' , 'allauth.socialaccount.providers.untappd' , 'allauth.socialaccount.providers.vimeo' , 'allauth.socialaccount.providers.vk' , 'allauth.socialaccount.providers.weibo' , # 新浪微博 'allauth.socialaccount.providers.weixin' , # 微信 'allauth.socialaccount.providers.windowslive' , 'allauth.socialaccount.providers.xing' , ) SITE_ID = 1 # 不要漏了这句哦 |
2.在项目的urls.py(即与setting.py在同一文件夹的urls.py)里 加上 下面这句:
1
2
3
|
urlpatterns = [ url(r '^accounts/' , include( 'allauth.urls' )), ] |
温馨提示:
如果你了解或者用过 django.contrib.auth.urls 这个模块的话,那么用了django-allauth后你就可以用由 allauth 提供的 account_login , account_logout , account_set_password ......这些URLs来替代原先的 login , logout , password_change ......
3.在项目的根目录(即manage.py所在文件夹)里执行以下命令:
1
|
python manage.py migrate |
4.重启服务器。
添加社交账号登录
后台设置
注意:因为做网站一般有两种环境:开发环境(即网站在本地主机上开发)和生产环境(即网站部署在服务器),而开发环境网站主页一般为: http://127.0.0.1:8000 ,生产环境则类似为 http://www.honkerzhou.com ,为简单描述,所以下文我会直接用 你的域名 代替你的网站主页地址,故请分清自己的网站主页地址,以免混淆。
- 进入后台管理界面( 你的域名/admin/ ),点击站点(Sites),在里面增加一个站点,域名就写 你的域名 ,名称随意,填好后点保存;
- 在社交账号(SOCIAL ACCOUNTS)下的社交app(Social application)里增加一个社交app,需要你填上相关信息(下面以支持GitHub社交账号登录为例)。
- Provider:选择GitHub;
- 名称(Name):可以随便写,只有你自己能辨别就好,建议写GitHub;
- Client id和Secret key: 需要到 GitHub 上申请获取。如没有或不会,详见获取第三方应用的Client id和Secret key;
- Key: 可不填;
- Sites: 在可用的sites下选中你的域名,将其移到右边选中的sites中,点保存。
获取第三方应用的Client id和Secret key
1.GitHub
登录GitHub后 --> 进入Settings --> 进入Developer settings --> 在OAuth Apps下进入New OAuth App --> 然后按步骤填写信息 --> 进入下一步后就可以看到Client id和Secret key了。
注意:
- Homepage URL填写你的域名;
- Authorization callback URL填写你的域名/accounts/github/login/callback/。
验证和初步使用
- 重要:注销你的管理员账号!!!
- 进入这个网址: 你的域名/accounts/login/ ,你会看到一个排版很乱很丑的页面,这是django-allauth自带的模板。如果这时你选择通过GitHub账号登录并且出现了GitHub登录授权的提示说明你前面都做对了,恭喜你!
- 但你会发现授权登录后链接到了这个网址: 你的域名/accounts/profile/ ,并且得到一个404页面,这时请别慌张,你只需要在你的settings.py文件里加上这句代码: LOGIN_REDIRECT_URL = '/' 保存后刷新页面,你会发现跳转到了你网站的主页面;
- 如果你要退出登录,进入这个网址: 你的域名/accounts/logout/ 注销即可。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。
原文链接:https://segmentfault.com/a/1190000019646526