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árioProtocolo recomendado
Onboarding padrão de nova empresaSFTP
Automação e integração multiplataformaSFTP
Transmissões ponto a ponto de missão críticaConnect:Direct
Mainframe e sistemas legadosConnect:Direct
Camada extra de criptografia/assinaturaPGP (combinado com SFTP ou Connect:Direct; ver Anexo: PGP)
Sem cliente SFTP disponívelSFTP via IMB

SFTP (SSH File Transfer Protocol)

Recomendado

Visã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

SSH

Criptografia de ponta a ponta.

Autenticação

Duplo fator

Usuário/senha + chave SSH.

Retenção em /RECEIVED

7 dias

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).

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.

Conectividade e firewall

Configure seu cliente SFTP com os parâmetros abaixo:

ParâmetroValor
Caixa PostalEnviada no e-mail de confirmação do cadastro.
UsuárioIgual ao nome da Caixa Postal, enviado no mesmo e-mail.
SenhaGerada automaticamente pelo sistema no cadastro e enviada no e-mail de confirmação.
Host / Servidorportalb2b.itau-unibanco.com.br
Porta22
Chave privada SSHArquivo id_rsa gerado no passo anterior.
Tipo de autenticaçãoUsuá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:

AmbienteIPs a liberar
Desenvolvimento54.232.51.199, 18.229.183.250, 54.207.52.163
Homologação18.231.236.5, 18.231.13.236, 54.94.162.178
Produção52.67.129.162, 18.231.10.44, 54.232.87.129

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}.

PastaDireçãoDescrição
/SEND/{PRODUTO}EnvioArquivos enviados pela empresa ao Itaú.
/RECEIVED/{PRODUTO}RecebimentoArquivos disponibilizados pelo Itaú por até 7 dias. Removidos automaticamente após o download.
/ERROR/{PRODUTO}RejeiçãoArquivos 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ódigoProduto
001Cobrança.
008Pagamentos.
025Conciliaçã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:

  1. Conecte ao servidor SFTP com suas credenciais;
  2. Navegue até /SEND/{PRODUTO};
  3. Faça upload de um arquivo de teste no formato compatível com o produto;
  4. Verifique /RECEIVED/{PRODUTO} para confirmar o retorno;
  5. Se o arquivo não aparecer, consulte /ERROR/{PRODUTO} para identificar a causa da rejeiçã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, lftp ou rsync;
  • 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)

  1. Crie uma chave privada PGP no seu ambiente;
  2. Exporte a chave pública e envie à nossa área de negócios para importação no seu cadastro de usuário;
  3. Baixe a chave pública PGP do Itaú na área de Ferramentas e Downloads e importe no seu ambiente;
  4. Criptografe com a chave pública do Itaú os arquivos que você envia para o banco;
  5. 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.