Externes Monitoring

Dieser Artikel demonstriert, wie die bereitgestellte API für das externe Monitoring Ihrer RADIUSaaS-Instanz verwendet werden kann.

Überblick

Der Überwachungsendpunkt Ihrer RADIUSaaS-Instanz ermöglicht es Ihnen, in Ihrer eigenen Überwachungslösung eines Drittanbieters die folgenden Aufgaben durchzuführen:

• Überwachung der Verfügbarkeit Ihrer RadSec-Endpunkte.

• Überwachung der Verfügbarkeit Ihrer RADIUS-Proxies.

• Überwachung des Ablaufs Ihres RADIUS-Serverzertifikats und der ausstellenden CA.

Falls in Ihrer Überwachungslösung möglich, können um diese Überwachungen Aggregationen und Metriken aufgebaut werden, um automatisierte Warnungen auszulösen.

API-Schema-Definition

Bitte beziehen Sie sich auf die API-Dokumentation in Ihrem RADIUSaaS-Admin-Portal für detaillierte Informationen zum Schema des /status Endpunkts.

API-Beispiele

Bitte beachten Sie, dass wir keinen Support für Überwachungslösungen von Drittanbietern anbieten können und Sie über eigenes Fachwissen hinausgehen müssen, das nicht Gegenstand dieses Artikels ist.

1

Erstellen Sie ein Zugriffstoken wie beschrieben hier.

2

Daten abrufen

Um Daten vom API-Endpunkt abzurufen, authentifizieren Sie Ihre Anfragen mithilfe des zuvor erstellten Zugriffstokens:

PowerShell

1. Speichern des Zugriffstokens

Speichern Sie das Zugriffstoken in einer PowerShell-Variable zur einfachen Referenz. Ersetzen Sie your_access_token durch das tatsächliche Token.

$accessToken = "your_access_token"

1. Senden der API-Anfrage

Verwenden Sie PowerShells Invoke-RestMethod um eine Anfrage an die gewünschte API zu senden. Stellen Sie sicher, dass das Zugriffstoken im Anforderungsheader enthalten ist.

$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

Verarbeiten Sie die Daten entsprechend Ihren Anforderungen

Beispiel 1 - Informationen über die RadSec-Server anzeigen:

$response.radsecservers

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

Beispiel 2 - Informationen über die RADIUS-Proxies anzeigen:

$response.proxies

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

Beispiel 3 - Zertifikatsinformationen anzeigen:

$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

Bitte beachten Sie, dass die Zertifikate alle 10 Stunden überprüft werden, und der data ist für 60 Sekunden zwischengespeichert. Folglich kann es nach der Erneuerung eines abgelaufenen Zertifikats mehrere Stunden dauern, bis der Status aktualisiert wird.