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 (or POST) parameters:

GET Parameter Need Value
secret required Same value as the shared secret given to the manager
sessions optional If set to any value, checkState tries to create/delete a session into all defined session databases (SSO, OIDC, CAS, and SAML)
user optional If set (with password), a login/logout process will be tried, else if set without password, this user is searched into users database
password 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
  • Full test for a server that doesn’t allow simple user/password authentication https://auth.example.com/checkstate?secret=qwerty&user=dwho&sessions
  • Full test for a server that allow simple user/password authentication https://auth.example.com/checkstate?secret=qwerty&user=dwho&password=dwho&sessions