# Exemplos

## Exemplo 1: Informações gerais de autenticação

### Âmbito e pressupostos

O âmbito da consulta fornecida abaixo é o seguinte:

* o administrador está interessado em entender quais utilizadores/dispositivos estão a autenticar-se (aceites ou rejeitados) e em construir estatísticas de frequência com base nisso
* não é utilizada marcação VLAN
* é utilizada apenas autenticação baseada em certificado (sem autenticação baseada em nome de utilizador e palavra-passe)

### Destino

[Log Analytics](/pt/portal-de-administracao/settings/log-exporter/log-analytics.md) ou [Webhook Geral](/pt/portal-de-administracao/settings/log-exporter/generic-webhook.md)

### Configuração do filtro de mensagens

#### Motor de Regras

| Nível de registo | Ativado                                    |
| ---------------- | ------------------------------------------ |
| Sucesso          | <mark style="color:vermelho;">Falso</mark> |
| Falhado          | <mark style="color:vermelho;">Falso</mark> |
| Erro             | <mark style="color:vermelho;">Falso</mark> |

#### Sistema de Autorização

| Nível de registo | Ativado                                      |
| ---------------- | -------------------------------------------- |
| Pedidos          | <mark style="color:vermelho;">Falso</mark>   |
| Sucesso          | <mark style="color:verde;">Verdadeiro</mark> |
| Falhado          | <mark style="color:verde;">Verdadeiro</mark> |
| Erro             | <mark style="color:vermelho;">Falso</mark>   |

#### Autenticação por Proxy

| Nível de registo | Ativado                                    |
| ---------------- | ------------------------------------------ |
| Ligações         | <mark style="color:vermelho;">Falso</mark> |
| Sucesso          | <mark style="color:vermelho;">Falso</mark> |
| Falhado          | <mark style="color:vermelho;">Falso</mark> |
| Erro             | <mark style="color:vermelho;">Falso</mark> |

### Configuração dos dados

{% code lineNumbers="true" %}

```json
{
    "Decision": {{ data.get("Packet-Type") }},
    "Level": {{ data.level }},
    "IP": {{ data.get("Packet-Dst-Address") }},
    "Username": {{ data.get("User-Name") }},
    {% if data.get("TLS-OCSP-Cert-Valid") != None %}
        "OCSPStatus": {{ data.get("TLS-OCSP-Cert-Valid") }},
    {% endif %}
    {% if data.level == "warning" %}
      "FailReason": {{ data.get("Module-Failure-Message") }},
    {% endif %}
    "Datetime" : {{ data.Datetime }}
}
```

{% endcode %}

## Exemplo 2: Informações detalhadas de autenticação&#x20;

### Âmbito e pressupostos

O âmbito da consulta fornecida abaixo é o seguinte:

* o administrador está interessado em entender quais utilizadores/dispositivos estão a autenticar-se via certificado ou nome de utilizador e palavra-passe (aceites ou rejeitados)
* detalhes do nome de utilizador e do certificado com resposta OCSP
* SSID e Ponto de Acesso utilizado (endereço MAC)
* RADIUSaaS [Regra](/pt/portal-de-administracao/settings/rules.md) que foi acionada, se aplicável: VLAN atribuída
* ID de correlação para investigação adicional

### Destino

[Log Analytics](/pt/portal-de-administracao/settings/log-exporter/log-analytics.md) ou [Webhook Geral](/pt/portal-de-administracao/settings/log-exporter/generic-webhook.md)

### Configuração do filtro de mensagens

#### Motor de Regras

| Nível de registo | Ativado                                      |
| ---------------- | -------------------------------------------- |
| Sucesso          | <mark style="color:verde;">Verdadeiro</mark> |
| Falhado          | <mark style="color:verde;">Verdadeiro</mark> |
| Erro             | <mark style="color:vermelho;">Falso</mark>   |

#### Sistema de Autorização

| Nível de registo | Ativado                                    |
| ---------------- | ------------------------------------------ |
| Pedidos          | <mark style="color:vermelho;">Falso</mark> |
| Sucesso          | <mark style="color:vermelho;">Falso</mark> |
| Falhado          | <mark style="color:vermelho;">Falso</mark> |
| Erro             | <mark style="color:vermelho;">Falso</mark> |

#### Autenticação por Proxy

