Skip to content

Commit

Permalink
Update README.md typos and add new features + update VERSION to 1.3
Browse files Browse the repository at this point in the history
  • Loading branch information
David B committed Dec 29, 2017
1 parent 1a2b301 commit 9558df2
Show file tree
Hide file tree
Showing 2 changed files with 30 additions and 15 deletions.
43 changes: 29 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,10 +16,12 @@ Features
Live demonstration
--------------
http://pexadmin.oxygen-framework.net

Login: demo

Password: demo

NOTE: You only have a readonly access.
NOTE: You only have a readonly access in live demo.

Server Requirements:
--------------
Expand All @@ -34,12 +36,12 @@ Server Requirements:

Installation / Configuration
--------------
###Webserver configuration
PEXAdmin must be on it's own subdomain (e.g. pexadmin.example.com)

### Webserver configuration

PEXAdmin comes in 2 flavors:

- If you have access to apache server's configuration, you must setup your virtualhost to let the `/` location being mapped into the `public` folder (e.g. if all config are ok, you won't be able to access `Application` folder or any of it's contents from your browser).
- If you have access to apache server's configuration, you must setup your virtualhost to let the `/` location being mapped into the `public` folder (e.g. if all settings are ok, you won't be able to access `Application` folder or any of it's contents from your browser).
Here is a Virtualhost directive to use for example:

```
Expand All @@ -49,11 +51,12 @@ Here is a Virtualhost directive to use for example:
</VirtualHost>
```

- If you cannot modify the server configuration and only access to the folder served as root, you can download the 'no parent folder' version of PEXAdmin
- If you cannot modify the server configuration and only access to the folder served as root or want to install PEXadmin in a subfolder, you can download the 'subfolder' version of PEXAdmin or create it by running the scripts under the `subfolder-flavor` folder.

###Database configuration
### Database configuration

**As the PEXAdmin config files are all in JSON format, watch out the syntax errors!**

As the PEXAdmin config files are all in JSON format, watch out the syntax errors!
You can use tools like JSONLint to check the syntax before editing the actual file.

You have to set your database access to let PEXAdmin handle the permissions.
Expand All @@ -73,11 +76,11 @@ In this sample file, the database is hosted at `localhost` and named `minecraft`
If you set tables aliases in PermissionsEX config.yml, you have to tell the new names to PEXAdmin by editing `Application/Config/pex.json`.
In the `table_aliases` section you'll find a similar syntax to the config.yml to let you tell the aliases (at left (key) you have the original table name and at right (value) you can change the name according to your PermissionEX aliases configuration).

_Do not edit the rest of the file unless you know what you are doing!_
**Do not edit the rest of the files unless you know what you are doing!**

###Users access configuration
### Users access configuration

To allow wich users can connect to PEXAdmin, you have to edit the `Application/Config/users.json`.
To allow which users can connect to PEXAdmin, you have to edit the `Application/Config/users.json`.

```
{
Expand All @@ -90,20 +93,32 @@ To allow wich users can connect to PEXAdmin, you have to edit the `Application/C
{
"password": "d033e22ae348aeb5660fc2140aec35850c4da997",
"role": "write"
},
"admin2":
{
"password": "$2y$10$iqiefC9ER6Ifw/jnOEs8ser1ETQCZ0KDCs/ylVFPnGK.OA749WDqa",
"role": "write",
"hashType": "bcrypt"
}
}
```

Each object is a user, the key is the user's login and data is user's password and role.

In the sample config shown above, there are 2 users (demo and admin) and their passwords are respectively 'demo' and 'admin' (hashed with SHA1 algorithm).
In the sample config shown above, there are 3 users (demo , admin and admin2) and their passwords are respectively 'demo', 'admin' (hashed with SHA1 algorithm). and 'admin2' (hashed with bcrypt algorithm)

The usernames keys must be in lowercase !

Roles:
* `read` can see all permission / players / groups but cannot edit them
* it can be used for people that need to know permissions nodes
* `write` can edit all permission / players / groups

To get the SHA1 hash from your password, you can use one of the the online sha1 script, or simply run `echo sha1('YOUR PASSWORD');` in PHP.


hashType option specify which hash algorithm was used to hash the password
Here's the accepted values:
* 'sha1' (default if not provided): using the sha1 algorithm
* 'bcrypt': more robust
* 'clear': don't use any hash algorithm, meaning password is stored as-is (**This value should not be used in production and was kept for debugging / testing purposes only!**)

To get the SHA1 hash from your password, you can use one of the the online sha1 script, or simply run `echo sha1('YOUR PASSWORD');` in PHP.
To get the bcrypt hash from your password, you can also use one of the the online hash scripts, or simply run `echo password_hash("YOUR PASSWORD", PASSWORD_DEFAULT);` in PHP.
2 changes: 1 addition & 1 deletion VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
1.0
1.3

0 comments on commit 9558df2

Please sign in to comment.