Skip to content

Commit

Permalink
1. 重新编写README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
shinn-lancelot committed Sep 10, 2018
1 parent 409efcf commit c603d7c
Showing 1 changed file with 12 additions and 4 deletions.
16 changes: 12 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,21 @@
[![fork](https://img.shields.io/github/forks/shinn-lancelot/WechatOauthProxy.svg)](https://github.com/shinn-lancelot/WechatOauthProxy)
[![license](https://img.shields.io/github/license/shinn-lancelot/WechatOauthProxy.svg)](https://github.com/shinn-lancelot/WechatOauthProxy/blob/master/LICENSE)

### 功能描述
### 核心功能

* 代理微信授权登陆并进行转发
##### 请求源用get方式请求代理微信授权登录地址,代理服务器获取参数后向微信服务器发起请求,从而获取code或获取access_token及openid,最后代理服务器将转发回请求源。避免了微信公众号授权登录接口只能同时由同一域名发起的限制。

### 其他特性

* 限制代理接口请求源
* 填写授权登录回调域名的验证文件(txt格式)来实现代理域名在公众号微信授权登陆域名的绑定

### 安装使用

1. 本项目仅支持php环境,其他后端语言不支持。将本项目部署到服务器上(demo目录内为应用请求端向代理端发起请求的例子,可删除)。
2. 需要使用一个新域名(如:oauth.xx.com)解析到服务器公网ip上,此域名将作为微信授权登录的回调域名,修改web服务器配置:将新域名应用目录指定到该项目根目录,并重启web服务器。
3. 访问 http://oauth.xx.com/verify.html 进入页面后,在输入框填写授权登录回调域名的验证文件(txt格式)的内容,然后点击“提交”按钮。成功提交后,点击页面中的“复制微信授权回调域名”按钮复制回调域名(oauth.xx.com)。
3. 访问 http://oauth.xx.com/login.php 输入用户名密码登录后台(用户名:admin 密码:123456)。点击“添加微信公众号授权登录域名验证文件内容”按钮,进入页面后,在输入框填写授权登录回调域名的验证文件(txt格式)的内容,然后点击“提交”按钮。成功提交后,点击页面中的“复制微信授权回调域名”按钮复制回调域名(oauth.xx.com)。
4. 复制成功后,进入微信平台,在微信授权回调域名处填写复制的回调域名(oauth.xx.com)即可。
5. 此时代理地址(get):http://oauth.xx.com/index.php 。<br/>
请求参数:<br/>
Expand All @@ -29,7 +35,7 @@
| state | 重定向参数 || |
6. 根据请求地址及参数访问(使用header()函数)即可。若proxy_scope参数为"code",则返回的地址将会带有code和state参数。若proxy_scope参数为"access_token",则返回的地址将会带有access_token和openid参数。

### 举例说明
### 接口请求举例说明

* 获取code

Expand All @@ -53,8 +59,10 @@
* 本项目中的access_token与微信基础接口调用凭据的access_token无关,仅用于微信授权登录使用。
* 若仅获取code,请注意将access_token返回数据做缓存处理。
* 若获取access_token,则无需再对access_token返回数据单独缓存。若部署在Linux服务器,由于需要创建目录及文件,所以项目需要修改权限。另外,php环境需要开启session、cookie。还有,由于获取access_token需要传递app_secret参数,为减小app_secret泄露的风险,代理地址建议启用https。
* 后台可以添加接口调用安全域名(即请求来源,仅安全域名下的请求可正常进行接口调用)。不添加安全域名无限制。
* 为了安全性,请及时修改管理员密码。

### 体验地址

##### 使用的是微信公众测试号的授权登录接口,仅供测试学习。进入后请先识别二维码关注测试号。<br>代理端url:http://wxoauth.hillpy.com/index.php<br>请求端url:http://test.hillpy.com/wxoauth/index.php<br>
##### 使用的是微信公众测试号的授权登录接口,仅供测试学习。进入后请先识别二维码关注测试号(测试号粉丝上限为100个)。<br>代理端url:http://wxoauth.hillpy.com/index.php<br>请求端url:http://test.hillpy.com/wxoauth/index.php<br>
![test](http://qr.liantu.com/api.php?text=http://test.hillpy.com/wxoauth/index.php&w=300)

0 comments on commit c603d7c

Please sign in to comment.