# Supervisión externa

## 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](/es/otro/rest-api.md#api-reference) en su RADIUSaaS Admin Portal para obtener información detallada sobre el esquema del `/status` endpoint.

## Ejemplos de API

{% hint style="info" %}
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. 
{% endhint %}

{% stepper %}
{% step %}

### Cree un token de acceso como se describe [aquí](/es/portal-de-administracion/settings/permissions.md#access-tokens).

{% endstep %}

{% step %}

### Recuperar datos

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

{% tabs %}
{% tab title="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.

```powershell
$accessToken = "your_access_token"
```

2. **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.

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

{% endtab %}

{% tab title="cURL" %}

```
curl -i https://contoso.radius-as-a-service.com/api/status \ -H "Authorization: Bearer [your_access_token]"
```

{% endtab %}

{% tab title="Python" %}

```
import requests

url = "https://contoso.radius-as-a-service.com/api/status"
headers = {
    "Authorization": "Bearer your_access_token"
}

response = requests.get(url, headers=headers)

print(response.status_code)
print(response.text)
```

{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### 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
```

{% hint style="info" %}
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.
{% endhint %}
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.radiusaas.com/es/otro/rest-api/supervision-externa.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.