> 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/automatisation/runbooks/runbook-references/device/security/show-bitlocker-recovery-key.md).

# Afficher la clé de récupération BitLocker

Afficher les clés de récupération BitLocker de cet appareil

### Description

Répertorie toutes les clés de récupération BitLocker sauvegardées pour cet appareil, de la plus récente à la plus ancienne, pour la récupération du disque. Rien n’est modifié. En option, les clés sont retenues lorsque Microsoft Defender for Endpoint classe l’appareil comme présentant un risque moyen ou élevé. Ainsi, les clés ne sont pas remises avant que l’équipe de sécurité n’ait été impliquée, au cas où l’appareil ferait l’objet d’une enquête.

### Afficher les clés uniquement si l’appareil n’est pas à risque

Lorsque *Afficher les clés uniquement si l’appareil n’est pas à risque* (`skipIfAtRisk`) est activé, le runbook vérifie le score de risque de l’appareil dans Microsoft Defender for Endpoint avant que toute clé de récupération ne soit récupérée. La recherche utilise l’ID d’appareil Entra et correspond à la même requête que le **Vérifier l'état de Defender** runbook exécute. La vérification est désactivée par défaut.

Résultats possibles :

* **Aucun risque élevé** (score de risque `Aucun`, `Informationnel` ou `Faible`): les clés de récupération sont affichées comme d’habitude.
* **Score de risque `Moyen` ou `Élevé`**: le runbook s’arrête avec un avertissement avant que toute clé ne soit lue. Un appareil avec un score de risque élevé peut être impliqué dans un incident de sécurité, et la divulgation de sa clé de récupération pourrait exposer les données chiffrées à un attaquant. Alignez-vous d’abord avec votre équipe de sécurité ; pour afficher quand même les clés, exécutez le runbook avec l’option désactivée.
* **Appareil introuvable dans Microsoft Defender for Endpoint**: le score de risque ne peut pas être déterminé. Le runbook le signale et poursuit la récupération de la clé, de sorte que les appareils qui ne sont pas intégrés à Defender ne sont pas bloqués.
* **Appareil trouvé, mais sans score de risque** (par ex. récemment intégré) : le runbook le signale et poursuit également.
* **La requête Defender échoue**: le runbook s’arrête sans afficher de clé, de sorte qu’un problème temporaire de l’API ne contourne jamais la protection.

#### Activer la vérification par défaut

Pour imposer la vérification pour chaque requête, préconfigurez le paramètre et masquez-le, afin qu’il ne puisse pas être désactivé depuis le portail.

La configuration JSON pour cela est la suivante :

```json
"rjgit-device_security_show-BitLocker-recovery-key": {
    "parameters": {
        "skipIfAtRisk": {
            "Default": true,
            "Hide": true
        }
    }
}
```

### Emplacement

Appareil → Sécurité → Afficher la clé de récupération BitLocker

**Nom complet du runbook**

rjgit-device\_security\_show-BitLocker-recovery-key

### Détails

| Propriété      | Valeur                              |
| -------------- | ----------------------------------- |
| Version        | 1.1.0                               |
| Modules requis | RealmJoin.RunbookHelper (>= 0.8.10) |
| Planifiable    | non                                 |

### Autorisations

#### Autorisations d’application

* **Type**: Microsoft Graph
  * BitLockerKey.Read.All
    * *Répertorie les clés de récupération BitLocker de l’appareil et lit la valeur de la clé pour l’affichage*
* **Type** : WindowsDefenderATP
  * Machine.Read.All *(facultatif — fonctionnalité : vérification du risque Defender)*
    * *Lit le score de risque de l’appareil dans la vérification préalable skipIfAtRisk*

### Paramètres

#### DeviceId

Identifiant d’appareil Entra ID de l’appareil sur lequel le runbook agit. Défini par le portail à partir de l’appareil sélectionné.

| Propriété              | Valeur                                             |
| ---------------------- | -------------------------------------------------- |
| Obligatoire            | vrai                                               |
| Valeur par défaut      |                                                    |
| Type                   | Chaîne                                             |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |

#### skipIfAtRisk

Retient les clés lorsque Microsoft Defender for Endpoint classe l’appareil comme présentant un risque moyen ou élevé, afin que l’équipe de sécurité puisse être consultée d’abord. Les appareils inconnus de Defender ne sont pas bloqués.

| Propriété                  | Valeur                                                          |
| -------------------------- | --------------------------------------------------------------- |
| Obligatoire                | faux                                                            |
| Valeur par défaut          | Faux                                                            |
| Type                       | Booléen                                                         |
| Nom d’affichage du portail | Afficher les clés uniquement si l’appareil n’est pas à risque ? |

**Options du portail**

| Option du portail                                                                      | Valeur |
| -------------------------------------------------------------------------------------- | ------ |
| Afficher les clés uniquement si le score de risque de Defender n’est ni moyen ni élevé | vrai   |
| Afficher les clés quel que soit le score de risque de Defender                         | faux   |

[Retour à l’aperçu de la référence du runbook](/fr/automatisation/runbooks/runbook-references.md)


---

# 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/automatisation/runbooks/runbook-references/device/security/show-bitlocker-recovery-key.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.