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.

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:

Instalação

Baixe o instalador, extraia os arquivos e execute o IMB no seu sistema operacional.

  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 selecione Extrair.

    Exemplo de extração dos arquivos de instalação do IMB

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

    Referência do conteúdo da pasta de instalação do IMB após a extração
  3. Execute o IMB

    Na pasta de instalação, execute:

    Windows

    imb.exe

    Linux ou macOS

    imb

    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 localhost se refere ao próprio computador. O IMB não abre o navegador sozinho. Esse processo pode levar alguns segundos.

    Referência da inicialização do IMB no terminal e do acesso à interface web

    Após a configuração inicial, a interface web exibe a caixa postal e as pastas de envio e recepção identificadas.

    Referência da interface web do IMB após a configuração inicial

Configuração inicial

Na primeira execução, o IMB prepara a caixa postal para uso, processo chamado de provisionamento.

  1. Informe o usuário fornecido pelo Itaú;
  2. Informe a senha de acesso;
  3. Selecione Configurar.
Referência da configuração inicial do IMB com usuário e senha

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 nos logs, registros de eventos da operação:

  1. Abra Menu>Logs;
  2. Selecione o arquivo correspondente à data desejada.
Referência da execução do teste de conectividade do IMB Referência do resultado do teste de conectividade do IMB

O conteúdo do log é aberto no próprio navegador. Consulte o resultado registrado no log para verificar a conexão com o Itaú.

Referência da consulta do resultado de conexão no arquivo de log

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 (cópias de segurança), Erro, REMESSA e RETORNO;
  3. Pastas de Produção (PROD) e Teste (TESTE);
  4. Pastas dos produtos contratados.
Referência da pasta da caixa postal na instalação do IMB
Referência das pastas principais da caixa postal
Referência das pastas de remessa de Produção e Teste
Referência das 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.

Referência do acesso à configuração de pasta de envio no IMB Referência dos ajustes de pasta de envio no IMB

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.
Referência do acesso à configuração de pasta de recepção no IMB Referência dos ajustes de pasta de recepção no IMB

Operações principais

Use a interface web para enviar e receber arquivos ou executar todas as transmissões configuradas.

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.

Referência do acesso ao envio manual de arquivos no IMB Referência da operação de envio manual de arquivos no IMB

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.

Referência da recepção manual de arquivos no IMB

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.

Referência da opção Enviar e Receber Tudo no IMB Referência do resultado da opção Enviar e Receber Tudo no IMB

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_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 é 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.

Referência da consulta do serviço ItauMailbox no Windows

Consultar configuração

imb config

Consultar 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.
Referência da consulta pelo menu Logs do IMB

Transmissões

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

Referência da consulta pelo menu Transmissões do IMB

Sobre

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

Referência da consulta pelo menu Sobre do IMB

Ajuda

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

Referência da consulta pelo menu Ajuda do IMB

Solução de problemas

Consulte as possíveis causas e as ações recomendadas para os problemas de acesso, conexão e transmissão.

ProblemaPossível causaO que fazer
Falha no loginUsuário ou senha incorretosRevise as credenciais e execute a configuração novamente.
Falha no teste de conectividadeBloqueio de rede ou proxyVerifique a conectividade e as configurações de proxy.
Arquivo enviado para "Arquivos com Erros"Conteúdo ou formato incompatívelCorrija o arquivo e tente novamente.
Arquivo recebido corrompidoConversão indevida de fim de linhaConfigure a recepção em modo binário.
Log não encontradoArquivo removido pela política de retençãoAjuste o período de retenção.
Interface não abrePorta 9010 ocupadaVerifique 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.