Monitoramento Externo

Este artigo demonstra como usar a API fornecida para monitoramento externo da sua instância RADIUSaaS.

Visão geral

O endpoint de monitoramento da sua instância RADIUSaaS permite que você execute as seguintes tarefas na sua própria solução de monitoramento de terceiros:

• Monitorar o tempo de atividade dos seus endpoints RadSec.

• Monitorar o tempo de atividade dos seus proxies RADIUS.

• Monitorar a expiração do Certificado do Servidor RADIUS e da CA emissora.

Se for viável na sua solução de monitoramento, agregação e métricas podem ser construídas em torno desses monitores para acionar alertas automatizados.

Definição do Esquema da API

Consulte o documentação da API no seu Portal de Administração RADIUSaaS para informações detalhadas sobre o esquema do /status endpoint.

Exemplos de API

Observe que não podemos fornecer suporte para soluções de monitoramento de terceiros e você precisará trazer sua própria experiência além do escopo deste artigo.

1

Crie um Token de Acesso conforme descrito aqui.

2

Recuperar Dados

Para recuperar dados do endpoint da API, autentique suas solicitações usando o token de acesso criado anteriormente:

PowerShell

1. Armazenar o Token de Acesso

Armazene o token de acesso em uma variável do PowerShell para referência fácil. Substitua seu_token_de_acesso pelo token real.

$accessToken = "seu_token_de_acesso"

1. Fazer a Requisição da API

Use o Invoke-RestMethod do PowerShell para enviar uma requisição para a API desejada. Certifique-se de incluir o token de acesso no cabeçalho da requisição.

$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

Processe os dados conforme suas necessidades

Exemplo 1 - Mostrar informações sobre os servidores RadSec:

$response.radsecservers

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

Exemplo 2 - Mostrar informações sobre os proxies 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

Exemplo 3 - Mostrar informações de certificado:

$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

Considere que os certificados serão verificados a cada 10 horas, e o _source esteja em cache por 60 segundos. Consequentemente, após renovar um certificado expirado, pode levar várias horas até que o status seja atualizado.