docs: improve readme files

This commit is contained in:
simon 2021-01-23 22:44:53 +01:00
parent 1843f36c4d
commit 97584e37c2
2 changed files with 76 additions and 46 deletions

100
README.md
View File

@ -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

View File

@ -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'
}
};
```