Como instalar o Guardião Itaú (Warsaw) no Ubuntu 26.04 (Guia Passo a Passo)

Autor: Alex Hinckel

Publicado: 18/06/2026
Atualizado: 18/06/2026
4 min

Introdução

Cada vez mais empresas estão adotando o Ubuntu linux como sistema operacional padrão em estações de trabalho, especialmente em cenários onde há necessidade de reduzir custos com licenciamento e prolongar a vida útil de hardware já existente.

Em um dos nossos clientes, a decisão de migração do Windows para o Ubuntu foi motivada por dois fatores principais:

Redução de custos com licenças de sistema operacional e suíte de produtividade
Aproveitamento de máquinas antigas que não atendem aos requisitos do Windows 11

Um dos principais desafios nesse processo é a compatibilidade com soluções bancárias corporativas, como o Guardião Itaú (Warsaw), amplamente utilizado para autenticação e segurança em transações financeiras.

Neste artigo, apresentamos o passo a passo de instalação e validação do Guardião Itaú (Warsaw) em ambiente Ubuntu 26.04. A solução foi testada em laboratório e implantada em cliente real, e embora o foco seja essa versão, o procedimento também pode ser aplicado, com pequenas adaptações, a outras distribuições e versões do Ubuntu.

O que é o Guardião Itaú (Warsaw)

O Guardião Itaú (Warsaw) é um módulo de segurança utilizado pelo Itaú para reforçar a proteção de acessos ao Internet Banking e operações sensíveis. Ele atua como uma camada adicional de autenticação e integridade do ambiente, ajudando a identificar possíveis riscos no dispositivo antes de liberar o acesso às funcionalidades financeiras.

Na prática, ele é responsável por validar o ambiente do usuário, garantindo que o navegador e o sistema operacional estejam em conformidade com os requisitos de segurança do banco.

Apesar de existir suporte para Linux, o Guardião é historicamente mais consolidado no ecossistema Windows, onde possui maior integração e compatibilidade. Em alguns casos, o Itaú também disponibiliza soluções complementares voltadas ao Windows, o que pode limitar a experiência em outros sistemas operacionais.

Por isso, em ambientes Linux como o Ubuntu, é necessário seguir um processo específico de instalação e validação para garantir o funcionamento correto do módulo de segurança.

Requisitos do sistema e compatibilidade

Antes de realizar a instalação do Guardião Itaú (Warsaw), é fundamental garantir que o ambiente esteja dentro dos requisitos mínimos suportados pela solução.

Sistemas operacionais suportados

Fedora 40 ou superior (64 bits)
Ubuntu 22.04 LTS ou superior (64 bits)
openSUSE 15.5 ou superior (64 bits)
SUSE Linux Enterprise 15 ou superior (64 bits)

Navegadores suportados

Firefox 102 ou superior
Google Chrome 125 ou superior

Observações importantes

O sistema operacional deve obrigatoriamente ser 64 bits
Recomenda-se manter o sistema e o navegador sempre atualizados para garantir compatibilidade com as últimas versões do módulo de segurança
Em ambientes corporativos, extensões de segurança, antivírus com inspeção SSL ou proxies podem interferir na comunicação com o Guardião

Para mais informações oficiais e atualizações, consulte a página do Itaú: https://www.itau.com.br/guardiao

Passo a passo técnico: instalação do Guardião Itaú (Warsaw)

Abra o terminal no Ubuntu linux e acesse o diretório Downloads

				
					cd Downloads

Agora efetue o download do instalador oficial

				
					wget https://guardiao.itau.com.br/warsaw/warsaw_ubuntu.run

Agora adicione a permissão e execute o instalador

				
					chmod +x warsaw_ubuntu.run && sudo ./warsaw_ubuntu.run

Durante a execução, o instalador irá configurar automaticamente o serviço do Guardião no sistema.

Validação da instalação

Após a instalação, é fundamental validar se o serviço está ativo e operacional.

				
					# 1. Verificar portas em uso
sudo ss -naultp | grep core

# Exemplo de retorno esperado:
# tcp   LISTEN 0      128        127.0.0.1:30900      0.0.0.0:*    users:(("core",pid=3974,fd=25))

systemctl status warsaw
# Saída esperada:
# Active: active (running)

# 3. Verificar processos ativos
ps aux | grep warsaw

Boas práticas de validação

Sempre testar em Google Chrome ou Firefox atualizados
Evitar extensões de bloqueio (AdBlock, antivírus web, etc.)
Utilizar perfil limpo do navegador em caso de falha inicial
Garantir que o serviço esteja ativo antes de acessar o Internet Banking

Sua empresa precisa de suporte Linux ?

Conte com a Proactus Tecnologia para implantação, suporte e otimização de ambientes Linux.

Conclusão

A instalação do Guardião Itaú (Warsaw) no Ubuntu 26.04 é totalmente viável em ambientes corporativos, desde que realizada com validação adequada do serviço e boas práticas de configuração.

Com a adoção crescente do Linux em empresas, garantir compatibilidade com ferramentas bancárias se torna um ponto crítico na estratégia de TI moderna.

Quando corretamente instalado e validado, o Warsaw opera de forma estável, permitindo que organizações mantenham segurança bancária mesmo em ambientes Linux.

Compartilhe

Dúvidas comuns sobre o assunto

O Guardião está instalado, mas o Itaú continua pedindo para instalar novamente. O que pode ser?

Esse é um dos problemas mais comuns e geralmente indica falha na comunicação entre o navegador e o serviço local do Warsaw. Verifique se o serviço está ativo com systemctl status warsaw e se o processo está escutando localmente. Extensões do navegador, cache ou bloqueadores também podem impedir a detecção.

O serviço Warsaw está como “running”, mas não aparece nenhuma porta aberta no sistema. Isso é normal?

Não. Em condições normais, o Warsaw deve expor comunicação local (geralmente via localhost). Quando não há portas ou sockets ativos, pode indicar instalação incompleta, versão incompatível ou falha na inicialização do serviço.

O navegador trava em “Aguarde o conteúdo ser carregado”. Como resolver?

Esse comportamento normalmente está relacionado à comunicação bloqueada com o módulo de segurança. Recomenda-se testar em janela anônima, desativar extensões (AdBlock, antivírus web) e validar se o serviço Warsaw está respondendo corretamente no sistema.