ntopng/doc/README.HTTP_AUTHENTICATOR
Jérôme Marteaux 77a4f4e9ce Http allowed nets (#2196)
* Inject allowed nets from http authenticator

* Update doc

* include some other user's preferences

* Inject allowed nets from http authenticator

* Update doc

* include some other user's preferences
2019-03-04 15:23:34 +01:00

35 lines
1.1 KiB
Text

HTTP authentication can be enabled from the ntopng preferences page.
NTOP will request a POST to an url with a JSON content:
{ "user": "username", "password": "password" }
User is granted if webservice return code 200, anything else
user is not granted. Content-type and answser content are not checked.
If you want to grant a user as an administrator, webservice must
reply a JSON like:
{ "admin": true }
Some optionals fields can personalize user.
You can set allowed ifname via optional allowedIfname field:
{ "allowedIfname": "ethX" }
You can set allowed network via optional allowedNets field:
{ "allowedNets": "10.0.0.0/24,192.168.0.0/16" }
You can set language via optional language field:
{ "language": "en" }
HTTP authentication parameters are discussed below.
* HTTP Url
Url to request for authentication.
Examples:
http://server.tld/auth
https://server.tld/auth
http://192.168.1.1/api/auth
# Setting up a simple HTTP authenticator
The python script https://github.com/ntop/ntopng/blob/dev/tools/http_authenticator.py
shows how to implement a simple HTTP authenticator. It assumes that a `/login` path
is used to indicate the login path.