> 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/es/ugd-management/defender-integration.md).

# Integración de Defender for Endpoint

Mostrar el onboarding de Microsoft Defender for Endpoint, el nivel de exposición, la puntuación de riesgo, las alertas, las vulnerabilidades y las recomendaciones en las páginas de dispositivos de RealmJoin.

Con la opción opcional **Características de seguridad** activada, RealmJoin Portal consulta la API de Microsoft Defender for Endpoint (MDE) para obtener el registro de Defender de un dispositivo y sus alertas, vulnerabilidades, recomendaciones de seguridad, usuarios que han iniciado sesión y software instalado. Los muestra en la [detalles del dispositivo](https://docs.realmjoin.com/es/ugd-management/user-list/device-details.md) página junto a los datos de Intune, Entra ID, Autopilot y RealmJoin Client del dispositivo.

{% hint style="info" %}
La integración es de solo lectura y no reemplaza el portal de Microsoft Defender. RealmJoin no cambia nada en Defender: usted investiga y resuelve alertas y corrige recomendaciones en Microsoft Defender, al que enlaza la página del dispositivo.
{% endhint %}

## Requisitos previos

* **Licencias de Microsoft Defender for Endpoint** para los dispositivos que desea ver.
* **Dispositivos incorporados** en Defender for Endpoint. Los dispositivos que no están incorporados no muestran datos de Defender.
* Los **Características de seguridad** activadas para su organización (véase más abajo). Son **no** parte de la configuración predeterminada de RealmJoin.

{% hint style="info" %}
El nivel de exposición, las vulnerabilidades y las recomendaciones de seguridad provienen de Microsoft Defender Vulnerability Management. Si su licencia de Defender no lo incluye, estos valores permanecen vacíos.
{% endhint %}

## Active las funciones de seguridad

Las funciones de seguridad usan su propio registro de aplicación, **RealmJoin Portal - Funciones de seguridad**, que necesita acceso de lectura a la API de Defender for Endpoint (`WindowsDefenderATP`). Consulte [Permisos requeridos del portal](https://docs.realmjoin.com/es/despliegue/required-permissions.md#realmjoin-portal-security-features) para la lista completa.

Concederlo requiere un administrador que pueda otorgar el consentimiento de administrador en todo el Tenant. Use una de estas formas:

* **En el Portal:** Ve a **Organización ▸ Funciones**. En la **Características de seguridad** tarjeta, seleccione **Activar** y complete el consentimiento de administrador en Microsoft Entra ID.
* **Con PowerShell:** Agregue la `SecurityFeatures` función con el módulo de PowerShell de RealmJoin; consulte [Configuración avanzada](https://docs.realmjoin.com/es/despliegue/onboarding-realmjoin-portal/advanced-setup.md#available-features):

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

Una vez activa, la **Características de seguridad** tarjeta enumera los permisos de MDE concedidos y ofrece **Reactivar** para concederlos de nuevo. La [detalles de la organización](https://docs.realmjoin.com/es/ugd-management/organization-details.md) página muestra **Funciones de seguridad** como *Activo*.

## Cómo se emparejan los dispositivos

RealmJoin busca el registro del dispositivo en Defender por el **ID de dispositivo de Entra ID**. Si Defender no tiene un registro con ese ID, recurre a un registro cuyo nombre de equipo coincida con el nombre para mostrar del dispositivo, prefiriendo el visto más recientemente.

Los datos de Defender se almacenan en caché durante un máximo de cinco minutos, por lo que un cambio en Microsoft Defender puede tardar unos minutos en mostrarse en RealmJoin.

## Qué muestra la página del dispositivo

Los siguientes elementos aparecen en la **Resumen** pestaña. Las secciones sin datos se ocultan, y cada una solo se muestra a los roles que tienen el [permiso](#permissions).

### icono de estado

Con las funciones de seguridad activas, el encabezado del dispositivo muestra el **Defender MDE habilitado** escudo. Es azul cuando el dispositivo está incorporado a Defender for Endpoint y rojo en caso contrario.

{% hint style="info" %}
Los **A/V actualizado** escudo que aparece junto a él no forma parte de esta integración. Lo informa el [RealmJoin Client](https://docs.realmjoin.com/es/agente-de-realmjoin/realmjoin-client.md) para todos los productos antivirus en un dispositivo Windows.
{% endhint %}

### Información de seguridad del endpoint

Un resumen del registro de Defender del dispositivo:

<figure><img src="https://3832142177-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>Información de seguridad del endpoint</p></figcaption></figure>

| Campo                    | Significado                                                                                                                                                    |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Incorporación**        | Estado de incorporación a Defender, por ejemplo *Incorporado*, *SePuedeIncorporar* o *No compatible*. Cualquier otra cosa que no sea *Incorporado* se resalta. |
| **Estado de salud**      | Estado del sensor, por ejemplo *Activo*, *Inactivo*, *Comunicación deteriorada* o *Sin datos del sensor*. Cualquier otra cosa que no sea *Activo* se resalta.  |
| **Nivel de exposición**  | Qué tan expuesto está el dispositivo a amenazas, según sus vulnerabilidades y configuraciones incorrectas: *Ninguno*, *Bajo*, *Medio* o *Alto*.                |
| **Puntuación de riesgo** | El riesgo del dispositivo basado en alertas activas: *Ninguno*, *Informativa*, *Bajo*, *Medio* o *Alto*.                                                       |
| **Versión del agente**   | Versión del sensor de Defender for Endpoint.                                                                                                                   |
| **Grupo RBAC**           | El grupo de dispositivos de Defender al que pertenece el dispositivo, o *Sin asignar*.                                                                         |
| **Primera vez visto**    | Cuando Defender vio el dispositivo por primera vez.                                                                                                            |
| **Última vez visto**     | Cuando Defender recibió por última vez datos del dispositivo.                                                                                                  |

*Bajo* y los valores más bajos se muestran en azul, *Medio* en amarillo y *Alto* en rojo. Consulte la [puntuación de exposición y puntuación de riesgo](https://learn.microsoft.com/en-us/defender-endpoint/machine-scores) documentación de Microsoft para saber cómo los calcula Defender.

Si Defender for Endpoint no responde a tiempo, la sección muestra un aviso en su lugar. Vuelva a cargar la página más tarde para intentarlo de nuevo.

### Alertas de seguridad

Las alertas de Defender del dispositivo, ordenadas por las más graves y las más recientes primero. Cada alerta muestra su título, gravedad, clasificación (por ejemplo *Verdadero positivo* o *Falso positivo*), si está asignada o resuelta, cuándo se creó y se actualizó o resolvió por última vez, su descripción y categoría, y las pruebas que Defender recopiló: archivos, procesos (con identificadores de proceso y de proceso padre), URL, cuentas y valores del registro.

### Vulnerabilidades de seguridad

Las vulnerabilidades (CVE) que Defender encontró en el dispositivo, ordenadas por gravedad y luego por si existe un exploit público o verificado. Cada entrada muestra su gravedad, las *Público* y *Verificado* indicadores de exploit, cuándo se publicó y actualizó la CVE, su descripción, enlaces a exploits conocidos y un enlace al artículo oficial de la CVE.

### Recomendaciones de seguridad

Las recomendaciones de seguridad de Defender para el dispositivo con su estado. Las recomendaciones para actualizar software que se actualiza automáticamente (Microsoft Edge, Google Chrome, Microsoft Office y Visual Studio Code) se marcan *Automático*.

{% hint style="info" %}
Las alertas, vulnerabilidades y recomendaciones se cargan en segundo plano después de abrir la página, porque Defender puede tardar varios segundos en responder. Se muestra un **Seguridad** marcador de posición mientras se cargan.
{% endhint %}

### Enlace a Microsoft Defender

En **Enlaces externos**, **Centro de seguridad** abre el dispositivo en el portal de Microsoft Defender (`security.microsoft.com`).

### pestaña Datos de MDE

Los **Datos de MDE** la pestaña muestra el registro sin procesar del dispositivo en Defender como JSON, junto con las alertas, recomendaciones, usuarios que han iniciado sesión, vulnerabilidades e informes de software de Defender para el dispositivo. Al igual que las otras [origen de datos](https://docs.realmjoin.com/es/ugd-management/user-group-device-management.md#data-sources) pestañas, solo se muestra cuando *Mostrar información avanzada* está activado en [bloque Settings](https://docs.realmjoin.com/es/administracion-y-configuracion/general.md#show-advanced-info).

## Análisis de Defender

Los **Análisis de Defender** botón de la página del dispositivo es **no** parte de esta integración. Solicita **Intune** que ejecute un análisis rápido de Microsoft Defender Antivirus en el dispositivo, por lo que funciona sin las funciones de seguridad, pero requiere que el dispositivo esté administrado por Intune. Necesita el `CanScanDevice` permiso.

## Permisos

Qué roles ven qué está controlado por estos [permisos](https://docs.realmjoin.com/es/administracion-y-configuracion/permission/custom-roles/available-permissions.md#device-security):

| Permiso                                   | Muestra                                                          | Roles predefinidos                                        |
| ----------------------------------------- | ---------------------------------------------------------------- | --------------------------------------------------------- |
| `CanSeeDeviceExtendedSecurityInformation` | Información de seguridad del endpoint                            | Administrador, Colaborador avanzado, Colaborador, Auditor |
| `CanSeeDeviceSecurityAlerts`              | Alertas de seguridad                                             | Administrador, Colaborador avanzado, Colaborador, Auditor |
| `CanSeeDeviceSecurityVulnerabilities`     | Vulnerabilidades de seguridad                                    | Administrador, Colaborador avanzado, Colaborador, Auditor |
| `CanSeeDeviceSecurityRecommendations`     | Recomendaciones de seguridad                                     | Administrador, Colaborador avanzado, Colaborador, Auditor |
| `CanSeeDeviceExternalLinks`               | **Centro de seguridad** enlace (y los enlaces de Intune y Entra) | Administrador, Colaborador avanzado, Auditor              |
| `CanSeeDeviceJsonAtp`                     | pestaña Datos de MDE (con *Mostrar información avanzada*)        | Administrador, Colaborador avanzado, Auditor              |
| `CanScanDevice`                           | botón Análisis de Defender (Intune)                              | Administrador, Colaborador avanzado, Colaborador          |

Los administradores globales de Entra tienen todos ellos. Consulte [Roles predefinidos](https://docs.realmjoin.com/es/administracion-y-configuracion/permission/pre-defined-roles.md) y [Roles personalizados](https://docs.realmjoin.com/es/administracion-y-configuracion/permission/custom-roles.md) para asignarlos.


---

# 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/es/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.
