> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/ugd-management/defender-integration.md).

# Integração do Defender for Endpoint

Mostrar o onboarding, o nível de exposição, a pontuação de risco, os alertas, as vulnerabilidades e as recomendações do Microsoft Defender for Endpoint nas páginas de dispositivos do RealmJoin.

Com a opção opcional **Funcionalidades de segurança** ativado, o RealmJoin Portal consulta a API do Microsoft Defender for Endpoint (MDE) para obter o registo Defender de um dispositivo e os respetivos alertas, vulnerabilidades, recomendações de segurança, utilizadores com sessão iniciada e software instalado. Ele os mostra na [detalhes do dispositivo](https://docs.realmjoin.com/pt/ugd-management/user-list/device-details.md) página ao lado dos dados do Intune, Entra ID, Autopilot e RealmJoin Client do dispositivo.

{% hint style="info" %}
A integração é apenas de leitura e não substitui o portal do Microsoft Defender. O RealmJoin não altera nada no Defender: você investiga e resolve alertas e corrige recomendações no Microsoft Defender, para o qual a página do dispositivo tem ligação.
{% endhint %}

## Pré-requisitos

* **Licenças do Microsoft Defender for Endpoint** para os dispositivos que deseja ver.
* **Dispositivos integrados** ao Defender for Endpoint. Dispositivos que não estão integrados não mostram dados do Defender.
* O **Funcionalidades de segurança** ativadas para a sua organização (veja abaixo). Elas são **não** parte da configuração padrão do RealmJoin.

{% hint style="info" %}
O nível de exposição, as vulnerabilidades e as recomendações de segurança vêm do Microsoft Defender Vulnerability Management. Se a sua licença do Defender não o incluir, estes valores permanecem vazios.
{% endhint %}

## Ativar os recursos de Segurança

Os recursos de Segurança usam o seu próprio registo de aplicação, **RealmJoin Portal - Recursos de Segurança**, que precisa de acesso de leitura à API do Defender for Endpoint (`WindowsDefenderATP`). Veja [Permissões necessárias do Portal](https://docs.realmjoin.com/pt/implementacao/required-permissions.md#realmjoin-portal-security-features) para a lista completa.

A concessão requer um administrador que possa dar consentimento de administrador em todo o Tenant. Use uma destas formas:

* **No Portal:** Vá para **Organização ▸ Funcionalidades**. No **Funcionalidades de segurança** cartão, selecione **Ativar** e conclua o consentimento de administrador no Microsoft Entra ID.
* **Com o PowerShell:** Adicione o `SecurityFeatures` recurso com o módulo PowerShell do RealmJoin, veja [Configuração Avançada](https://docs.realmjoin.com/pt/implementacao/onboarding-realmjoin-portal/advanced-setup.md#available-features):

  ```powershell
  Update-RJTenant -AddFeatures @('SecurityFeatures') 6>&1
  ```

Uma vez ativo, o **Funcionalidades de segurança** cartão lista as permissões MDE concedidas e oferece **Reativar** para as conceder novamente. O [detalhes da organização](https://docs.realmjoin.com/pt/ugd-management/organization-details.md) página mostra **Recursos de Segurança** como *Ativa*.

## Como os dispositivos são correspondidos

O RealmJoin procura o registo do dispositivo no Defender pelo **ID do dispositivo Entra ID**. Se o Defender não tiver nenhum registo com esse ID, recorre a um registo cujo nome do computador corresponda ao nome de apresentação do dispositivo, preferindo o mais recentemente observado.

Os dados do Defender são colocados em cache durante até cinco minutos, pelo que uma alteração no Microsoft Defender pode demorar alguns minutos a aparecer no RealmJoin.

## O que a página do dispositivo mostra

Os seguintes elementos aparecem no **Visão geral** separador. As secções sem dados estão ocultas e cada uma só é mostrada às funções que tenham o RBAC correspondente [permissão](#permissions).

### Ícone de estado

Com os recursos de Segurança ativos, o cabeçalho do dispositivo mostra o **Defender MDE ativado** escudo. É azul quando o dispositivo está integrado no Defender for Endpoint e vermelho caso contrário.

{% hint style="info" %}
O **A/V atualizado** escudo ao lado não faz parte desta integração. É reportado pelo [RealmJoin Client](https://docs.realmjoin.com/pt/agente-realmjoin/realmjoin-client.md) para todos os produtos antivírus num dispositivo Windows.
{% endhint %}

### Informações de segurança de endpoint

Um resumo do registo Defender do dispositivo:

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-97090703430c7c3d06bf9d3d0cf5eac7b5f1dba8%2Fdefender-endpoint-security-information.png?alt=media" alt="Endpoint Security Information section on the device details page"><figcaption><p>Informações de segurança de endpoint</p></figcaption></figure>

| Campo                  | Significado                                                                                                                                           |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Integração**         | Estado de integração no Defender, por exemplo *Integrado*, *PodeSerIntegrado* ou *Não suportado*. Qualquer coisa diferente de *Integrado* é realçada. |
| **Estado de saúde**    | Estado do sensor, por exemplo *Ativa*, *Inativa*, *ComunicaçãoComprometida* ou *SemDadosDoSensor*. Qualquer coisa diferente de *Ativa* é realçada.    |
| **Nível de exposição** | O quão exposto o dispositivo está a ameaças, com base nas suas vulnerabilidades e configurações incorretas: *Nenhum*, *Baixo*, *Médio* ou *Alto*.     |
| **Pontuação de risco** | O risco do dispositivo com base nos alertas ativos: *Nenhum*, *Informativo*, *Baixo*, *Médio* ou *Alto*.                                              |
| **Versão do agente**   | Versão do sensor do Defender for Endpoint.                                                                                                            |
| **Grupo RBAC**         | O grupo de dispositivos do Defender ao qual o dispositivo pertence, ou *Não atribuído*.                                                               |
| **Primeira vez visto** | Quando o Defender viu o dispositivo pela primeira vez.                                                                                                |
| **Última vez visto**   | Quando o Defender recebeu dados do dispositivo pela última vez.                                                                                       |

*Baixo* e os valores mais baixos são mostrados a azul, *Médio* a amarelo e *Alto* a vermelho. Veja a [pontuação de exposição e pontuação de risco](https://learn.microsoft.com/en-us/defender-endpoint/machine-scores) documentação para saber como o Defender as calcula.

Se o Defender for Endpoint não responder a tempo, a secção mostra uma notificação em vez disso. Recarregue a página mais tarde para tentar novamente.

### Alertas de segurança

Os alertas do Defender para o dispositivo, do mais grave para o mais recente. Cada alerta mostra o respetivo título, gravidade, classificação (por exemplo *Verdadeiro positivo* ou *Falso positivo*), se está atribuído ou resolvido, quando foi criado e atualizado pela última vez ou resolvido, a respetiva descrição e categoria, e as evidências recolhidas pelo Defender: ficheiros, processos (com IDs de processo e do processo pai), URLs, contas e valores de registo.

### Vulnerabilidades de segurança

As vulnerabilidades (CVEs) que o Defender encontrou no dispositivo, ordenadas por gravidade e depois por existir ou não um exploit público ou verificado. Cada entrada mostra a sua gravidade, os *Público* e *Verificado* sinalizadores de exploit, quando a CVE foi publicada e atualizada, a sua descrição, ligações para exploits conhecidos e uma ligação para o artigo oficial da CVE.

### Recomendações de segurança

As recomendações de segurança do Defender para o dispositivo com o respetivo estado. As recomendações para atualizar software que se atualiza a si próprio (Microsoft Edge, Google Chrome, Microsoft Office e Visual Studio Code) são marcadas *Automático*.

{% hint style="info" %}
Os alertas, as vulnerabilidades e as recomendações são carregados em segundo plano após a abertura da página, porque o Defender pode demorar vários segundos a responder. Um **Segurança** espaço reservado é mostrado enquanto são carregados.
{% endhint %}

### Ligação para o Microsoft Defender

Em **Ligações externas**, **Centro de Segurança** abre o dispositivo no portal do Microsoft Defender (`security.microsoft.com`).

### separador Dados MDE

O **Dados MDE** mostra o registo bruto do dispositivo no Defender como JSON, juntamente com os alertas, recomendações, utilizadores com sessão iniciada, vulnerabilidades e relatórios de software do Defender para o dispositivo. Tal como os outros [origem de dados](https://docs.realmjoin.com/pt/ugd-management/user-group-device-management.md#data-sources) separadores, só é mostrado quando *Mostrar informações avançadas* está ativado em [Configurações](https://docs.realmjoin.com/pt/administracao-e-definicoes/general.md#show-advanced-info).

## Análise do Defender

O **Análise do Defender** botão na página do dispositivo está **não** faz parte desta integração. Pede **Intune** para executar uma análise rápida do Microsoft Defender Antivirus no dispositivo, pelo que funciona sem os recursos de Segurança, mas requer que o dispositivo seja gerido pelo Intune. Precisa do `CanScanDevice` permissão.

## Permissões

Que funções veem o que é controlado por estes [permissões](https://docs.realmjoin.com/pt/administracao-e-definicoes/permission/custom-roles/available-permissions.md#device-security):

| Permissão                                 | Mostra                                                               | Funções predefinidas                          |
| ----------------------------------------- | -------------------------------------------------------------------- | --------------------------------------------- |
| `CanSeeDeviceExtendedSecurityInformation` | Informações de segurança de endpoint                                 | Admin, Advanced Supporter, Supporter, Auditor |
| `CanSeeDeviceSecurityAlerts`              | Alertas de segurança                                                 | Admin, Advanced Supporter, Supporter, Auditor |
| `CanSeeDeviceSecurityVulnerabilities`     | Vulnerabilidades de segurança                                        | Admin, Advanced Supporter, Supporter, Auditor |
| `CanSeeDeviceSecurityRecommendations`     | Recomendações de segurança                                           | Admin, Advanced Supporter, Supporter, Auditor |
| `CanSeeDeviceExternalLinks`               | **Centro de Segurança** ligação (e as ligações do Intune e do Entra) | Admin, Advanced Supporter, Auditor            |
| `CanSeeDeviceJsonAtp`                     | separador Dados MDE (com *Mostrar informações avançadas*)            | Admin, Advanced Supporter, Auditor            |
| `CanScanDevice`                           | botão Análise do Defender (Intune)                                   | Admin, Advanced Supporter, Supporter          |

Os Administradores Globais do Entra têm todas elas. Veja [Funções predefinidas](https://docs.realmjoin.com/pt/administracao-e-definicoes/permission/pre-defined-roles.md) e [Funções personalizadas](https://docs.realmjoin.com/pt/administracao-e-definicoes/permission/custom-roles.md) para as atribuir.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/pt/ugd-management/defender-integration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
