Externe Überwachung

Dieser Artikel zeigt, wie die bereitgestellte API für die externe Überwachung Ihrer RADIUSaaS-Instanz verwendet werden kann.

Übersicht

Der Monitoring-Endpunkt Ihrer RADIUSaaS-Instanz ermöglicht Ihnen, die folgenden Aufgaben in Ihrer eigenen Monitoring-Lösung eines Drittanbieters durchzuführen:

• Überwachen Sie die Verfügbarkeit Ihrer RadSec-Endpunkte.

• Überwachen Sie die Verfügbarkeit Ihrer RADIUS-Proxys.

• Überwachen Sie das Ablaufdatum Ihres RADIUS-Serverzertifikats und der ausstellenden CA.

Falls in Ihrer Monitoring-Lösung möglich, können Aggregation und Metriken auf Basis dieser Monitore erstellt werden, um automatisierte Warnungen auszulösen.

API-Schema-Definition

Bitte beachten Sie 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 Monitoring-Lösungen von Drittanbietern anbieten können und Sie über das in diesem Artikel beschriebene Maß hinaus Ihr eigenes Fachwissen einbringen müssen.

1

Erstellen Sie einen Zugriffstoken wie beschrieben hier.

2

Daten abrufen

Um Daten vom API-Endpunkt abzurufen, authentifizieren Sie Ihre Anfragen mit dem zuvor erstellten Zugriffstoken:

PowerShell

1. Speichern Sie den Zugriffstoken

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

$accessToken = "your_access_token"

1. Die API-Anfrage stellen

Verwenden Sie PowerShells Invoke-RestMethod um eine Anfrage an die gewünschte API zu senden. Stellen Sie sicher, dass Sie den Zugriffstoken im Anforderungsheader einschließen.

$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 nach Ihren Bedürfnissen

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-Proxys 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 werden alle 10 Stunden überprüft, und der data wird 60 Sekunden lang zwischengespeichert. Folglich kann es nach der Erneuerung eines abgelaufenen Zertifikats mehrere Stunden dauern, bis der Status aktualisiert wird.