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

# Intégration de Defender pour Endpoint

Afficher sur les pages des appareils RealmJoin les informations d’intégration, le niveau d’exposition, le score de risque, les alertes, les vulnérabilités et les recommandations de Microsoft Defender for Endpoint.

Avec l’option facultative **Fonctionnalités de sécurité** activé, RealmJoin Portal interroge l’API Microsoft Defender for Endpoint (MDE) pour obtenir l’enregistrement Defender d’un appareil et ses alertes, vulnérabilités, recommandations de sécurité, utilisateurs connectés et logiciels installés. Il les affiche sur la [détails de l’appareil](https://docs.realmjoin.com/fr/ugd-management/user-list/device-details.md) page à côté des données Intune, Entra ID, Autopilot et RealmJoin Client de l’appareil.

{% hint style="info" %}
L’intégration est en lecture seule et ne remplace pas le portail Microsoft Defender. RealmJoin ne change rien dans Defender : vous examinez et résolvez les alertes et corrigez les recommandations dans Microsoft Defender, auquel la page de l’appareil renvoie.
{% endhint %}

## Prérequis

* **Licences Microsoft Defender for Endpoint** pour les appareils que vous souhaitez voir.
* **Appareils intégrés** dans Defender for Endpoint. Les appareils qui ne sont pas intégrés n’affichent aucune donnée Defender.
* Le **Fonctionnalités de sécurité** activées pour votre organisation (voir ci-dessous). Elles font **ne** partie de la configuration RealmJoin par défaut.

{% hint style="info" %}
Le niveau d’exposition, les vulnérabilités et les recommandations de sécurité proviennent de Microsoft Defender Vulnerability Management. Si votre licence Defender ne l’inclut pas, ces valeurs restent vides.
{% endhint %}

## Activer les fonctionnalités de sécurité

Les fonctionnalités de sécurité utilisent leur propre inscription d’application, **RealmJoin Portal - Fonctionnalités de sécurité**, qui nécessite un accès en lecture à l’API Defender for Endpoint (`WindowsDefenderATP`). Voir [Permissions requises du portail](https://docs.realmjoin.com/fr/deploiement/required-permissions.md#realmjoin-portal-security-features) pour la liste complète.

L’accorder nécessite un administrateur pouvant donner un consentement d’administrateur à l’échelle du Tenant. Utilisez l’une de ces méthodes :

* **Dans le portail :** Accédez à **Organisation ▸ Fonctionnalités**. Dans la **Fonctionnalités de sécurité** carte, sélectionnez **Activez** et terminez le consentement administrateur dans Microsoft Entra ID.
* **Avec PowerShell :** Ajoutez la `SecurityFeatures` fonctionnalité avec le module PowerShell RealmJoin, voir [Configuration avancée](https://docs.realmjoin.com/fr/deploiement/onboarding-realmjoin-portal/advanced-setup.md#available-features):

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

Une fois active, la **Fonctionnalités de sécurité** carte répertorie les autorisations MDE accordées et propose **Réactiver** pour les accorder à nouveau. La [détails de l’organisation](https://docs.realmjoin.com/fr/ugd-management/organization-details.md) page affiche **Fonctionnalités de sécurité** comme *Actif*.

## Comment les appareils sont mis en correspondance

RealmJoin recherche l’enregistrement de l’appareil Defender à l’aide de l’ **ID d’appareil Entra ID**. Si Defender n’a aucun enregistrement avec cet ID, il revient à un enregistrement dont le nom de l’ordinateur correspond au nom d’affichage de l’appareil, en privilégiant le plus récemment vu.

Les données Defender sont mises en cache pendant cinq minutes maximum, donc une modification dans Microsoft Defender peut prendre quelques minutes avant d’apparaître dans RealmJoin.

## Ce que la page de l’appareil affiche

Les éléments suivants apparaissent sur l’ **Aperçu** onglet d’un appareil. Les sections sans données sont masquées, et chacune n’est affichée qu’aux rôles qui possèdent le RBAC correspondant. [permission](#permissions).

### Icône d’état

Avec les fonctionnalités de sécurité actives, l’en-tête de l’appareil affiche le **bouclier Defender MDE activé** bouclier. Il est bleu lorsque l’appareil est intégré à Defender for Endpoint et rouge sinon.

{% hint style="info" %}
Le **A/V à jour** bouclier à côté ne fait pas partie de cette intégration. Il est signalé par le [RealmJoin Client](https://docs.realmjoin.com/fr/agent-realmjoin/realmjoin-client.md) pour tous les produits antivirus sur un appareil Windows.
{% endhint %}

### Informations de sécurité de l’endpoint

Un résumé de l’enregistrement Defender de l’appareil :

<figure><img src="https://1100180853-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>Informations de sécurité de l’endpoint</p></figcaption></figure>

| Champ                   | Signification                                                                                                                                             |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Intégration**         | État d’intégration Defender, par exemple *Intégré*, *Peut être intégré* ou *Non pris en charge*. Tout état autre que *Intégré* est mis en évidence.       |
| **État de santé**       | Santé du capteur, par exemple *Actif*, *Inactif*, *Communication altérée* ou *Aucune donnée du capteur*. Tout état autre que *Actif* est mis en évidence. |
| **Niveau d’exposition** | À quel point l’appareil est exposé aux menaces, selon ses vulnérabilités et ses erreurs de configuration : *Aucun*, *Faible*, *Moyen* ou *Élevé*.         |
| **Score de risque**     | Le risque de l’appareil basé sur les alertes actives : *Aucun*, *Informationnel*, *Faible*, *Moyen* ou *Élevé*.                                           |
| **Version de l’agent**  | Version du capteur Defender for Endpoint.                                                                                                                 |
| **Groupe RBAC**         | Le groupe d’appareils Defender auquel l’appareil appartient, ou *Non attribué*.                                                                           |
| **Première apparition** | Quand Defender a vu l’appareil pour la première fois.                                                                                                     |
| **Dernière activité**   | Quand Defender a reçu pour la dernière fois des données de l’appareil.                                                                                    |

*Faible* et les valeurs inférieures sont affichées en bleu, *Moyen* en jaune et *Élevé* en rouge. Voir la [documentation sur le score d’exposition et le score de risque](https://learn.microsoft.com/en-us/defender-endpoint/machine-scores) de Microsoft pour savoir comment Defender les calcule.

Si Defender for Endpoint ne répond pas à temps, la section affiche à la place un avis. Rechargez la page plus tard pour réessayer.

### Alertes de sécurité

Les alertes Defender pour l’appareil, les plus graves et les plus récentes en premier. Chaque alerte affiche son titre, sa gravité, sa classification (par exemple *Vrai positif* ou *Faux positif*), si elle est attribuée ou résolue, quand elle a été créée et mise à jour ou résolue pour la dernière fois, sa description et sa catégorie, ainsi que les preuves collectées par Defender : fichiers, processus (avec les ID de processus et de processus parent), URL, comptes et valeurs du registre.

### Vulnérabilités de sécurité

Les vulnérabilités (CVE) trouvées par Defender sur l’appareil, triées par gravité puis selon l’existence d’un exploit public ou vérifié. Chaque entrée affiche sa gravité, les indicateurs d’exploit *Public* et *Vérifié* les indicateurs d’exploit, la date de publication et de mise à jour de la CVE, sa description, des liens vers les exploits connus et un lien vers l’article officiel de la CVE.

### Recommandations de sécurité

Les recommandations de sécurité de Defender pour l’appareil avec leur statut. Les recommandations visant à mettre à jour des logiciels qui se mettent à jour eux-mêmes (Microsoft Edge, Google Chrome, Microsoft Office et Visual Studio Code) sont marquées *Automatique*.

{% hint style="info" %}
Les alertes, vulnérabilités et recommandations se chargent en arrière-plan après l’ouverture de la page, car Defender peut mettre plusieurs secondes à répondre. Un **Sécurité** espace réservé s’affiche pendant leur chargement.
{% endhint %}

### Lien vers Microsoft Defender

Sous **Liens externes**, **Centre de sécurité** ouvre l’appareil dans le portail Microsoft Defender (`security.microsoft.com`).

### onglet Données MDE

Le **Données MDE** onglet affiche l’enregistrement brut de l’appareil Defender au format JSON, ainsi que les alertes, recommandations, utilisateurs connectés, vulnérabilités et logiciels signalés par Defender pour l’appareil. Comme les autres [onglets de source de données](https://docs.realmjoin.com/fr/ugd-management/user-group-device-management.md#data-sources) , il n’est affiché que lorsque *Afficher les informations avancées* est activé dans [Settings](https://docs.realmjoin.com/fr/administration-et-parametres/general.md#show-advanced-info).

## Analyse Defender

Le **Analyse Defender** bouton sur la page de l’appareil est **ne** fait partie de cette intégration. Il demande à **Intune** d’exécuter une analyse rapide Microsoft Defender Antivirus sur l’appareil, donc il fonctionne sans les fonctionnalités de sécurité mais nécessite que l’appareil soit géré par Intune. Il nécessite `CanScanDevice` autorisation.

## Autorisations

Les rôles qui voient quoi sont contrôlés par ces [autorisations](https://docs.realmjoin.com/fr/administration-et-parametres/permission/custom-roles/available-permissions.md#device-security):

| Autorisation                              | Affiche                                                        | Rôles prédéfinis                             |
| ----------------------------------------- | -------------------------------------------------------------- | -------------------------------------------- |
| `CanSeeDeviceExtendedSecurityInformation` | Informations de sécurité de l’endpoint                         | Admin, Supporter avancé, Supporter, Auditeur |
| `CanSeeDeviceSecurityAlerts`              | Alertes de sécurité                                            | Admin, Supporter avancé, Supporter, Auditeur |
| `CanSeeDeviceSecurityVulnerabilities`     | Vulnérabilités de sécurité                                     | Admin, Supporter avancé, Supporter, Auditeur |
| `CanSeeDeviceSecurityRecommendations`     | Recommandations de sécurité                                    | Admin, Supporter avancé, Supporter, Auditeur |
| `CanSeeDeviceExternalLinks`               | **Centre de sécurité** lien (et les liens Intune et Entra)     | Admin, Supporter avancé, Supporter           |
| `CanSeeDeviceJsonAtp`                     | onglet Données MDE (avec *Afficher les informations avancées*) | Admin, Supporter avancé, Supporter           |
| `CanScanDevice`                           | bouton Analyser Defender (Intune)                              | Admin, Supporter avancé, Supporter           |

Les administrateurs globaux Entra ont tous ces droits. Voir [Rôles prédéfinis](https://docs.realmjoin.com/fr/administration-et-parametres/permission/pre-defined-roles.md) et [Rôles personnalisés](https://docs.realmjoin.com/fr/administration-et-parametres/permission/custom-roles.md) pour les attribuer.


---

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