Itaú Mailbox (SFG)
Instale, configure e opere o Itaú Mailbox no modelo SFG pela interface web ou linha de comando.
Antes de começar
Antes de instalar o Itaú Mailbox (IMB), tenha em mãos:
- O usuário fornecido pelo Itaú;
- A senha de acesso à caixa postal;
- O sistema operacional em que o IMB será instalado;
- Um diretório dedicado para a instalação;
- Acesso de rede ao servidor SFTP do Itaú e à interface local do IMB. SFTP é um protocolo de transmissão de arquivos por conexão segura.
Segurança
Trate usuário e senha como credenciais sensíveis. Não compartilhe essas informações por e-mail, chats corporativos ou repositórios de código.
Requisitos
Para instalar o IMB, você precisa de:
- Windows, Linux ou macOS;
- Acesso ao instalador disponível na área de Ferramentas e Downloads;
- Conectividade com o servidor SFTP do Itaú;
- Porta local 9010 disponível para a interface web, acessada pelo navegador;
- Configuração de proxy corporativo, intermediário de acesso à rede, quando aplicável.
Como configurar o Itaú Mailbox
O processo de configuração é dividido em 5 etapas:
Operação e automação: consulte Operações principais e Automação via linha de comando.
Instalação
Baixe o instalador, extraia os arquivos e execute o IMB no seu sistema operacional.
Baixe o instalador
Acesse a área de Ferramentas e Downloads e baixe a versão compatível com seu sistema operacional.
Extraia os arquivos
Extraia o conteúdo para um diretório dedicado. Exemplos:
Windows
C:\itau\imbLinux ou macOS
/home/usuario/itau/imbNo Windows, clique com o botão direito no arquivo baixado, escolha Extrair tudo, informe a pasta de destino e selecione Extrair.

Após a extração, a pasta de instalação deve conter os arquivos apresentados na captura:

Importante
Use um diretório dedicado, em vez de pastas temporárias ou da pasta Downloads. Instalar nesses locais pode dificultar a manutenção e o gerenciamento dos arquivos do IMB.
Execute o IMB
Na pasta de instalação, execute:
Windows
imb.exeLinux ou macOS
imbmacOS: torne o arquivo executável
No pacote do IMB para macOS, torne o arquivo
imbexecutável antes de executá-lo pela primeira vez. No Terminal do Mac, acesse a pasta de instalação e use a ferramentachmod, que altera permissões do arquivo:cd /Users/usuario/itau/imb chmod +x imb ./imbConsulte Torne um arquivo executável no Terminal do Mac, no Suporte da Apple (BR).
Ao ser iniciado, o IMB informa no terminal o endereço da interface web. Para acessar a interface gráfica, abra http://localhost:9010 no navegador ou use o atalho IMB disponível na pasta de instalação. O endereço
localhostse refere ao próprio computador. O IMB não abre o navegador sozinho. Esse processo pode levar alguns segundos.
Após a configuração inicial, a interface web exibe a caixa postal e as pastas de envio e recepção identificadas.

Configuração inicial
Na primeira execução, o IMB prepara a caixa postal para uso, processo chamado de provisionamento.
- Informe o usuário fornecido pelo Itaú;
- Informe a senha de acesso;
- Selecione Configurar.
Importante
Durante esse processo, o IMB configura a caixa postal e gera uma chave SSH, usada na autenticação de conexões seguras, associada à credencial de acesso. Aguarde a conclusão sem interromper a operação.
Atenção
O usuário diferencia letras maiúsculas e minúsculas. Use exatamente o valor recebido do Itaú.

A configuração pode levar alguns segundos para ser concluída.
Teste de conectividade
Após a configuração, valide a comunicação com o Itaú antes de iniciar as operações.
- Abra a interface web;
- Acesse Teste de conectividade;
- Execute o teste.
Para consultar os detalhes do resultado nos logs, registros de eventos da operação:
- Abra Menu>Logs;
- Selecione o arquivo correspondente à data desejada.
O conteúdo do log é aberto no próprio navegador. Consulte o resultado registrado no log para verificar a conexão com o Itaú.

Importante
O IMB gera um arquivo de log por dia e remove automaticamente os registros antigos de acordo com a política de retenção configurada.
Configuração das pastas
Após a configuração inicial, o IMB cria automaticamente a estrutura necessária para envio e recebimento de arquivos. Essa estrutura inclui:
- Pastas de remessa;
- Pastas de retorno;
- Ambientes de Produção e Teste;
- Pastas específicas por produto contratado;
- Pasta para arquivos rejeitados.
Exemplo da estrutura criada pelo IMB para a caixa postal, a partir da pasta de instalação:
- Pasta da caixa postal (por exemplo, ITAUSA);
- Pastas principais: Backup (cópias de segurança), Erro, REMESSA e RETORNO;
- Pastas de Produção (PROD) e Teste (TESTE);
- Pastas dos produtos contratados.




