36 Commits

Author SHA1 Message Date
dsmfool
4504b20468 Updated JumpCloud authentication example (#9722)
* Updated JumpCloud authentication example

Updated JumpCloud authentication example.  Relevant Community Support Thread: https://community.librenms.org/t/ldap-with-jumpcloud/6883

* Updated JumpCloud authentication example.

Updated JumpCloud authentication example in accordance with @murrant review.
2019-02-15 09:02:17 -06:00
FTBZ
687a390ee9 doc: add information about auth modules (#9760) 2019-01-30 21:02:18 -06:00
Neil Lathwood
1ee2e8e0e0 Updated to use new theme for docs site (#9320)
* Updated to use new theme for docs site

* Updated theme location

* Removed librenms.css

* Updated index page + re-added librenms.css

* Use built in theme modification

* flexbox grid, dump bootstrap

* tidy up things

* Added path and updated deploy script + mkdocs config

* Removed db schmea changes

* Updated to install python/pip 3

* Removed pip3 install

* Pip3 install

* Updated deploy-docs

* Updated deploy-docs
2018-10-27 23:04:34 +01:00
lug-gh
4cba0a5244 Syntax error in documentation (#9145)
just found a little syntax error in the docs, nothing special :)

DO NOT DELETE THIS TEXT

#### Please note

> Please read this information carefully. You can run `./scripts/pre-commit.php` to check your code before submitting.

- [x] Have you followed our [code guidelines?](http://docs.librenms.org/Developing/Code-Guidelines/)

#### Testers

If you would like to test this pull request then please run: `./scripts/github-apply <pr_id>`, i.e `./scripts/github-apply 9145`
2018-09-04 14:04:42 +01:00
TheGreatDoc
979f811ea9 Allow to use full DN as value for member attribute instead of member: username (#8969)
Allow to use full DN as value for member attribute instead of member: username

I dont use LDAP so this should be tested with both methods.

For using fulldn as user `$config['ldap_auth_userdn'] = true;` must be set in config.php

This comes from https://community.librenms.org/t/feature-request-full-dn-as-group-member-attibute-in-ldap-auth/4805

DO NOT DELETE THIS TEXT

#### Please note

> Please read this information carefully. You can run `./scripts/pre-commit.php` to check your code before submitting.

- [ x] Have you followed our [code guidelines?](http://docs.librenms.org/Developing/Code-Guidelines/)

#### Testers

If you would like to test this pull request then please run: `./scripts/github-apply <pr_id>`, i.e `./scripts/github-apply 5926`
2018-08-05 13:52:54 +01:00
Tony Murray
5c83aa1e28 refactor: LDAP debug output (#8434)
* LDAP debug
Updated LDAP and AD docs
ldap protocol default to v3 (so we don't have to set it all the time).  If this fails it should revert to v2.
ad was using auth_ad_timeout incorrectly (1 I think)

* Add option to list all users.
2018-03-29 11:40:27 +01:00
Adam Bishop
1c6b7a967f Single Sign-On Authentication Mechanism (#7601)
* Allow the URL a user is sent to after logging out to be customised
This is required for any authentication system that has a magic URL for logging out (e.g. /Shibboleth.sso/Logout).

* Allow auth plugins to return a username

This is a bit cleaner than the current auth flow, which special cases e.g. http authentication

* Add some tests, defaults and documentation

* Add single sign-on authentication mechanism

* Make HTTPAuth use the authExternal/getExternalUsername methods

* Add to acknowledgements

* Add reset method to Auth
2017-11-28 20:40:17 -06:00
Kevin Krumm
d0a5be128b docs: updated the user account types doc (#7794)
* docs: updated the user account types doc

added a bit more info on user account levels.

* added oxidized info

* Update Authentication.md
2017-11-25 15:21:45 -06:00
Kevin Krumm
288b7e5a6e docs: minor changes to Device Troubleshooting/Auth (#7686)
* docs: minor changes to Device Troubleshooting

* docs: minor change to Authentication

* docs: fix link for Alerting take 3

* Update Testing.md
2017-11-08 16:27:23 -06:00
Kevin Krumm
2f703d1788 docs: added allow graphs without login (#7675) 2017-11-08 09:41:38 -06:00
Tony Murray
9d73cd401a feature: LDAP auth update: alerts, api, remember me (#7335)
* feature: LDAP auth update: alerts, api, remember me
Defer ldap connection until it is needed (saves connections from pollers)
Add ability to use a bind account if the server does not allow anonymous bind.
If the server does allow anonymous bind, no config change is needed.
Use Config class

FYI, I have no way to test this.

TODO: update/validate docs

* prevent duplicate users in get_userlist()

* fix bug in Config get for auth_ldap_uid_attribute, `.` should have been `,`
Change case of uidNumber to match common configs (should be case insensitive anyway)

* revert uidnumber case changes and fix up user supplied ones as it is unintuitive that they need to be lowercase.
Add auth_ldap_binddn setting to allow more a more specific way to enter the bind user.
2017-10-30 19:28:40 +00:00
Tony Murray
5e5684f2cd docs: Reorganize authentication documentation (#7329)
Audit headers
Fix a few mistakes
Try to clarify some items
2017-09-13 19:51:39 +01:00
Neil Lathwood
f97b0b87a3 refactor: Updated ldap auth to allow configurable uidnumber field (#7302) 2017-09-08 12:04:59 -05:00
Tony Murray
50b3ffb3cf feature: add timeout to AD auth, default is 5s (#6967)
* feature: add timeout to AD auth, default is 5s
Can be configured by $config['auth_ad_timeout']

* only set timeout during bind operation
2017-07-07 23:05:40 -05:00
Tony Murray
c51fd769c3 docs Move ad bind user to the right section (#6368) 2017-04-05 13:15:51 -05:00
Tony Murray
1ea7af424b feature: bind user for active_directory auth (#6255)
* feature: bind user for active_directory auth
Optional, allows the use of "remember me", API, and alerting.

* missing global (but still may not be working)

* always return a value from reauthenticate()

* Make sure the ldapbind credentials are correct on reauth.
Do not send output if they are incorrect (use d_echo) this breaks ajax calls, etc.
Add scripts/auth_test.php, to make it easier to debug authentication.

* Refine auth_test.php a bit more
A few small cleanups in other places of the auth

* Add auth_test.php to docs
Some more improvements in the auth_test.php output.

* Update Authentication.md
2017-03-29 08:22:02 -05:00
jonathon-k
65f74215d3 feature: Add an option for ad authentication to have a default level (#4801)
* Add an option for ad authentication to have a default level

* rework as a flag indicating unspecified access is global read

* Fix indentation
2016-10-21 11:22:13 -05:00
Eldon Koyle
5749179cf5 feature: Add the ability to include an LDAP filter for users/groups in AD (#4494)
* Add auth_ad_(group|user)_filter options

* use global

* Fix some AD annoyances

Use the power of the LDAP filter to minimize the number of queries and
hopefully help performance in get_userlist, change semantics of
auth_ad_(user|group)_filter in $config to be anded with
samaccountname=USERNAME.

* remove unused variable

* update documentation

* Update Authentication.md
2016-09-21 14:42:59 -05:00
FTBZ
5ef5d65458 docs: Update Authentication.md (#4387)
* Update Authentication.md

Added note for SELinux users with LDAP/AD and Active Directory redundancy

* Update Authentication.md

Remove extra whitespace
2016-09-09 15:18:07 +01:00
Tony Murray
956e18ffcd feature: Better error messages for ad_auth (#4385) 2016-09-09 08:04:03 -05:00
Neil Lathwood
383c50b4f4 Updated docs to have source to use for edit github (#4185)
* Added source link for edit on github

* Updated formatting issues

* Updated formatting issues

* Updated formatting issues
2016-08-24 08:12:20 +01:00
Adam Winberg
1a297b8ac5 Added documentation 2016-05-20 09:47:53 +02:00
awlx
53be46ed7d Changed the text to make it more clear what to change. 2016-02-02 11:37:23 +01:00
awlx
a53f7c3df1 Added description of AD configuration options 2016-02-02 11:14:09 +01:00
Jameson Finney
8ec50f11cd Fixed some typos and formatting issues in docs 2016-01-30 22:37:28 -05:00
Jameson Finney
437d1fc40c Removed extra spaces from ends of lines. 2016-01-30 21:06:58 -05:00
Maximilian Wilhelm
64ce4f335f Add HTTP Authentication / LDAP Authorization module.
This Authentitation / Authorization module provides the ability to let
  the webserver (e.g. Apache) do the user Authentication (using Kerberos
  f.e.) and let libreNMS do the Authorization of the already known user.
  Authorization and setting of libreNMS user level is done by LDAP group
  names specified in the configuration file. The group configuration is
  basicly copied from the existing ldap Authentication module.

  To save lots of redundant queries to the LDAP server and speed up the
  libreNMS WebUI, all information is cached within the PHP $_SESSION as
  long as specified in $config['auth_ldap_cache_ttl'] (Default: 300s).

Signed-off-by: Maximilian Wilhelm <max@rfc2324.org>
2016-01-21 21:49:08 +01:00
laf
57c802cd4e Updated active directory auth to support dashboards 2016-01-17 15:26:35 +00:00
laf
3a299584b0 Added ability to specify default userlevel 2015-12-14 21:52:15 +00:00
laf
dcf4d0f378 Added docs and set default users to level 1 2015-12-13 15:51:15 +00:00
Falk Stern
dda8ffd400 Updated Documentation for 'auth_ad_check_certificates' 2015-11-16 10:25:13 +01:00
Falk Stern
8e0a95ab2b Documented all config options 2015-10-30 17:22:46 +01:00
Falk Stern
f87360bc0f Added actual documentation for active_directory auth 2015-10-22 09:13:42 +02:00
Daniel Preussker
290f9d0d18 Added php-ldap requirement to ldap-docs 2015-08-18 17:06:28 +00:00
laf
6ef66cc15d Added missing to 2015-05-06 11:22:50 +01:00
laf
3143018d22 Added docs on using varying authentication types 2015-05-06 01:44:22 +01:00