Runbook: Configuração do Pageant (Agente SSH) com mRemoteNG

**Categoria:** Runbooks & Procedimentos CTIC
**Última atualização:** 13/07/2026
**Responsável:** Felipe Rozelio

## Contexto
Após formatação do PC, o Pageant (agente SSH do pacote PuTTY) precisa ser reconfigurado
para carregar a chave privada automaticamente e evitar redigitação da passphrase a cada
conexão no mRemoteNG.

**Nota:** não confundir com o PuTTYgen — este último apenas gera/converte chaves,
não mantém sessão nem cacheia passphrase.

## Pré-requisitos
- Pacote PuTTY instalado (contém `pageant.exe`)
- Chave privada `.ppk` protegida por passphrase, sincronizada via Google Drive

## Procedimento

1. Localizar `pageant.exe` (geralmente em `C:\Program Files\PuTTY\`).
2. Criar atalho apontando para o executável + caminho da chave, como argumento: "C:\Program Files\PuTTY\pageant.exe" "G:\Meu Drive\Chaves\sua_chave.ppk"
3. Colocar o atalho em `shell:startup` (pasta Inicializar do Windows) para carregar
   automaticamente no login.
4. No primeiro carregamento, o Pageant solicita a passphrase uma única vez e mantém
   a chave decifrada em memória durante a sessão do Windows.
5. Verificar no mRemoteNG que a autenticação SSH está configurada para usar o Pageant
   (agente), e não uma chave `.ppk` referenciada diretamente na conexão — caso contrário
   ele pode solicitar a senha novamente fora do agente.

## Nota de Segurança
- A chave descriptografada permanece em memória enquanto a sessão do Windows estiver
  ativa. Recomenda-se travar a tela (`Win+L`) ao se afastar do posto de trabalho.
- Nunca sincronizar o arquivo `.ppk` sem passphrase no Google Drive.

## Aplicabilidade
Procedimento válido para qualquer reinstalação/formatação futura do posto de trabalho.