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

# Mostrar clave de recuperación de BitLocker

Mostrar las claves de recuperación de BitLocker de este dispositivo

### Descripción

Enumera todas las claves de recuperación de BitLocker respaldadas para este dispositivo, de la más reciente a la más antigua, para la recuperación del disco. No se cambia nada. Opcionalmente, las claves se retienen cuando Microsoft Defender for Endpoint califica el dispositivo como de riesgo medio o alto. De ese modo, las claves no se entregan antes de que se haya involucrado al equipo de seguridad, en caso de que el dispositivo esté bajo investigación.

### Mostrar las claves solo si el dispositivo no está en riesgo

Cuando *Mostrar las claves solo si el dispositivo no está en riesgo* (`skipIfAtRisk`): si está habilitado, el runbook comprueba la puntuación de riesgo del dispositivo en Microsoft Defender for Endpoint antes de recuperar cualquier clave de recuperación. La consulta usa el ID de dispositivo de Entra y es la misma consulta que el **Comprobar estado de Defender** runbook realiza. La comprobación está desactivada de forma predeterminada.

Posibles resultados:

* **Sin riesgo elevado** (puntuación de riesgo `Ninguno`, `Informativo` o `Bajo`): las claves de recuperación se muestran como de costumbre.
* **Puntuación de riesgo `Medio` o `Alto`**: el runbook se detiene con una advertencia antes de leer cualquier clave. Un dispositivo con una puntuación de riesgo elevada puede estar involucrado en un incidente de seguridad, y divulgar su clave de recuperación podría exponer los datos cifrados a un atacante. Alinee esto primero con su equipo de seguridad; para mostrar las claves de todos modos, ejecute el runbook con la opción deshabilitada.
* **Dispositivo no encontrado en Microsoft Defender for Endpoint**: no se puede determinar la puntuación de riesgo. El runbook lo anota y continúa con la recuperación de la clave, por lo que los dispositivos que no están inscritos en Defender no se bloquean.
* **Dispositivo encontrado, pero sin puntuación de riesgo** (p. ej., recién incorporado): el runbook lo indica y también continúa.
* **Falla la consulta de Defender**: el runbook se detiene sin mostrar ninguna clave, por lo que un problema temporal de la API nunca elude la protección.

#### Habilitar la comprobación de forma predeterminada

Para aplicar la comprobación a cada solicitud, preconfigura el parámetro y ocúltalo, de modo que no se pueda desactivar desde el portal.

La configuración JSON para esto es la siguiente:

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

### Ubicación

Dispositivo → Seguridad → Mostrar clave de recuperación de BitLocker

**Nombre completo del runbook**

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

### Detalles

| Propiedad          | Valor                               |
| ------------------ | ----------------------------------- |
| Versión            | 1.1.0                               |
| Módulos requeridos | RealmJoin.RunbookHelper (>= 0.8.10) |
| Programable        | no                                  |

### Permisos

#### Permisos de aplicación

* **Tipo**: Microsoft Graph
  * BitLockerKey.Read.All
    * *Enumera las claves de recuperación de BitLocker del dispositivo y lee el valor de la clave para mostrarlo*
* **Tipo**: WindowsDefenderATP
  * Machine.Read.All *(opcional — característica: comprobación de riesgo de Defender)*
    * *Lee la puntuación de riesgo de Defender del dispositivo en la comprobación previa skipIfAtRisk*

### Parámetros

#### DeviceId

ID de dispositivo de Entra ID del dispositivo sobre el que actúa el runbook. Lo establece el portal a partir del dispositivo seleccionado.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | verdadero                                                   |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### skipIfAtRisk

Retiene las claves cuando Microsoft Defender for Endpoint califica el dispositivo como de riesgo medio o alto, para que primero se pueda consultar al equipo de seguridad. Los dispositivos desconocidos para Defender no se bloquean.

| Propiedad                      | Valor                                                         |
| ------------------------------ | ------------------------------------------------------------- |
| Requerido                      | falso                                                         |
| Valor predeterminado           | Falso                                                         |
| Tipo                           | Booleano                                                      |
| Nombre para mostrar del portal | ¿Mostrar las claves solo si el dispositivo no está en riesgo? |

**Opciones del portal**

| Opción del portal                                                                  | Valor     |
| ---------------------------------------------------------------------------------- | --------- |
| Mostrar las claves solo si la puntuación de riesgo de Defender no es media ni alta | verdadero |
| Mostrar las claves independientemente de la puntuación de riesgo de Defender       | falso     |

[Volver a la vista general de referencia del runbook](/es/automatizacion/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/es/automatizacion/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.