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 different authentification backends
|
||||||
- supports WPA2 Enterprise (TTLS over PAP)
|
- 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!
|
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.
|
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
|
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.
|
- 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
|
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)
|
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
|
## Known Issues / Disclaimer
|
||||||
|
|
||||||
Support for this has landed in node 13.10.1, therefore ensure you have installed at least this node version.
|
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
|
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,..).
|
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