Pular para o conteúdo
DSEC Labs
DSEC Academy · Tutoriais
Carteiras de hardware

Krux: valide o código instalado no seu dispositivo

Baixe o instalador oficial, confira hash e assinatura e grave na Krux o firmware que os desenvolvedores publicaram.

Abrir o PDF com as telasPDF · 58 páginas

Neste tutorial vamos mostrar como instalar o código da Krux de forma correta, conferindo o hash do arquivo baixado e nos certificando de que o arquivo no nosso computador é o mesmo criado pelos desenvolvedores.

Antes de começar

  • Antes de realizar os passos deste tutorial, é imprescindível fazer uma varredura completa no seu computador, para garantir que a máquina não tem nenhum aplicativo malicioso ou qualquer outro tipo de ameaça.
  • O passo a passo foi feito no Windows, com o PowerShell.

Etapa 01

Baixe os arquivos oficiais

  1. Acesse o site oficial da Krux: https://selfcustody.github.io/krux/. Ali você pode se informar sobre o projeto open source de autocustódia e também ver o GitHub, no canto superior direito.
  2. Para a instalação, abra “Getting Started” e selecione o seu sistema operacional.
  3. Baixe os três arquivos: o instalador para Windows (o arquivo .exe do KruxInstaller), o arquivo de hash (sha256.txt), que verifica a integridade do instalador, e a assinatura digital (.sig), que confirma a autenticidade e a origem oficial. Esses recursos garantem que o software é seguro e legítimo antes da instalação.

Etapa 02

Confira a integridade (hash)

  1. Aperte Windows + R, digite “Powershell” e clique em “OK”.
  2. Com o PowerShell aberto, entre na pasta onde os arquivos foram salvos (normalmente Downloads): digite “cd Downloads” e aperte Enter.
  3. Volte ao site e copie o comando que está em “verify the integrity”, logo abaixo dos arquivos baixados.
  4. Cole o comando no PowerShell, aperte Enter e aguarde até aparecer “TRUE”.

Se o resultado for diferente de “TRUE”, o arquivo baixado está comprometido. O recomendado é passar uma varredura completa no computador e remover qualquer ameaça. Para segurança adicional, refaça todo o processo em outro computador que esteja seguro.

Etapa 03

Confira a autenticidade (assinatura)

  1. Agora sabemos que o arquivo é exatamente igual ao que está no site, mas ainda não sabemos se o site não foi comprometido ou se o autor que postou o hash é confiável. Para isso, vamos verificar a assinatura com uma ferramenta própria.
  2. Na página da Krux, desça até “Verify the authenticity” e clique no link para baixar o Gpg4win. No site do Gpg4win, clique em “Download Gpg4win”, selecione “$0” e clique em “Download”.
  3. O instalador aparece no canto superior direito do navegador: clique nele para iniciar. Clique em “Seguinte” nas telas de instalação, escolha o local, clique em “Instalar” e, no fim, deixe a caixa marcada e clique em “Terminar”.
  4. O aplicativo Kleopatra abre. A verificação será feita por linha de comando, então minimize essa tela e volte ao site da Krux.
  5. Copie o primeiro comando mostrado no site. No PowerShell, se você ainda estiver dentro da pasta Downloads, saia dela com “cd ..” e aperte Enter. Cole o comando, aperte Enter e aguarde uns 15 segundos.
  6. Ao abrir o Kleopatra de novo, você verá a assinatura “qlrddev”. Opcional: para certificar essa chave pública, selecione “qlrddev”, clique em “Certificar”, crie uma conta rápida e conclua a certificação.
  7. Volte à página da Krux e copie o outro comando. No PowerShell, entre na pasta onde está o “krux-installer” (normalmente Downloads, com “cd Downloads”), cole o comando, aperte Enter e aguarde.
  8. A mensagem diz que a assinatura é válida por “qlrddev” e mostra a impressão digital da chave principal, que pode ser conferida no site: B428 1DDD FBBD 207B FA41 1313 8974 C902 9932 6322.
  9. A mensagem “Esta chave não está certificada com uma assinatura confiável!” significa apenas que você ainda não marcou essa chave como confiável no seu GPG. Não é necessário e não interfere na segurança.

