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 15:44:46 +02:00
Just enable it in the manager (*General Parameters* » *Plugins* »
2020-05-14 23:29:41 +02:00
*State Check*). You must also set a shared secret.
Usage
-----
When enabled, ``/checkstate`` URL path is handled by this plugin. GET
parameters:
============= ======== ============================================================
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``