Supervision externe

Cet article montre comment utiliser l'API fournie pour la supervision externe de votre instance RADIUSaaS.

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 dans votre RADIUSaaS Admin Portal pour obtenir des informations détaillées sur le schéma de l’ /status endpoint.

Exemples d’API

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.

1

Créez un jeton d’accès comme décrit ici.

2

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 :

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.

$accessToken = "your_access_token"

1. 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.

$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

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

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.