# Surveillance externe

## Vue d’ensemble

L’endpoint de supervision de votre instance RADIUSaaS vous permet d’effectuer les tâches suivantes dans votre propre solution de supervision tierce :

* Surveillez la disponibilité de vos points de terminaison RadSec.
* Surveillez la disponibilité de vos proxys RADIUS.
* Surveillez l’expiration de votre certificat de serveur RADIUS et de l’AC émettrice.

Si cela est possible dans votre solution de supervision, des agrégations et des métriques peuvent être construites autour de ces superviseurs afin de déclencher des alertes automatisées. 

## Définition du schéma de l’API

Veuillez vous référer à la [documentation de l’API](/fr/autre/rest-api.md#api-reference) dans votre RADIUSaaS Admin Portal pour obtenir des informations détaillées sur le schéma de l’ `/status` endpoint.

## Exemples d’API

{% hint style="info" %}
Veuillez noter que nous ne sommes pas en mesure de fournir une assistance pour les solutions de supervision tierces et que vous devrez apporter votre propre expertise au-delà du cadre de cet article. 
{% endhint %}

{% stepper %}
{% step %}

### Créez un jeton d’accès comme décrit [ici](/fr/portail-dadministration/settings/permissions.md#access-tokens).

{% endstep %}

{% step %}

### Récupérer les données

Pour récupérer des données depuis l’endpoint de l’API, authentifiez vos requêtes à l’aide du jeton d’accès créé précédemment :

{% tabs %}
{% tab title="PowerShell" %}

1. **Stocker le jeton d’accès**

Stockez le jeton d’accès dans une variable PowerShell pour y accéder facilement. Remplacez `your_access_token` par le jeton réel.

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

2. **Effectuer la requête API**

Utilisez `Invoke-RestMethod` de PowerShell pour envoyer une requête à l’API souhaitée. Veillez à inclure le jeton d’accès dans l’en-tête de la requête.

```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 %}

### Traitez les données selon vos besoins

#### Exemple 1 - Afficher des informations sur les serveurs RadSec :

```
$response.radsecservers

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

#### Exemple 2 - Afficher des informations sur les proxys RADIUS :

```
$response.proxies

ip                                       : 142.93.161.44
location                                 : Europe (Francfort)
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                               : Australie (Sydney)
name                                   : radius-proxy-contoso-209.38.81.0
radius-proxy-contoso-209.38.81.0-state : True
state                                  : True
```

#### Exemple 3 - Afficher les informations du certificat :

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

{% hint style="info" %}
Veuillez noter que les **certificats** seront **vérifiés toutes les 10 heures,** et le **data** sont **mis en cache pendant 60 secondes**. Par conséquent, après le renouvellement d’un certificat expiré, il peut s’écouler plusieurs heures avant que l’état soit mis à jour.
{% 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/fr/autre/rest-api/surveillance-externe.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.