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¶
To enable Check state:
Go in Manager, General Parameters
» Plugins
» 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 |
---|---|---|
|
required |
Same value as the shared secret given to the manager |
|
optional |
If set (with password), a login/logout process will be tried |
|
optional |
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"}
New in version 2.0.14: The version key is returned
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