Configurar uma pasta de envio
Acesse Configuração>ITAUSA>Pastas de envio. ITAUSA é o nome de caixa postal usado neste exemplo. Ajuste esse trecho do caminho ao nome da sua caixa postal. Selecione a pasta desejada e ajuste, se necessário:
- Nome de exibição;
- Diretório local de origem;
- Diretório remoto no Itaú;
- Pasta de backup;
- Período de retenção;
- Comando executado após o envio.
Depois das alterações, selecione Salvar.
Dica
A variável $Path é substituída automaticamente pelo diretório de instalação do IMB.
Configurar uma pasta de recepção
Acesse Pastas de recepção e selecione a pasta desejada. Você pode definir:
- Nome de exibição;
- Diretório de destino;
- Caractere de fim de linha;
- Comando executado após a recepção.
Atenção
Altere o caractere de fim de linha apenas para arquivos de texto. Arquivos binários ou criptografados podem ser corrompidos caso a recepção não seja realizada em modo binário, que preserva os dados sem conversão de fim de linha.
Operações principais
Use a interface web para enviar e receber arquivos ou executar todas as transmissões configuradas.
Enviar arquivos
- Selecione a pasta de envio;
- Escolha os arquivos que deseja transmitir;
- Confirme a operação.
Também é possível navegar por outros diretórios e selecionar arquivos manualmente.
Importante
Arquivos com conteúdo ou formato incompatível podem ser movidos para a pasta Arquivos com Erros.
Receber arquivos
Selecione a pasta de retorno e execute a operação de recebimento. O IMB baixa os arquivos disponíveis para aquela configuração.

Enviar e receber tudo
Use a opção Enviar e Receber Tudo para executar, em uma única ação, todas as transmissões configuradas no ambiente.
Automação via linha de comando
Além da interface web, o IMB pode ser operado pela interface de linha de comando (CLI), no terminal.
Configuração automática
No exemplo, SEU_USUARIO e SUA_SENHA representam as credenciais de acesso, não valores reais.
imb autoconfig -user SEU_USUARIO -pwd SUA_SENHASegurança
O parâmetro -pwd recebe a senha na linha de comando. Proteja as credenciais: não salve senhas no histórico do terminal, em scripts, logs ou repositórios. Use ferramentas corporativas de gestão de segredos e valide com a equipe responsável um canal seguro para fornecer a senha ao IMB. Esta documentação não informa uma alternativa ao parâmetro -pwd.
Teste de conexão
imb start -testExecução das transmissões
imb start
imb start -batch job.txt
imb start -daemonInstalação como serviço no Windows
Para que as transmissões ocorram automaticamente no Windows, acesse a pasta de instalação do IMB e execute o arquivo INSTALL_SERVICE como Administrador. O IMB é instalado como um serviço do Windows chamado ItauMailbox, que pode ser consultado na área de Serviços do Windows. Para remover o serviço, use o arquivo REMOVE_SERVICE.

Consultar configuração
imb configConsultar ajuda
imb -?
imb mailbox -?
imb sendfolders -?
imb receivefolders -?Logs e monitoramento
Consulte os registros de operação, acompanhe transmissões e confira informações da instalação e de ajuda na interface web.
Logs
Acesse Menu>Logs para consultar:
- Testes de conectividade;
- Histórico de transmissões;
- Mensagens de erro;
- Eventos operacionais.
O IMB mantém:
- Um arquivo de log por dia;
- Limpeza automática de logs antigos;
- Retenção configurável.

Transmissões
Em Menu>Transmissões, acompanhe as operações em execução.

Sobre
Em Menu>Sobre, consulte informações da instalação, caminhos configurados e versão em uso.

Ajuda
O menu Ajuda apresenta os comandos disponíveis e informações adicionais de operação.

Solução de problemas
Consulte as possíveis causas e as ações recomendadas para os problemas de acesso, conexão e transmissão.
| Problema | Possível causa | O que fazer |
|---|---|---|
| Falha no login | Usuário ou senha incorretos | Revise as credenciais e execute a configuração novamente. |
| Falha no teste de conectividade | Bloqueio de rede ou proxy | Verifique a conectividade e as configurações de proxy. |
| Arquivo enviado para "Arquivos com Erros" | Conteúdo ou formato incompatível | Corrija o arquivo e tente novamente. |
| Arquivo recebido corrompido | Conversão indevida de fim de linha | Configure a recepção em modo binário. |
| Log não encontrado | Arquivo removido pela política de retenção | Ajuste o período de retenção. |
| Interface não abre | Porta 9010 ocupada | Verifique conflitos com outros processos ou regras de firewall, que controlam o tráfego de rede. |
Boas práticas
Recomendações para uso do IMB:
- Mantenha a instalação em um diretório dedicado;
- Configure uma retenção de logs compatível com sua necessidade de auditoria;
- Mantenha o backup dos arquivos enviados habilitado;
- Proteja senhas e credenciais em ferramentas corporativas de gestão de segredos;
- Avalie cuidadosamente comandos de pós-processamento, executados após as operações;
- Acompanhe regularmente a pasta de rejeições;
- Revise periodicamente as credenciais utilizadas pela operação.