Notas de versão

A Riversoft® STCP DirectLink API faz parte do Riversoft STCP DirectLink e segue as mesmas versões. As notas abaixo valem para os dois.

9.0.1 — novembro de 2026

Configuração operacional da instância, JWT, SSO e lock externo carregados do banco de configuração e administrados no Riversoft Console Portal.
Sessão do Riversoft STCP DirectLink Portal mantida no cookie seguro __Host-dirl_session (HttpOnly, Secure, SameSite=Strict).
Token exchange com validação do JWT de origem pelo provedor informado no campo provider ou no header X-STCPDIRECTLINK-JWT-ISSUER.
Token de impersonação de longa duração para integrações técnicas, gerado na interface de supervisão.
Verificação opcional do Cloudflare Turnstile no login, no primeiro acesso e na recuperação de senha.

Endpoints /auth/token e /oauth2/token equivalentes, com emissão de tokens por password grant ou token exchange, conforme os modos habilitados.
Validação da identidade: o usuário identificado pelas credenciais ou claims precisa existir e corresponder ao perfil carregado da configuração.
Validação do host: a API rejeita com 403 chamadas feitas por um host diferente do configurado para o serviço.

A API passa para a versão v2, com o prefixo /directlink/v2. A versão v1 não é mais atendida: os clientes devem passar a usar a v2. Veja Migração da API v1 para a v2.
O download de arquivos listados (/download/file e /download/file/backup) exige o token Bearer ou o cookie de sessão do mesmo usuário que fez a listagem. O link compartilhado (/download) não muda.
/auth/change aceita somente POST, com a nova senha no corpo do formulário.
O campo time das respostas da API passa a usar o formato ISO 8601 (RFC 3339), por exemplo 2026-11-07T14:03:21-03:00. Integrações que leem esse campo no formato anterior precisam ser ajustadas.
As rotas protegidas (upload, listagens, relatório e logout) exigem token Bearer e deixam de aceitar Basic. Basic continua aceito somente em /auth/login.
Os parâmetros oauthTokenMethodJWT, oauthTokenExpireSeconds, lockProvider.lockType e ssoProviders[] saem do config.json e passam para a configuração da instância no banco.

Com o download desabilitado no serviço, as rotas de download de arquivo listado respondem 403 e encerram o pedido.

Atenção

A atualização da versão 8 para a versão 9 exige migração da configuração e adequação das integrações. Veja Migração da versão 8 para a versão 9 e Impacto nas integrações.

Conector Webhook, nos modos servidor e cliente, com as configurações de controle do webhook.
Criptografia opcional do MDN no envio e na recepção AS2, configurável por usuário.
Token para autenticação do usuário por Bearer nos serviços de API, Webhook e AS2.
Conexão TLS com o banco de dados MySQL.
Variável $DIRINSTANCE.
Vários usuários em uma mesma agenda.
Distribuição única para Enterprise Linux 8, 9 e 10.

Parâmetro tls-cipher e separador : entre os algoritmos, compatíveis com a biblioteca libmysqlclient, nas conexões com os bancos de configuração, de autenticação e de administração.

Usuário autenticado no SFTP Server ao informar senha vazia.
Tratamento do DSN na conexão com os bancos de configuração, de administração, de autenticação e de log.
Tratamento do MDN com erro no AS2.
Content-Type em branco no AS2 quando a extensão do arquivo não está definida no mime.types.
Erro na comparação do MIC quando o algoritmo é informado com a nomenclatura antiga sha256 em vez de sha-256.
Erro no tratamento do MDN de erro enviado pelo Amazon AS2.
Erro na verificação da assinatura application/pkcs7-signature quando ela usa Content-Transfer-Encoding binário.
Erro na validação da assinatura pkcs7-signature com o Amazon AS2, causado pela canonização incorreta do conteúdo da mensagem.
Arquivos de lock não removidos quando a aplicação é interrompida.
Nome do arquivo de lock compatível com o Riversoft STCP Gemini.
Recepção ou transmissão no modo cliente do SFTP não interrompida quando a conexão é cancelada.
Mensagem de protocolo inválido registrada no log de sistema.

Tratamento, no SFTP Server, de chaves que não usam o algoritmo RSA.
Formatação de diretórios no SFTP em operações de download.
Formatação do nome do arquivo remoto nas comunicações por SFTP, FTP e Object Storage.

Módulo de comunicação FTP/FTPS, integrado ao Riversoft STCP DirectLink.
Integração com OpenTelemetry, com configuração de traces, métricas e logs na inicialização da aplicação.
Autenticação 2FA no protocolo SFTP.
Tratamento de MFA no serviço SFTP Server.

Timestamp das mensagens na console sem a indicação de fuso horário.
Identificação do primeiro acesso de novos usuários.
Cliente FTP que removia o arquivo do servidor remoto mesmo com a opção de exclusão desabilitada.
Falha no envio de arquivos pelo SFTP Client para o AWS Transfer.
Aplicação que não era encerrada corretamente com CTRL-C ou com o comando exit no modo console.
Erro de memória ao executar CTRL-C.

Autenticação passa a bloquear o acesso quando o domínio não está configurado no LDAP, evitando o uso indevido da autenticação pelo banco de dados.
Falha no login com autenticação LDAP.

Opção para gravar os eventos de debug em arquivo, em substituição à console ou ao Event Viewer.
Opção para habilitar ou desabilitar a verificação da existência do bucket na comunicação S3.
Opção para remover o arquivo da pasta de entrada na recepção pela API (upload) quando o usuário de destino é informado no roteamento implícito.

Interrupção da aplicação em cenários com várias comunicações SFTP.
Interrupção da aplicação no acesso simultâneo ao mapa de controle de transferência.
Envio do link por e-mail em transferências pelo portal (upload).

Integração dos módulos AS2 Server e AS2 Client ao núcleo da aplicação, com suporte completo ao recebimento de arquivos nos diferentes cenários de criptografia, assinatura e MDN.
Suporte a MDN assíncrono, incluindo envio, recepção e tratamento de erros.
Parâmetros de configuração de usuário para o protocolo AS2 e leitura dessas configurações no recebimento de mensagens.
Tratamento de mensagens com codificação BER.
Tratamento do MIC em mensagens AS2 recebidas com criptografia e compressão.
Controle dos algoritmos aceitos para assinatura, criptografia e cálculo do MIC no AS2.
Validação de certificados TLS (cliente e servidor) nas conexões AS2.
Parâmetros para definir as opções exigidas na recepção de documentos (assinatura, criptografia e compressão).
Envio de headers personalizados por conexão e por tipo de arquivo no AS2.
Tratamento de endereço local e proxy na conexão de saída.
Eventos de notificação para início e fim de sessão, início e fim de recepção de documentos e eventos de log.
Log das requisições HTTP/HTTPS com o status da resposta.
Tratamento de timeout nas conexões cliente e servidor.

Mensagens de log de erro do AS2 Server.
Parâmetro de assinatura alterado de SIGN para SIGN_MULTIPART nas configurações de envio e de obrigatoriedade de documentos.