yapi-plugin-githuboauth
v1.0.17
Published
[license-img]: http://img.shields.io/badge/license-MIT-green.svg [license-url]: http://opensource.org/licenses/MIT [node-image]: https://img.shields.io/badge/node.js-v6.0.0-blue.svg [node-url]: http://nodejs.org/download/ [npm-img]: https://img.shields.io
Downloads
21
Readme
yapi-plugin-githuboauth
第三方插件,基于Oauth2协议登录,在生成的配置文件中,添加如下配置即可:
"plugins": [
{
"name": "githuboauth",
"options": {
"type": "oauth2",
"clientId": "your client id",
"clientSecret": "your client secret",
"authMethod": "GET",
"authServer": "http://your.yapiserver",
"authPath": "登录页面地址",
"tokenPath": "code换取token接口地址",
"infoPath": "用户信息接口地址",
"redirectUri": "http://your.yapiserver/api/plugin/oauth2/callback",
"userKey": "usernamekey",
"emailKey": "emailkey",
"buttonName": "统一登录",
"authArgs": {
"login_type": "oa"
}
}
}
]
使用注意:
- Oauth2服务器用户信息需要提供:
email
和username
两个字段,如果字段名不一致,可以通过emailKey
和userKey
设置。
这里面的配置项含义如下:
clientId
客户端idclientSecret
客户端秘钥authMethod
调用oauth2服务器地址时的方法,默认GETauthServer
oauth2服务器地址authPath
授权登录页面地址tokenPath
通过code换取token的接口地址infoPath
通过token获取用户信息的接口地址redirectUri
重定向地址,授权登录页面成功之后携带code跳转的目标地址state
OAuth state,默认STATEemailKey
用户信息电子邮件字段key,当值为数组时按优先级尝试获取邮箱userKey
用户信息用户名字段key,当值为数组时按优先级尝试获取用户名buttonName
登录按钮名称,默认OAuth2登录authArgs
附加参数,单层json对象,用于格式化到authPath, tokenPath