Antes de começar

Antes de iniciar a instalação, 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.

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;
• Configuração de proxy corporativo, quando aplicável.

Como configurar o Itaú Mailbox

O processo de configuração é dividido em cinco etapas:

1. Instalação;
2. Configuração inicial;
3. Teste de conectividade;
4. Configuração das pastas;
5. Operação e automação.

Instalação

1. Baixe o instalador

Acesse a área de Ferramentas e Downloads e baixe a versão compatível com seu sistema operacional.

2. Extraia os arquivos

Extraia o conteúdo para um diretório dedicado. Exemplos:

Windows

C:\itau\imb

Linux ou macOS

/home/usuario/itau/imb

No Windows, clique com o botão direito no arquivo baixado, escolha Extrair tudo, informe a pasta de destino e clique em Extrair.

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

3. Execute o IMB

Na pasta de instalação, execute:

Windows

imb.exe

Linux ou macOS

imb

cd /Users/usuario/itau/imb
chmod +x imb
./imb

Ao ser iniciado, o IMB informa no terminal o endereço da interface web. O IMB não abre o navegador sozinho: para acessar a interface gráfica, abra http://localhost:9010 no navegador ou use o atalho IMB disponível na pasta de instalação. 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 realiza o provisionamento da caixa postal.

1. Informe o usuário fornecido pelo Itaú;
2. Informe a senha de acesso;
3. Clique em Configurar.

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.

1. Abra a interface web;
2. Acesse Teste de conectividade;
3. Execute o teste.

Para consultar os detalhes do resultado:

1. Abra Menu > Logs;
2. Selecione o arquivo correspondente à data desejada.

O conteúdo do log é aberto no próprio navegador. O trecho destacado na imagem indica sucesso na conexão com o Itaú.

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:

1. Pasta da caixa postal (por exemplo, ITAUSA);
2. Pastas principais: Backup, Erro, REMESSA e RETORNO;
3. Pastas de Produção (PROD) e Teste (TESTE);
4. Pastas dos produtos contratados.

Configurar uma pasta de envio

Acesse Configuração > ITAUSA > Pastas de envio. 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, clique em Salvar.

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.

Operações principais

Enviar arquivos

1. Selecione a pasta de envio;
2. Escolha os arquivos que deseja transmitir;
3. Confirme a operação.

Também é possível navegar por outros diretórios e selecionar arquivos manualmente.

Receber arquivos

Selecione a pasta de retorno e execute a operação de recebimento. O IMB fará o download dos 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 CLI.

Configuração automática

imb autoconfig -user SEU_USUARIO -pwd SUA_SENHA

Teste de conexão

imb start -test

Execução das transmissões

imb start
imb start -batch job.txt
imb start -daemon

Instalaçã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 será 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, utilize o arquivo REMOVE_SERVICE.

Consultar configuração

imb config

Consultar ajuda

imb -?
imb mailbox -?
imb sendfolders -?
imb receivefolders -?

Logs e monitoramento

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

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;
• Acompanhe regularmente a pasta de rejeições;
• Revise periodicamente as credenciais utilizadas pela operação.