外部監視

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

概要

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

• RadSec エンドポイントの稼働時間を監視します。
• RADIUS プロキシの稼働時間を監視します。
• RADIUS サーバー証明書およびそれを発行した CA の有効期限を監視します。

監視ソリューションで可能であれば、これらの監視を基に集計とメトリクスを作成し、自動アラートをトリガーできます。

API スキーマの定義

以下を参照してください: API ドキュメント RADIUSaaS 管理ポータル内の、 /status エンドポイントのスキーマに関する詳細情報。

API の例

なお、サードパーティ製の監視ソリューションに対するサポートは提供できません。本記事の範囲外となるため、必要な知識はご自身でご用意ください。

1

以下の手順に従ってアクセス トークンを作成します こちら.

2

データの取得

API エンドポイントからデータを取得するには、前述のアクセス トークンを使用して要求を認証します:

PowerShell

1. アクセス トークンを保存する

参照しやすいように、アクセス トークンを PowerShell 変数に保存します。次を置き換えてください: 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

curl -i https://contoso.radius-as-a-service.com/api/status \ -H "Authorization: Bearer [your_access_token]"

Python

import requests

url = "https://contoso.radius-as-a-service.com/api/status"
headers = {
    "Authorization": "Bearer your_access_token"
}

response = requests.get(url, headers=headers)

print(response.status_code)
print(response.text)

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

次の点にご注意ください: certificates は 10 時間ごとにチェックされ、 および data は 60 秒間キャッシュされます。そのため、期限切れの証明書を更新した後、ステータスが更新されるまで数時間かかる場合があります。