forked from theme-next/hexo-theme-next
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add EN doc for leancloud counter security (theme-next#174)
* Add EN doc for leancloud counter security * Fix a typo in CN doc
- Loading branch information
1 parent
59022b1
commit ec8aa34
Showing
2 changed files
with
198 additions
and
7 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,191 @@ | ||
The Leancloud visitor counter plugin used in NexT has a big security bug, by which someone could change your visitor number easily and even add/delete records in your database. | ||
|
||
This bug is found by [LEAFERx](https://github.com/LEAFERx/) and confirmed by [Ivan.Nginx](https://github.com/ivan-nginx). | ||
|
||
- Related issue: [#25](https://github.com/theme-next/hexo-theme-next/issues/25) | ||
|
||
- Related pr: [#137](https://github.com/theme-next/hexo-theme-next/pull/137) | ||
|
||
- Related plugin: [hexo-leancloud-counter-security](https://github.com/theme-next/hexo-leancloud-counter-security) | ||
|
||
This bug could only be fixed manually. | ||
|
||
**Warning: All NexT sites using Leancloud visitor counter that are not fixed and other sites integrated this function by similiar ways are considered unsecurity. Please fix it as soon as possible.** | ||
|
||
--- | ||
|
||
For convience, this doc also includes the way to setup the plugin. If you have already done this, skip to *Deploy web engine to avoid your data being changed illegally*. | ||
|
||
Before you make the config, please upgrade your NexT version to v6.0.6 or greater. | ||
|
||
Please note the difference between **site config file** and **theme config file** | ||
|
||
--- | ||
|
||
# Sign up to Leancloud and create an app | ||
- Go to Leancloud website [leancloud.cn](leancloud.cn) and sign up to Leancloud. Then login. | ||
- Click `1` to enter the console: | ||
|
||
![1](https://dn-cqha0xyi.qbox.me/fc0c048a1e25dc3d10aa.jpg) | ||
|
||
- Then click `1` to create an app: | ||
|
||
![2](https://dn-cqha0xyi.qbox.me/33a56b754753a5d34b01.jpg) | ||
|
||
- Type your app name in `1` in the pop up window(eg. "test"), then choose `2`, which means developer's plan, and then click `3` to create the app: | ||
|
||
![3](https://dn-cqha0xyi.qbox.me/649ccfc6f12015d1eefb.jpg) | ||
|
||
# Create Counter class and enable plugin in NexT | ||
- Click `1`(app name) to enter the app manage page: | ||
|
||
![4](https://dn-cqha0xyi.qbox.me/d0889df29841661e0b9e.jpg) | ||
|
||
- then click `1` to create a class for counter: | ||
|
||
![5](https://dn-cqha0xyi.qbox.me/b0fbc81bd6c19fa09a46.jpg) | ||
|
||
- Type `Counter` in the pop up window in `1`, check `2`, then click `3`: | ||
|
||
![6](https://dn-cqha0xyi.qbox.me/ae6154d6a55f02f11ebf.jpg) | ||
|
||
- Click `1` to enter the app setting, then click `2`: | ||
|
||
![8](https://dn-cqha0xyi.qbox.me/9501a6372918dd9a8a92.jpg) | ||
|
||
- Paste `App ID` and `App Key` to **theme config file**`_config.yml` like this: | ||
```yml | ||
leancloud_visitors: | ||
enable: true | ||
app_id: <<your app id>> | ||
app_key: <<your app key>> | ||
# Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security | ||
security: true | ||
betterPerformance: false | ||
``` | ||
|
||
- Set domain whitelist: Click`1`, then type your domain into `2`(**protocol, domain and port should be exactly the same**): | ||
|
||
![9](https://dn-cqha0xyi.qbox.me/0e537cc4bec2e185201d.jpg) | ||
|
||
# Deploy web engine to avoid your data being changed illegally | ||
- Click `1 -> 2 -> 3` by order | ||
|
||
![10](https://dn-cqha0xyi.qbox.me/d7056dfeeef7c5d66318.jpg) | ||
|
||
- Click`1`: | ||
|
||
![11](https://dn-cqha0xyi.qbox.me/2737841bbc2bdd572ae0.jpg) | ||
|
||
- In the pop up window, click `1` to choose type `Hook`, then choose`beforeUpdate` in `2`, choose `Counter` in `3`. Paste code below into `4`, then click `5` to save it: | ||
```javascript | ||
var query = new AV.Query("Counter"); | ||
if (request.object.updatedKeys.indexOf('time') !== -1) { | ||
return query.get(request.object.id).then(function (obj) { | ||
if (obj.get("time") + 1 !== request.object.get("time")) { | ||
throw new AV.Cloud.Error('Invalid update!'); | ||
} | ||
}) | ||
} | ||
``` | ||
|
||
![12](https://dn-cqha0xyi.qbox.me/a8e13418ed1d9405315b.jpg) | ||
|
||
- Click `1` to deploy after the message in the red rect shows up: | ||
|
||
![13](https://dn-cqha0xyi.qbox.me/ca56bf2e5fc2a1343565.jpg) | ||
|
||
- Click `1` in the pop up: | ||
|
||
![14](https://dn-cqha0xyi.qbox.me/17548c13b3b23c71d845.jpg) | ||
|
||
- Click `1` to close the pop up window after the message in the red rect shows up: | ||
|
||
![15](https://dn-cqha0xyi.qbox.me/d2f50de6cefea9fd0ed3.jpg) | ||
|
||
# Set access control for your database | ||
- Open **theme config file**`_config.yml`, set `leancloud_visitors: security` to `true`: | ||
```yml | ||
leancloud_visitors: | ||
enable: true | ||
app_id: <<your app id>> | ||
app_key: <<your app key>> | ||
# Dependencies: https://github.com/theme-next/hexo-leancloud-counter-security | ||
security: true | ||
betterPerformance: false | ||
``` | ||
|
||
**Explaination for `betterPerformance`:** | ||
由于Leancloud免费版的云引擎存在请求线程数和运行时间限制以及休眠机制,很多时候访客数量加载会很慢。如果设置`betterPerformance`为`true`,则网页则会在提交请求之前直接显示访客人数为查询到的人数+1,以增加用户体验。 | ||
Because the Leancloud developer's plan has limits in requst thread amount and running time, counter number may be very slow to load in some times. If set `betterPerformance` to true, counter number will be displayed quickly by assuming the request is accepted normally. | ||
|
||
- Open cmd then switch to **root path of site**, type commands to install `hexo-leancloud-counter-security` plugin: | ||
``` | ||
npm install hexo-leancloud-counter-security --save | ||
``` | ||
|
||
- Open **site config file**`_config.yml`, add those config: | ||
```yml | ||
leancloud_counter_security: | ||
enable_sync: true | ||
app_id: <<your app id>> | ||
app_key: <<your app key> | ||
username: | ||
password: | ||
``` | ||
|
||
- Type command: | ||
``` | ||
hexo lc-counter register <<username>> <<password>> | ||
``` | ||
or | ||
``` | ||
hexo lc-counter r <<username>> <<password>> | ||
``` | ||
|
||
Change `<<username>>` and `<<password>>` to your own username and password (no need to be the same as leancloud account). They will be used in the hexo deploying. | ||
|
||
- Open **site config file**`_config.yml`, change `<<username>>` and `<<password>>`to those you set above: | ||
```yml | ||
leancloud_counter_security: | ||
enable_sync: true | ||
app_id: <<your app id>> | ||
app_key: <<your app key> | ||
username: <<your username>> # will be asked while deploying if be left blank | ||
password: <<your password>> # recommend to leave it blank for security, will be asked while deploying if be left blank | ||
``` | ||
|
||
- Add the deployer in the `deploy` of **site config file**`_config.yml`: | ||
```yml | ||
deploy: | ||
# other deployer | ||
- type: leancloud_counter_security_sync | ||
``` | ||
|
||
- Return to the Leancloud console. Click `1 -> 2`, check if there is a record added in the _User (the img below is using username "admin" for example): | ||
|
||
![16](https://dn-cqha0xyi.qbox.me/99faa5a0e7160e66d506.jpg) | ||
|
||
- Click `1 -> 2 -> 3` by order: | ||
|
||
![17](https://dn-cqha0xyi.qbox.me/b72a9e64579f5b71749d.jpg) | ||
|
||
- Click `1`(add_fields), then choose `2`: | ||
|
||
![18](https://dn-cqha0xyi.qbox.me/14a8cb37062693d768ad.jpg) | ||
|
||
- click `1`(create), then choose `2`, type the username in `3`, then click `4 -> 5`: | ||
|
||
![19](https://dn-cqha0xyi.qbox.me/d91714cfd703ef42b94c.jpg) | ||
|
||
Now your page should be similar to this img after finishing the step. | ||
|
||
![20](https://dn-cqha0xyi.qbox.me/c05e7ec9218820baf412.jpg) | ||
|
||
- Click `1`(delete), then choose `2`: | ||
|
||
![21](https://dn-cqha0xyi.qbox.me/c37b6e20726cfb1d3197.jpg) | ||
|
||
Now the bug is fixed. | ||
|
||
Every time when you run `hexo d`, plugin will scan posts in the `source/_posts` and compare to the database, then add create records for those posts which are not list in the database. This procedure is done locally so that database can only be changed by you. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters