外部監視

この記事は、提供されている API を使用して RADIUSaaS インスタンスの外部監視を行う方法を示します。

概要

RADIUSaaS インスタンスの監視エンドポイントを使用すると、サードパーティの監視ソリューションで次のタスクを実行できます：

• RadSec エンドポイントの稼働状況を監視します。

• RADIUS プロキシの稼働状況を監視します。

• RADIUS サーバー証明書およびその発行 CA の有効期限を監視します。

監視ソリューションで可能であれば、これらの監視項目を集計およびメトリクス化して自動アラートをトリガーすることができます。

API スキーマ定義

を参照してください API ドキュメント 詳細なスキーマ情報については、RADIUSaaS 管理ポータルの /status エンドポイントを参照してください。

API 例

サードパーティの監視ソリューションに関するサポートは提供できませんので、本記事の範囲を超える専門知識はご自身でご用意ください。

1

記載されている手順でアクセス トークンを作成してください ここ.

2

データの取得

API エンドポイントからデータを取得するには、前述のアクセス トークンを使用してリクエストを認証してください：

PowerShell

1. アクセス トークンの保存

アクセス トークンを PowerShell の変数に保存して参照しやすくします。"your_access_token" を置き換えてください。 your_access_token 実際のトークンに置き換えてください。

$accessToken = "your_access_token"

1. API リクエストを行う

PowerShell の Invoke-RestMethod を使用して目的の API にリクエストを送信します。リクエストヘッダーにアクセス トークンを含めることを忘れないでください。

$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

必要に応じてデータを処理してください

例 1 - RadSec サーバーに関する情報を表示：

$response.radsecservers

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

例 2 - RADIUS プロキシに関する情報を表示：

$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

例 3 - 証明書情報を表示：

$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

次の点にご留意ください： 証明書は 次の間隔で 10 時間ごとにチェックされ、 と data になっている限り、 60 秒間キャッシュされますその結果、有効期限切れの証明書を更新した後、ステータスの更新に数時間かかる場合があります。