angellco / auth0
使用Auth0与Craft。
1.1.3
2020-06-22 09:11 UTC
Requires
- auth0/auth0-php: ^7.0.0
- craftcms/cms: ^3.1.0
This package is auto-updated.
Last update: 2024-09-22 18:41:14 UTC
README
使用Auth0与Craft。
要求
此插件需要Craft CMS 3.1.x或更高版本。
安装
要安装此插件,请按照以下说明操作。
-
打开您的终端并进入您的Craft项目
cd /path/to/project
-
然后告诉Composer加载此插件
composer require angell-co/auth0
-
在控制面板中,转到设置 → 插件,然后点击Auth0的“安装”按钮。
概述
Auth0 是一项服务,可让您快速将通用登录、单点登录(SSO)、多因素认证等集成到您的网站或应用中。
您可以使用此插件无缝地将Craft站点与Auth0集成。
配置
在开始使用此插件之前,您需要在Auth0上设置一个应用程序,在此阶段选择“常规Web应用程序”选项,无需担心填写其余设置,我们稍后会处理。
此插件的配置通过配置文件管理。一旦您安装了此插件,请将文件从 /path/to/project/vendor/angellco/auth0/src/config.php
复制到 /path/to/project/craft/config/auth0.php
并填写相关值。
该文件包含注释以帮助您,但您可以在下面查看变量及其值的详细列表。
待办事项:记录配置。
完成这些操作后,请返回Auth0仪表板中的应用程序并填写以下部分
待办事项:记录Auth0应用程序设置。
回调URL为 https://myproject.test/actions/auth0/auth/callback
。
"允许的注销URL" 设置应与 logoutReturnUrl
配置变量中设置的设置匹配。
用法
待办事项
- 登录操作:
{{ actionUrl('auth0/auth/login') }}
- 登录到Auth0和Craft,如果没有用户则静默创建和激活用户 - 注销操作:
{{ actionUrl('auth0/auth/logout') }}
- 仅注销Auth0,使用常规Craft注销操作或URL注销到Craft
路线图
一些待办事项和潜在功能的想法
- 发布
- 添加选项以 不 自动创建新用户
- 添加默认登录路由
- 记录配置文件
- 记录Auth0应用程序设置
- 记录事件
- 记录如何使用替代会话存储
- 添加twig变量,以便在模板中获取用户数据
- 处理从Auth0注销但仍在Craft中登录的情况,那时会发生什么?
- 允许
EVENT_BEFORE_USER_LOGIN
事件取消登录尝试 - 使用Auth0的会话持续时间,并添加选项以覆盖它以使用Craft的
由 Angell & Co 提供