Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Configuration of the Accounting Service integration in the SSO directory entry: CN=Ubisecure Accounting under CN=Services, OU=System
  • Accounting site and application in SSO directory
  • Accounting Service, which is a standalone Spring Boot application running as a service in your operating system (ubisecure-accounting), see Verify the running service below

Finalise access rights

After the installation you will have a Accounting application in SSO that you can verify and manage with Management user interface - SSO. This application controls access to the Accounting Service endpoints like reporting, see Using Accounting Service.

Image Modified

Figure 1. Accounting application in SSO Management


Note
We suggest to reconfigure the allowed users for the Accounting application in the group named Accounting Users according to your needs, see SSO Management UI Groups.

...

Accounting Service health check

Noteinfo

To access Accounting Service actuator endpoints you can naturally use also curl or similar tool instead of the browser. Provide credentials in the Authorization header as advised e.g. inhere: https://en.wikipedia.org/wiki/Basic_access_Since Accounting Service v. 2.3 (SSO v. 9.3) health check does not anymore require authentication.

Preconditions:

  1. Accounting Service needs to be runningNeed to know the HTTP Basic authentication credentials, see Accounting Service management - SSO / Actuator endpoint authentication

Steps with browser:

  1. Open browser and navigate to the following path: http(s)://<host>:<port>/actuator/health

    Enter the credentials

    Image Removed

    Figure 2. Entering Accounting Service health check credentials
  2. Verify from the response that the overall status and status of each component is 'UP'

    Image Modified

    Figure 3. Accounting Service health check response in JSON format

    In normal conditions, the results will read "UP" and the endpoint will return a HTTP 200 error response.

    In error conditions, the results will read "DOWN" or "OUT_OF_SERVICE" and the endpoint will return a HTTP 503 error response.

...

Accounting Service version info

Info

When using curl or similar tool instead of the browser, provide credentials in the Authorization header as advised e.g. inhere: https://en.wikipedia.org/wiki/Basic_access_authentication.

Preconditions:

  1. Accounting Service needs to be running
  2. Need to know the HTTP Basic authentication credentials, see Accounting Service management - SSO / Actuator endpoint authentication

...

  1. Open browser and navigate to the following path: http(s)://<host>:<port>/actuator/info
  2. Enter the credentials as above

  3. Verify from the response that the version number is correct, The first two numbers here (e.g. 1.1) should match with the installed version.

    Image Modified

    Figure 4. Accounting Service info response in JSON format


Verify the functionality

See also Using Accounting Service.

...