| Nível de registo | Ativado                                    |
| ---------------- | ------------------------------------------ |
| Ligações         | <mark style="color:vermelho;">Falso</mark> |
| Sucesso          | <mark style="color:vermelho;">Falso</mark> |
| Falhado          | <mark style="color:vermelho;">Falso</mark> |
| Erro             | <mark style="color:vermelho;">Falso</mark> |

### Configuração dos dados

{% code lineNumbers="true" %}

```json
{
    "Decision": {{ data.get("Engine-Decision") }},
    "Datetime" : {{ data.Datetime }},
    "Level": {{ data.level }},
    "Authtype": {{ data.get("Authtype") }},
    "Client-MAC": {{ data.get("Client-MAC") }},
    "Username": {{ data.get("User-Name") }},
    "Applied-Rule": {{ data.get("Applied-Rule") }},
    "VLAN": {{ data.get("Assigned-VLAN", "No VLAN assigned") }},
    "Auth-Source-Type": {{ data.get("Auth-Source-Type") }},
    {% if data.get("Auth-Source-Type") == "WiFi" %}
        "SSID": {{ data.get("SSID") }},
        "AP-MAC": {{ data.get("AP-MAC") }},
    {% endif %}
    {% if data.get("Authtype") == "Certificate" %}
        "Certificate-CommonName": {{ data.get("Certificate-Details", {}).get("TLS-Cert-Common-Name") }},
        "Certificate-Serial": {{ data.get("Certificate-Details", {}).get("TLS-Client-Cert-Serial") }},
    {% endif %}
    {% if data.get("Verify-Result") != None %}
        "Verify-Result": {{ data.get("Verify-Result") }},
        "Verify-Status": {{ data.get("Verify-Status") }},
        "Verify-Type": {{ data.get("Verify-Type") }},
        "Verify-Description": {{ data.get("Verify-Description") }},
    {% endif %}
    {% if data.get("Reject-Description") != None %}
        "Reject-Description": {{ data.get("Reject-Description") }},
    {% endif %}
    "GKG-Correlation-Id": {{ data.get("GKG-Correlation-Id") }}
}
```

{% endcode %}

## Exemplo 3: Notificações gerais de erro

### Âmbito e pressupostos

O âmbito da consulta fornecida abaixo é o seguinte:

* o administrador está interessado em receber notificações proativas sobre erros na plataforma RADIUSaaS para a equipa de operações.

### Destino

[Teams](/pt/portal-de-administracao/settings/log-exporter/teams.md), ou [Log Analytics](/pt/portal-de-administracao/settings/log-exporter/log-analytics.md) ou [Webhook Geral](/pt/portal-de-administracao/settings/log-exporter/generic-webhook.md)

### Configuração do filtro de mensagens

#### Motor de Regras

| Nível de registo | Ativado                                    |
| ---------------- | ------------------------------------------ |
| Sucesso          | <mark style="color:vermelho;">Falso</mark> |
| Falhado          | <mark style="color:vermelho;">Falso</mark> |
| Erro             | <mark style="color:vermelho;">Falso</mark> |

#### Sistema de Autorização

| Nível de registo | Ativado                                      |
| ---------------- | -------------------------------------------- |
| Pedidos          | <mark style="color:vermelho;">Falso</mark>   |
| Sucesso          | <mark style="color:vermelho;">Falso</mark>   |
| Falhado          | <mark style="color:vermelho;">Falso</mark>   |
| Erro             | <mark style="color:verde;">Verdadeiro</mark> |

#### Autenticação por Proxy

| Nível de registo | Ativado                                      |
| ---------------- | -------------------------------------------- |
| Ligações         | <mark style="color:vermelho;">Falso</mark>   |
| Sucesso          | <mark style="color:vermelho;">Falso</mark>   |
| Falhado          | <mark style="color:vermelho;">Falso</mark>   |
| Erro             | <mark style="color:verde;">Verdadeiro</mark> |

### Configuração dos dados

#### Teams

{% code lineNumbers="true" %}

```
O sistema RADIUS está com problemas!
Mensagem: {{ data.get('message') }}

Dados em bruto:
{{ data }}
```

{% endcode %}

#### Log Analytics ou Webhook Geral

{% code lineNumbers="true" %}

```
{
    "Message": {{ data.get("message") }},
    "Datetime" : {{ data.get("Datetime") }},
    "Level": {{ data.get("level") }},
    "Type": {{ data.get("type", "not applicable") }}
}
```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.radiusaas.com/pt/portal-de-administracao/settings/log-exporter/examples.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.