Com isso, a integridade e a autenticidade do instalador da Krux estão verificadas. Juntas, elas garantem que o arquivo é seguro e confiável.

Etapa 04

Instale o KruxInstaller

  1. No explorador de arquivos, dê dois cliques no instalador.
  2. O Windows mostra um aviso dizendo que o dispositivo foi protegido. Isso acontece porque o instalador da Krux não tem uma assinatura digital reconhecida pela Microsoft. Não indica que o software é malicioso, só que ele não foi validado por uma autoridade certificadora: muitos programas independentes enfrentam isso pelo custo e pela burocracia de obter um certificado digital.
  3. Clique em “Mais informações” e depois em “Executar assim mesmo”.
  4. Escolha instalar só para o seu usuário ou para todos e clique em “Próximo”. Aceite a permissão de administrador clicando em “Sim”, escolha a pasta de destino e clique em “Instalar”.
  5. Ao final, marque a caixa “Executar o KruxInstaller” e clique em “Concluir”. Se ele não abrir, dê dois cliques no ícone que aparece na área de trabalho.
  6. Duas janelas se abrem: a interface da aplicação e um terminal que executa os comandos localmente e mostra tudo o que está acontecendo. Deixe o terminal minimizado e não o feche: sem ele o instalador não funciona.

Etapa 05

Conheça o instalador

  1. Na tela do instalador você escolhe o dispositivo, instala a Krux, limpa o aparelho se precisar começar do zero e ajusta algumas configurações. Se você comprou o dispositivo com o código já instalado, é por aqui que pode limpar e instalar o código verificado na sua máquina, garantindo a sua própria segurança.
  2. Selecione a versão. O recomendado é sempre a mais recente; há também a versão Beta, ainda em testes, e todas as versões anteriores.
  3. Selecione o dispositivo. Os aceitos pela Krux são Maix Amigo, Maix Dock, Yahboom k210 module, M5StickV e Maix Cube; o mais usado é o Yahboom k210 module.

Etapa 06

Limpe o dispositivo

  1. Selecione “Limpar dispositivo”. Na tela de aviso, conecte o dispositivo ao computador pela porta micro USB e clique em “Continuar”.
  2. Um processo curto começa e termina numa tela que confirma a limpeza completa. Para sair, clique em “Back”.
  3. Para confirmar, desconecte e reconecte a Krux no USB: ela vai parecer que está ligando, mas nada acontece, porque foi limpa.

Etapa 07

Grave o firmware mais recente

  1. Clique em “Gravar Firmware” e depois em “Baixar”, para baixar os arquivos que serão transferidos para o dispositivo.
  2. Nesse momento o instalador verifica a autenticidade e a integridade dos arquivos. Confira essa tela com cautela: as duas assinaturas precisam estar boas. Se estiverem, clique em “Continuar”.
  3. A tela mostra exatamente o que foi feito e, ao final, a sua Krux já deve estar funcionando normalmente. Feche o instalador clicando em “Quit”.

A partir de agora, não conecte mais o dispositivo ao computador: a conexão foi só para a instalação, e ainda assim com muita cautela. Nas próximas vezes, ligue-o num powerbank ou num carregador comum. Mantenha-o totalmente offline.

Sua Krux foi instalada de maneira segura. Seguidos estes passos, você tem certeza de que o código na sua Krux é o mesmo publicado pelos desenvolvedores do projeto.

Sabemos que o processo pode ser um pouco complexo: se tiver dúvidas, entre em contato que a gente ajuda. Don't trust, verify.

Ver o tutorial completo em PDF, com a imagem de cada tela