Supervisión externa

Este artículo demuestra cómo usar la API proporcionada para la supervisión externa de su instancia de RADIUSaaS.

Descripción general

El endpoint de monitoreo de su instancia de RADIUSaaS le permite realizar las siguientes tareas en su propia solución de monitoreo de terceros:

• Monitoree el tiempo de actividad de sus endpoints RadSec.

• Monitoree el tiempo de actividad de sus proxies RADIUS.

• Monitoree la caducidad del certificado de su servidor RADIUS y de su CA emisora.

Si es viable en su solución de monitoreo, se pueden crear agregaciones y métricas en torno a esos monitores para desencadenar alertas automatizadas.

Definición del esquema de la API

Consulte la documentación de la API en su RADIUSaaS Admin Portal para obtener información detallada sobre el esquema del /status endpoint.

Ejemplos de API

Tenga en cuenta que no podemos brindar soporte para soluciones de monitoreo de terceros y que necesitará aportar su propia experiencia más allá del alcance de este artículo.

1

Cree un token de acceso como se describe aquí.

2

Recuperar datos

Para recuperar datos del endpoint de la API, autentique sus solicitudes usando el token de acceso creado previamente:

PowerShell

1. Almacenar el token de acceso

Almacene el token de acceso en una variable de PowerShell para consultarlo fácilmente. Reemplace your_access_token por el token real.

$accessToken = "your_access_token"

1. Realizar la solicitud a la API

Use Invoke-RestMethod de PowerShell para enviar una solicitud a la API deseada. Asegúrese de incluir el token de acceso en el encabezado de la solicitud.

$url = "https://contoso.radius-as-a-service.com/api/status"
$headers = @{
    Authorization = "Bearer $accessToken"
}
$response = Invoke-RestMethod -Uri $url -Headers $headers -Method Get

cURL

Python

3

Procese los datos según sus necesidades

Ejemplo 1 - Mostrar información sobre los servidores RadSec:

$response.radsecservers

nombre_del_clúster                     : eu1
ip                               : 20.113.8.151
nombre                             : radius-server-contoso-main
estado-radius-server-contoso-main : True
estado                            : True

Ejemplo 2 - Mostrar información sobre los proxies RADIUS:

$response.proxies

ip                                       : 142.93.161.44
ubicación                                 : Europa (Fráncfort)
nombre                                     : radius-proxy-contoso-142.93.161.44
estado-radius-proxy-contoso-142.93.161.44 : True
estado                                    : True

ip                                     : 209.38.81.0
ubicación                               : Australia (Sídney)
nombre                                   : radius-proxy-contoso-209.38.81.0
estado-radius-proxy-contoso-209.38.81.0 : True
estado                                  : True

Ejemplo 3 - Mostrar información del certificado:

$response.certificates | Format-List

estado-del-certificado-contoso--certificado-proxy : True
nombre                                        : contoso-certificate--Proxycertificate
estado                                       : True
días_de_validez_restantes                          : 2570

estado-del-certificado-contoso-CA-del-cliente : True
nombre                                  : contoso-certificate-Customer-CA
estado                                 : True
días_de_validez_restantes                    : 6900

Tenga en cuenta que los certificados se comprobarán cada 10 horas, y el data se almacena en caché durante 60 segundos. En consecuencia, después de renovar un certificado caducado, puede tardar varias horas en actualizarse el estado.