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
|
|
|
============= ======== ============================================================
|
|
|
|
|
2021-11-23 12:01:35 +01:00
|
|
|
Response
|
|
|
|
--------
|
|
|
|
|
|
|
|
The plugin will respond to the HTTP request with:
|
|
|
|
|
|
|
|
* HTTP code 500 if something went wrong
|
|
|
|
* HTTP code 200 and the following JSON content if something went right
|
|
|
|
|
|
|
|
```
|
|
|
|
{"result":1,"version":"2.0.14"}
|
|
|
|
```
|
|
|
|
|
|
|
|
.. versionadded:: 2.0.14
|
|
|
|
The *version* key is returned
|
|
|
|
|
|
|
|
|
|
|
|
|
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``
|