lemonldap-ng/doc/sources/admin/checkstate.rst

35 lines
1.1 KiB
ReStructuredText
Raw Normal View History

2020-05-14 23:29:41 +02:00
Check state plugin
==================
This plugin can be used to check if portal instance is ready. This can
be a health check to request keep-alive service to force a fail-over on
the backup-node.
Configuration
-------------
2020-05-20 23:41:40 +02:00
To enable Check state:
Go in Manager, ``General Parameters`` » ``Plugins`` » ``State Check``.
You must also set a shared secret.
2020-05-14 23:29:41 +02:00
Usage
-----
2020-05-20 23:41:40 +02:00
When enabled, ``/checkstate`` URL path is handled by this plugin.
GET parameters:
2020-05-14 23:29:41 +02:00
============= ======== ============================================================
GET Parameter Need Value
============= ======== ============================================================
``secret`` required Same value as the shared secret given to the manager
``user`` optional If set (with password), a login/logout process will be tried
2020-05-18 09:56:39 +02:00
``password`` optional
2020-05-14 23:29:41 +02:00
============= ======== ============================================================
Example
~~~~~~~
- Basic availability check:
``https://auth.example.com/checkstate?secret=qwerty``
- Try to log a user in:
``https://auth.example.com/checkstate?secret=qwerty&user=dwho&password=dwho``