Monitoreo externo

Este artículo demuestra cómo usar la API proporcionada para el monitoreo externo de su instancia de RADIUSaaS.

Descripción general

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

• Supervisar el tiempo de actividad de sus endpoints RadSec.

• Supervisar el tiempo de actividad de sus proxies RADIUS.

• Supervisar la expiración de su Certificado de Servidor RADIUS y de la CA emisora.

Si es factible en su solución de supervisión, se pueden crear agregaciones y métricas alrededor de esos monitores para activar alertas automatizadas.

Definición del esquema de la API

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

Ejemplos de la API

Tenga en cuenta que no podemos proporcionar soporte para soluciones de supervisión de terceros y 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 una referencia sencilla. Reemplace su_token_de_acceso por el token real.

$accessToken = "su_token_de_acceso"

1. Realizar la solicitud a la API

Utilice 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

cluster_name                     : eu1
ip                               : 20.113.8.151
name                             : radius-server-contoso-main
radius-server-contoso-main-state : True
state                            : True

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

$response.proxies

ip                                       : 142.93.161.44
location                                 : Europa (Fráncfort)
name                                     : radius-proxy-contoso-142.93.161.44
radius-proxy-contoso-142.93.161.44-state : True
state                                    : True

ip                                     : 209.38.81.0
location                               : Australia (Sídney)
name                                   : radius-proxy-contoso-209.38.81.0
radius-proxy-contoso-209.38.81.0-state : True
state                                  : True

Ejemplo 3 - Mostrar información de certificados:

$response.certificates | Format-List

contoso-certificate--Proxycertificate-state : True
name                                        : contoso-certificate--Proxycertificate
state                                       : True
validity_days_left                          : 2570

contoso-certificate-Customer-CA-state : True
name                                  : contoso-certificate-Customer-CA
state                                 : True
validity_days_left                    : 6900

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