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

# Mostrar a chave de recuperação do BitLocker

Mostrar as chaves de recuperação do BitLocker deste dispositivo

### Descrição

Lista todas as chaves de recuperação do BitLocker com cópia de segurança para este dispositivo, da mais recente para a mais antiga, para recuperação do disco. Nada é alterado. Opcionalmente, as chaves são retidas quando o Microsoft Defender for Endpoint classifica o dispositivo como de risco médio ou alto. Assim, as chaves não são entregues antes de a equipa de segurança ser envolvida, caso o dispositivo esteja a ser investigado.

### Mostrar chaves apenas se o dispositivo não estiver em risco

Quando *Mostrar chaves apenas se o dispositivo não estiver em risco* (`skipIfAtRisk`) está ativado, o runbook verifica a pontuação de risco do dispositivo no Microsoft Defender for Endpoint antes de qualquer chave de recuperação ser obtida. A pesquisa usa o ID do dispositivo do Entra e é a mesma consulta que o **Verificar estado do Microsoft Defender** runbook executa. A verificação está desativada por predefinição.

Resultados possíveis:

* **Sem risco elevado** (pontuação de risco `Nenhum`, `Informativo` ou `Baixo`): as chaves de recuperação são mostradas como habitualmente.
* **Pontuação de risco `Médio` ou `Alto`**: o runbook é interrompido com um aviso antes de qualquer chave ser lida. Um dispositivo com uma pontuação de risco elevada pode estar envolvido num incidente de segurança e divulgar a respetiva chave de recuperação pode expor os dados encriptados a um atacante. Consulte primeiro a sua equipa de segurança; para mostrar as chaves na mesma, execute o runbook com a opção desativada.
* **Dispositivo não encontrado no Microsoft Defender for Endpoint**: a pontuação de risco não pode ser determinada. O runbook regista isso e prossegue com a obtenção da chave, pelo que os dispositivos que não estão integrados no Defender não são bloqueados.
* **Dispositivo encontrado, mas sem pontuação de risco** (por exemplo, recém-integrado): o runbook regista isso e prossegue também.
* **A consulta ao Microsoft Defender for Endpoint falha**: o runbook é interrompido sem mostrar qualquer chave, pelo que um problema temporário na API nunca contorna a proteção.

#### Ativar a verificação por predefinição

Para impor a verificação em cada pedido, predefina o parâmetro e oculte-o, para que não possa ser desativado no portal.

A configuração JSON para isto é a seguinte:

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

### Localização

Dispositivo → Segurança → Mostrar chave de recuperação do BitLocker

**Nome completo do runbook**

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

### Detalhes

| Propriedade         | Valor                               |
| ------------------- | ----------------------------------- |
| Versão              | 1.1.0                               |
| Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.10) |
| Agendável           | não                                 |

### Permissões

#### Permissões de aplicativo

* **Tipo**: Microsoft Graph
  * BitLockerKey.Read.All
    * *Lista as chaves de recuperação do BitLocker do dispositivo e lê o valor da chave para apresentação*
* **Tipo**: WindowsDefenderATP
  * Machine.Read.All *(opcional — funcionalidade: verificação de risco do Defender)*
    * *Lê a pontuação de risco Defender do dispositivo na verificação preliminar skipIfAtRisk*

### Parâmetros

#### ID do dispositivo

ID do dispositivo do Entra ID do dispositivo sobre o qual o runbook atua. Definido pelo portal a partir do dispositivo selecionado.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | verdadeiro                                              |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### skipIfAtRisk

Retém as chaves quando o Microsoft Defender for Endpoint classifica o dispositivo como de risco médio ou alto, para que a equipa de segurança possa ser consultada primeiro. Os dispositivos desconhecidos para o Defender não são bloqueados.

| Propriedade                | Valor                                                        |
| -------------------------- | ------------------------------------------------------------ |
| Obrigatório                | falso                                                        |
| Valor padrão               | Falso                                                        |
| Tipo                       | Booleano                                                     |
| Nome de exibição no portal | Mostrar chaves apenas se o dispositivo não estiver em risco? |

**Opções do portal**

| Opção do portal                                                                 | Valor      |
| ------------------------------------------------------------------------------- | ---------- |
| Mostrar chaves apenas se a pontuação de risco do Defender não for média ou alta | verdadeiro |
| Mostrar chaves independentemente da pontuação de risco do Defender              | falso      |

[Voltar à visão geral da referência do runbook](https://docs.realmjoin.com/pt/automatizacao/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/pt/automatizacao/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.
