External Monitoring
This article demonstrates how to use the provided API for external monitoring of your RADIUSaaS instance.
Overview
The monitoring endpoint of your RADIUSaaS instance allows you to perform the following tasks in your own 3rd party monitoring solution:
Monitor uptime of your RadSec endpoints.
Monitor uptime of your RADIUS proxies.
Monitor expiry of your RADIUS Server Certificate and its issuing CA.
If feasible in your monitoring solution, aggregation and metrics can be built around those monitors to trigger automated alerts.
API Schema Defition
Please refer to the API documentation in your RADIUSaaS Admin Portal for detailed information on the schema of the /status
endpoint.
API Examples
Please note that we are unable to provide support for 3rd party monitoring solutions and you will need to bring your own expertise beyond the scope of this article.
Create an Access Token as described here.
Retrieve Data
To retrieve data from the API endpoint, authenticate your requests using the access token created previously:
Store the Access Token
Store the access token in a PowerShell variable for easy reference. Replace your_access_token
with the actual token.
Make the API Request
Use PowerShell's Invoke-RestMethod
to send a request to the desired API. Ensure to include the access token in the request header.
Process the data according to your needs
Example 1 - Show information about the RadSec servers:
Example 2 - Show information about the RADIUS proxies:
Example 3 - Show certificate information:
Please consider that the certificates will be checked every 10 hours, and the data is cached for 60 seconds. Consequently, after renewing an expired certificate, it may take several hours for the status to be updated.
Last updated
Was this helpful?