Protocolos de transmissão
Compare SFTP e Connect:Direct para transmitir arquivos e consulte o anexo sobre PGP para complementar a proteção.
Escolha o protocolo de transmissão de arquivos entre sua empresa e o Itaú. O portal MFT (Managed File Transfer, ou transmissão gerenciada de arquivos) suporta SFTP e Connect:Direct para diferentes cenários de segurança, integração e desempenho. O PGP, tratado como anexo ao final desta página, pode ser combinado a qualquer um deles para proteger o conteúdo dos arquivos. Para novos clientes, o SFTP é o caminho recomendado.
Escolha rápida
Sou novo cliente do MFT
Use SFTP. É o padrão recomendado, funciona multiplataforma e tem autenticação de duplo fator.
Preciso de mainframe / missão crítica
Use Connect:Direct. Solução IBM Sterling ponto a ponto, com altíssima confiabilidade e SLAs rigorosos.
Preciso reforçar segurança do arquivo
Combine seu protocolo com PGP para criptografia e assinatura digital dos arquivos em trânsito. Detalhes no Anexo: PGP.
Não tenho cliente SFTP
Use o Itaú Mailbox (IMB) sem custo adicional. Ele já traz interface gráfica, linha de comando e duplo fator de autenticação.
Conhecer o Itaú Mailbox| Cenário | Protocolo recomendado |
|---|---|
| Onboarding padrão de nova empresa | SFTP |
| Automação e integração multiplataforma | SFTP |
| Transmissões ponto a ponto de missão crítica | Connect:Direct |
| Mainframe e sistemas legados | Connect:Direct |
| Camada extra de criptografia/assinatura | PGP (combinado com SFTP ou Connect:Direct; ver Anexo: PGP) |
| Sem cliente SFTP disponível | SFTP via IMB |
SFTP (SSH File Transfer Protocol)
RecomendadoVisão geral
O SFTP (SSH File Transfer Protocol) é um protocolo aberto executado sobre SSH, amplamente utilizado para transmissão segura de arquivos em ambientes UNIX/Linux e multiplataforma.
O Itaú mantém dois ambientes SFTP distintos: um para arquivos bancários (CNAB ou similar) e outro para demais arquivos.
Protocolo
Criptografia de ponta a ponta.
Autenticação
Usuário/senha + chave SSH.
Retenção em /RECEIVED
Arquivos são removidos automaticamente após o download.
Dica
Se você não tem uma solução SFTP ou se seu cliente atual não suporta automação ou duplo fator, use o Itaú Mailbox (IMB) sem custo adicional.
Por que o SFTP é o protocolo recomendado
- Padrão aberto e maduro para transmissão segura de arquivos;
- Multiplataforma, com ampla adoção em Linux, UNIX, Windows e macOS;
- Autenticação de duplo fator por padrão (usuário/senha + chave SSH);
- Automação nativa com ferramentas amplamente utilizadas (sftp, lftp, rsync);
- Integração direta com o Itaú Mailbox (IMB) para quem prefere GUI + CLI sem custo adicional.
Quando usar
- Transmissões regulares de arquivos;
- Integração com sistemas Linux/Unix e multiplataforma;
- Requisitos de segurança padrão do mercado, com autenticação forte;
- Onboarding padrão de novos clientes do MFT;
- Automação por scripts, agendadores corporativos ou pipelines.
Pré-requisitos
Antes de começar, confirme que seu ambiente atende a todos os pontos abaixo:
- Software cliente SFTP com suporte a duplo fator (usuário/senha + chave SSH);
- Acesso de rede ao servidor SFTP do Itaú (verifique as regras de firewall);
- VPN ou link dedicado, se aplicável (acione o time de Telecom do Itaú para configuração prévia).
Atenção
Sem duplo fator no cliente SFTP, a conexão não é aceita. Se o seu cliente não suporta duplo fator, use o IMB.
Autenticação e geração da chave SSH
A autenticação é feita com usuário e senha + chave SSH. Sua empresa gera o par de chaves e envia apenas a chave pública ao Itaú.
Exemplo (Linux/macOS):
ssh-keygen -t rsa -b 4096 -C "seu-email@empresa.com"O comando gera dois arquivos:
id_rsa: chave privada. Mantenha em segurança e nunca compartilhe;id_rsa.pub: chave pública SSH. Solicite ao seu Officer Cash e/ou Representante Comercial abertura de solicitação para cadastro da chave na sua Caixa Postal.
Segurança
Nunca envie a chave privada para o Itaú. O banco cadastra apenas a chave pública. Armazene id_rsa em cofre corporativo com controle de acesso.
Conectividade e firewall
Configure seu cliente SFTP com os parâmetros abaixo:
| Parâmetro | Valor |
|---|---|
| Caixa Postal | Enviada no e-mail de confirmação do cadastro. |
| Usuário | Igual ao nome da Caixa Postal, enviado no mesmo e-mail. |
| Senha | Gerada automaticamente pelo sistema no cadastro e enviada no e-mail de confirmação. |
| Host / Servidor | portalb2b.itau-unibanco.com.br |
| Porta | 22 |
| Chave privada SSH | Arquivo id_rsa gerado no passo anterior. |
| Tipo de autenticação | Usuário/senha + chave SSH (duplo fator). |
Host, porta, usuário e senha são enviados por e-mail junto das suas credenciais de acesso. Libere no firewall os IPs do ambiente que sua empresa vai utilizar:
| Ambiente | IPs a liberar |
|---|---|
| Desenvolvimento | 54.232.51.199, 18.229.183.250, 54.207.52.163 |
| Homologação | 18.231.236.5, 18.231.13.236, 54.94.162.178 |
| Produção | 52.67.129.162, 18.231.10.44, 54.232.87.129 |
Firewall
Libere a porta de saída para os IPs do ambiente que sua empresa utilizará. Em ambientes com VPN ou link dedicado, acione o time de Telecom do Itaú.
Estrutura de pastas
O ambiente está configurado para receber cada tipo de arquivo em uma pasta exclusiva por produto. Não é preciso definir os nomes dos arquivos previamente. Arquivos incompatíveis são rejeitados e retornados em /ERROR/{PRODUTO}.
| Pasta | Direção | Descrição |
|---|---|---|
/SEND/{PRODUTO} | Envio | Arquivos enviados pela empresa ao Itaú. |
/RECEIVED/{PRODUTO} | Recebimento | Arquivos disponibilizados pelo Itaú por até 7 dias. Removidos automaticamente após o download. |
/ERROR/{PRODUTO} | Rejeição | Arquivos incompatíveis com a pasta de destino. |
Produtos ({PRODUTO}): identificador com 3 ou mais caracteres alfanuméricos. A tabela abaixo traz alguns exemplos.
Use a pasta SEND para enviar arquivos ao Itaú. Os arquivos disponibilizados pelo Itaú ficam em RECEIVED por até 7 dias e são removidos automaticamente após o download.
| Código | Produto |
|---|---|
| 001 | Cobrança. |
| 008 | Pagamentos. |
| 025 | Conciliação bancária. |
Primeiro envio e validação
Depois de receber as credenciais e cadastrar sua chave pública, valide a conexão ponta a ponta:
- Conecte ao servidor SFTP com suas credenciais;
- Navegue até
/SEND/{PRODUTO}; - Faça upload de um arquivo de teste no formato compatível com o produto;
- Verifique
/RECEIVED/{PRODUTO}para confirmar o retorno; - Se o arquivo não aparecer, consulte
/ERROR/{PRODUTO}para identificar a causa da rejeição.
Importante
Confirme com Implantação Técnica ou com seu representante Itaú que o teste foi bem-sucedido antes de migrar para produção.
Monitoramento de erros
Arquivos enviados para pastas incompatíveis ou que falharem no processamento são movidos automaticamente para /ERROR/{PRODUTO}.
Causas comuns de rejeição:
- Arquivo enviado para pasta de produto incorreta;
- Formato ou layout incompatível com o esperado;
- Nome de arquivo duplicado (já processado anteriormente);
- Arquivo corrompido ou com tamanho zero.
Dica
Implemente monitoramento periódico da pasta /ERROR na sua automação para identificar rejeições rapidamente.
Automação
O SFTP suporta automação de envio e recebimento, desde que seu cliente também ofereça suporte.
Cenários típicos:
- Upload agendado via scripts com
sftp,lftpoursync; - Polling periódico da pasta
/RECEIVED/para baixar novos arquivos; - Alertas automáticos ao detectar arquivos em
/ERROR/.
Nota operacional
Comandos e opções variam por cliente e versão. Valide os padrões com o time responsável antes de colocar em produção.
Integração com o Itaú Mailbox (IMB)
Prefere automação nativa e uma experiência guiada? O Itaú Mailbox (IMB) oferece linha de comando completa e interface gráfica, sem custo adicional.
- Recomendado para empresas que não têm um cliente SFTP compatível com duplo fator ou automação;
- Oferece logs padronizados, execução de comandos pós-transmissão e agenda interna;
- No modelo atual, a chave pública é enviada manualmente para cadastro via Implantação Técnica. O IMB não envia mais chaves automaticamente ao banco.
Dica de DX
Se você já usa SFTP em produção com um cliente compatível, mantenha seu cliente e considere o IMB como plano de contingência ou como referência de operação assistida.
Connect:Direct
Solução IBM Sterling para transmissão segura e automatizada de arquivos corporativos de missão crítica, com alta confiabilidade, rastreabilidade e garantia de entrega entre diferentes plataformas.
Missão crítica
Projetado para operações que exigem alta disponibilidade, integridade dos dados e cumprimento rigoroso de SLAs, suportando processos essenciais de negócio.
Integração multiplataforma
Conecta ambientes Windows, Linux, Unix e z/OS Mainframe, permitindo a troca segura de arquivos entre diferentes tecnologias e arquiteturas corporativas.
Garantia de entrega e transformação de dados
Possui mecanismos de retomada automática, checkpoint/restart, auditoria e monitoramento das transmissões, garantindo que os dados sejam entregues corretamente. Também suporta conversão de formato e características dos arquivos, permitindo que cada sistema receptor receba a informação no padrão adequado ao seu ambiente.
Comunicação ponto a ponto
Opera no modelo peer-to-peer, no qual as duas pontas da comunicação utilizam Connect:Direct para estabelecer transmissões seguras e controladas.
Quando usar
- Integrações de arquivos entre plataformas heterogêneas;
- Comunicação entre ambientes Windows, Linux, Unix e Mainframe;
- Processamentos automatizados em lote (batch);
- Fluxos que exigem garantia de entrega e recuperação automática;
- Processos com requisitos elevados de segurança, rastreabilidade e SLA;
- Integrações corporativas de alta criticidade.
Como funciona
O Connect:Direct estabelece conexões seguras entre dois ambientes que possuam o software instalado. Durante a transmissão, controla a entrega dos arquivos, registra auditoria completa do processo e garante a recuperação automática em caso de falhas de comunicação ou interrupções.
Requisitos necessários
- Criação de VPN ou Internet para uso ponta a ponta;
- IP;
- Porta;
- Usuário do proxy;
- Node Name;
- Uso de certificado Secure Plus.
Estrutura de pastas para envio de arquivo
mailbox/{CAIXAPOSTAL}/REMESSA/PROD/{PRODUTO}
mailbox/{CAIXAPOSTAL}/REMESSA/TESTE/{PRODUTO}
mailbox/{CAIXAPOSTAL}/RETORNO/PROD/{PRODUTO}
mailbox/{CAIXAPOSTAL}/RETORNO/TESTE/{PRODUTO}{CAIXAPOSTAL}: até 15 caracteres alfanuméricos que representam o nome do seu usuário de acesso na plataforma de transmissão do Itaú.
Anexo: PGP para criptografia de arquivos
Este anexo complementa os protocolos desta página. O PGP não é um protocolo de transmissão: é uma camada extra de segurança para o conteúdo dos arquivos. Use combinado ao seu protocolo de transporte (SFTP ou Connect:Direct).
O PGP (Pretty Good Privacy) é um software que criptografa e descriptografa arquivos, geralmente por linha de comando. Também suporta assinatura digital.
Como funciona (5 passos)
- Crie uma chave privada PGP no seu ambiente;
- Exporte a chave pública e envie à nossa área de negócios para importação no seu cadastro de usuário;
- Baixe a chave pública PGP do Itaú na área de Ferramentas e Downloads e importe no seu ambiente;
- Criptografe com a chave pública do Itaú os arquivos que você envia para o banco;
- Os arquivos que você recebe do Itaú vêm criptografados com a sua chave pública. Use a sua chave privada para descriptografá-los.
Algoritmos suportados
RSA_GENERAL, RSA_SIGN, ELGAMAL_GENERAL, ECDSA, DSA.
Validade das chaves
- Chaves PGP têm validade;
- Gere uma nova chave com antecedência e envie ao Itaú pelo menos um mês antes do vencimento da atual;
- O Itaú também atualiza suas chaves periodicamente. Você recebe aviso por e-mail para baixar a nova chave pública no portal e importar no seu ambiente.
Segurança
PGP protege o conteúdo do arquivo, não a conexão. Ele complementa (não substitui) o transporte seguro por SFTP ou Connect:Direct.