blt950 / oauth-generic
Flarum 的通用 OAuth2 提供程序
v1.0.0
2024-07-01 20:21 UTC
Requires
- flarum/core: ^1.2.0
- fof/oauth: ^1.3
README
A Flarum 扩展。Flarum 的通用 OAuth 提供程序
功能
将一个 Generic
提供程序添加到 FoF OAuth,以启用 使用 <您的自定义提供程序> 登录
功能。
安装
使用 composer 安装
composer require blt950/oauth-generic
配置
管理员面板
示例配置,请咨询您的提供程序以获取正确的值。
- 客户端 ID
<您的提供程序中的 ID>
- 客户端密钥
<您的提供程序中的密钥>
- 作用域
<您的提供程序中的作用域>
或空 - 授权端点
https://yourprovider.com/oauth/authorize
- 令牌端点
https://yourprovider.com/oauth/token
- 用户信息端点
https://yourprovider.com/api/user
为了正确找到可能嵌套在数组中的用户字段,参数支持嵌套,例如
- 用户 ID
data-id
- 用户名
data-username
- 电子邮件
data-personal-email
强制或建议字段可以在注册用户时强制或预先填充建议值。
- 强制用户 ID
1
或0
。 - 强制显示名称
1
或0
。 - 强制电子邮件
1
或0
。
提供程序名称
如果您希望更改提供程序的名称,可以通过编辑区域文件来实现。我没有找到使其动态化的方法。
更新
composer update blt950/oauth-generic php flarum cache:clear
请求和问题
如果您发现问题或希望扩展功能,请提交拉取请求。感谢您的贡献。
已知问题和错误
- 注册模态中的昵称输入字段填写的是用户名,而不是提供的显示名称。这是由于在 Flarum 未来版本中通过此拉取请求进行修复。
- 管理员面板中提供程序的图标不可见,因为 FoF OAuth 插件强制使用字体重量,这不会显示字体,但其他地方显示正确。
- 强制设置是布尔值,但具有字符串输入,因为布尔值不支持提供程序设置。