Supervision externe

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

Aperçu

Le point de terminaison de surveillance de votre instance RADIUSaaS vous permet d'effectuer les tâches suivantes dans votre propre solution de surveillance tierce :

• Surveiller la disponibilité de vos points de terminaison RadSec.

• Surveiller la disponibilité de vos proxies RADIUS.

• Surveiller l'expiration de votre certificat de serveur RADIUS et de l'autorité de certification qui l'a émis.

Si votre solution de surveillance le permet, des agrégations et des métriques peuvent être construites autour de ces contrôles pour déclencher des alertes automatisées.

Définition du schéma de l'API

Veuillez vous référer au La documentation de l'API dans votre portail d'administration RADIUSaaS pour des informations détaillées sur le schéma du /status point de terminaison.

Exemples d'API

Veuillez noter que nous ne pouvons pas fournir de support pour les solutions de surveillance 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 des données

Pour récupérer des données depuis le point de terminaison API, authentifiez vos requêtes en utilisant le 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 une référence facile. Remplacez votre_jeton_d'accès par le jeton réel.

$accessToken = "votre_jeton_d'accès"

1. Effectuer la requête API

Utilisez Invoke-RestMethod de PowerShell pour envoyer une requête à l'API souhaitée. Assurez-vous d'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 proxies 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 sur les certificats :

$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 objet le renouvellement automatique mis en cache pendant 60 secondes. Par conséquent, après le renouvellement d'un certificat expiré, il peut falloir plusieurs heures pour que le statut soit mis à jour.