docs: improve readme files
This commit is contained in:
		
							parent
							
								
									1843f36c4d
								
							
						
					
					
						commit
						97584e37c2
					
				
							
								
								
									
										100
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										100
									
								
								README.md
									
									
									
									
									
								
							@ -1,13 +1,47 @@
 | 
			
		||||
Basic RADIUS Server for node.js for Google LDAP Service and WPA2 Enterprise WLAN Authentification.
 | 
			
		||||
easy extensible NodeJS RADIUS Server
 | 
			
		||||
 | 
			
		||||
- supports LDAP Authentification Backend
 | 
			
		||||
- supports WPA2 Enterprise (TTLS over PAP)
 | 
			
		||||
- supports different authentification backends
 | 
			
		||||
    - LDAP (e.g. for Google LDAP Service, but also any other LDAP service)
 | 
			
		||||
    - HTTP
 | 
			
		||||
    - IMAP
 | 
			
		||||
    - SMTP
 | 
			
		||||
    - Predefined / Static username and password
 | 
			
		||||
- supports WPA2 Enterprise
 | 
			
		||||
    - TTLS
 | 
			
		||||
    - PAP / GTC
 | 
			
		||||
 | 
			
		||||
Protect your WIFI access with a username and password by a credential provider you already use!
 | 
			
		||||
 | 
			
		||||
Authentication tested with Windows, Linux, Android and Apple devices.
 | 
			
		||||
 | 
			
		||||
# Quick start
 | 
			
		||||
## Introduction
 | 
			
		||||
 | 
			
		||||
This app provides a radius server to authenticate against an authentication service. To get this running
 | 
			
		||||
you need:
 | 
			
		||||
 | 
			
		||||
1.  An running Auth Service (e.g. LDAP Service / Google Suite Enterprise / Gloud Identity Premium)
 | 
			
		||||
2.  Optional: Create your own SSL certificate (e.g. self signed via npm run create-certificate)
 | 
			
		||||
3.  Check config.js and adapt to your needs
 | 
			
		||||
 | 
			
		||||
- configure authentication:
 | 
			
		||||
  set authenticaiton to one of the [provided authenticators](src/auth/README.md), e.g.:
 | 
			
		||||
 | 
			
		||||
```js
 | 
			
		||||
var config = {
 | 
			
		||||
	// ....
 | 
			
		||||
	authentication: 'GoogleLDAPAuth',
 | 
			
		||||
	authenticationOptions: {
 | 
			
		||||
		base: 'dc=hokify,dc=com'
 | 
			
		||||
	}
 | 
			
		||||
};
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
- set radius secret
 | 
			
		||||
 | 
			
		||||
4.  Install und build server: npm install && npm run build
 | 
			
		||||
5.  Start server "npm run start"
 | 
			
		||||
 | 
			
		||||
# Quick start for using it with Google LDAP
 | 
			
		||||
 | 
			
		||||
1. Install node js => 13.10.1
 | 
			
		||||
    - easiest way is to install a node js version from nodejs.org or run "npx n latest" to install latest version.
 | 
			
		||||
@ -19,6 +53,22 @@ download the files and name them "ldap.gsuite.key" and "ldap.gsuite.crt" accordi
 | 
			
		||||
if they don't use: WPA2-Enterprise -> EAP-TTLS -> PAP / CHAP
 | 
			
		||||
6. Log in with your google credentials (email + password, ... e.g. youremail@yourcompany.com)
 | 
			
		||||
 | 
			
		||||
## Configuration
 | 
			
		||||
 | 
			
		||||
For authentication see [Authentication Details](src/auth/README.md).
 | 
			
		||||
For general config options run with --help or see see [config.js](config.js) in root.
 | 
			
		||||
 | 
			
		||||
## Installation
 | 
			
		||||
 | 
			
		||||
    npm install
 | 
			
		||||
    npm run build
 | 
			
		||||
 | 
			
		||||
## Usage
 | 
			
		||||
 | 
			
		||||
Ensure you have installed latest node version (>= 13.10.1) and run:
 | 
			
		||||
 | 
			
		||||
    npm run start
 | 
			
		||||
 | 
			
		||||
## Known Issues / Disclaimer
 | 
			
		||||
 | 
			
		||||
Support for this has landed in node 13.10.1, therefore ensure you have installed at least this node version.
 | 
			
		||||
@ -59,45 +109,3 @@ for everyone. Why limit it to something "complex" like LDAP and co. This library
 | 
			
		||||
to implement either their own authentication mechanismus (e.g. against a database), or provides some mechansimns
 | 
			
		||||
out of the box (e.g. imap, static, ldap,..).
 | 
			
		||||
 | 
			
		||||
## Installation
 | 
			
		||||
 | 
			
		||||
    npm install
 | 
			
		||||
    npm run build
 | 
			
		||||
 | 
			
		||||
## Introduction
 | 
			
		||||
 | 
			
		||||
This app provides a radius server to authenticate against google's SLDAP service. To get this running
 | 
			
		||||
you need:
 | 
			
		||||
 | 
			
		||||
1.  Running LDAP Service (E.g. Google Suite Enterprise or Gloud Identity Premium)
 | 
			
		||||
2.  Optional: Create your own SSL certificate (e.g. self signed via npm run create-certificate)
 | 
			
		||||
3.  Check config.js and adapt to your needs
 | 
			
		||||
 | 
			
		||||
- configure authentication:
 | 
			
		||||
  set authenticaiton to one of the provided authenticators.
 | 
			
		||||
 | 
			
		||||
```js
 | 
			
		||||
var config = {
 | 
			
		||||
	// ....
 | 
			
		||||
	authentication: 'GoogleLDAPAuth',
 | 
			
		||||
	authenticationOptions: {
 | 
			
		||||
		base: 'dc=hokify,dc=com'
 | 
			
		||||
	}
 | 
			
		||||
};
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
- set radius secret
 | 
			
		||||
 | 
			
		||||
4.  Install und build server: npm install && npm run build
 | 
			
		||||
5.  Start server "npm run start"
 | 
			
		||||
 | 
			
		||||
## Configuration
 | 
			
		||||
 | 
			
		||||
For authentication see [Authentication Details](src/auth/README.md).
 | 
			
		||||
For general config options run with --help or see see [config.js](config.js) in root.
 | 
			
		||||
 | 
			
		||||
## Usage
 | 
			
		||||
 | 
			
		||||
Ensure you have installed latest node version (>= 13.10.1) and run:
 | 
			
		||||
 | 
			
		||||
    npm run start
 | 
			
		||||
 | 
			
		||||
@ -168,3 +168,25 @@ c = {
 | 
			
		||||
	}
 | 
			
		||||
};
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
## HTTP Post Auth
 | 
			
		||||
 | 
			
		||||
http authenticiation via http post request
 | 
			
		||||
 | 
			
		||||
```typescript
 | 
			
		||||
interface IStaticAuthOtions {
 | 
			
		||||
	url: string; // url to send a post request with username and password 
 | 
			
		||||
}
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Example
 | 
			
		||||
 | 
			
		||||
```js
 | 
			
		||||
c = {
 | 
			
		||||
	authentication: 'HTTPAuth',
 | 
			
		||||
	authenticationOptions: {
 | 
			
		||||
		url: 'https://my-website.com/api/backend-login'
 | 
			
		||||
	}
 | 
			
		||||
};
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
		Loading…
	
		Reference in New Issue
	
	Block a user