Saltar para o conteúdo

AS2

O Riversoft® STCP DirectLink troca documentos com parceiros por AS2 (Applicability Statement 2), o padrão B2B de troca sobre HTTP/HTTPS com assinatura digital, criptografia e confirmação de entrega (MDN). Cada lado da troca tem um papel:

ComponenteQuem inicia a conexãoFunção
Conector AS2O Riversoft STCP DirectLink (conexão de saída)Envia documentos ao servidor AS2 do parceiro e recebe o MDN síncrono.
Serviço AS2 DirectLinkO parceiro (conexão de entrada)Recebe os documentos que o parceiro envia, responde com o MDN e recebe os MDNs assíncronos dos documentos enviados pelo conector.

No AS2, cada conexão leva os documentos em um único sentido. Para que o parceiro também envie documentos, ele se conecta ao serviço AS2 DirectLink.

Conexões de saída (conector AS2)

    flowchart LR
    subgraph DL[Riversoft STCP DirectLink]
      SA["Diretório saida"]
      C[Conector AS2]
    end
    SA --> C
    C -->|documento| P[Servidor AS2 do parceiro]
    P -.->|MDN síncrono| C
  

O Riversoft STCP DirectLink envia ao parceiro os documentos disponíveis na caixa postal do usuário (diretório saida), por agendamento ou quando o operador inicia a conexão no Riversoft Console Portal.

RecursoComportamento
DocumentoPode ser assinado, criptografado e comprimido, conforme combinado com o parceiro.
MDNConfirmação de entrega pedida ao parceiro: síncrona (na resposta da própria conexão) ou assíncrona (enviada depois ao serviço AS2 DirectLink). O MDN pode ser assinado e criptografado.
AutenticaçãoNenhuma, Basic ou Bearer, conforme exigido pelo servidor do parceiro.
TLSValidação do certificado do servidor, CA própria e certificado de cliente (mTLS).
RedeA conexão pode sair por um proxy e por um endereço local específico.

O conector AS2 só envia documentos: ele não lista nem busca arquivos no parceiro.

Conexões de entrada (serviço AS2 DirectLink)

    flowchart LR
    subgraph DL[Riversoft STCP DirectLink]
      S[Serviço AS2 DirectLink]
      EN["Diretório entrada"]
    end
    Q[Cliente AS2 do parceiro] -->|documento / MDN assíncrono| S
    S --> EN
    S -.->|MDN| Q
  

O parceiro envia documentos ao endereço do serviço AS2 DirectLink. Cada documento é validado, gravado no diretório entrada da caixa postal do usuário e respondido com o MDN, conforme pedido pelo parceiro. O mesmo serviço recebe os MDNs assíncronos dos documentos que o Riversoft STCP DirectLink enviou.

AutenticaçãoValidação
NenhumaSem credencial HTTP. Use somente quando a troca for protegida por assinatura e mTLS.
BasicUsuário e senha do Riversoft STCP DirectLink.
BearerSomente token de impersonação registrado para o usuário.

Além da credencial, o destinatário da mensagem (AS2-To) precisa corresponder à identificação AS2 cadastrada para o usuário.

O serviço AS2 DirectLink é cadastrado nos serviços de rede da instância, no Riversoft Console Portal: endereço, porta, TLS e o endereço público do serviço.

O que combinar com o parceiro

ItemDescrição
Identificações AS2AS2 ID do Riversoft STCP DirectLink e AS2 ID do parceiro.
EndereçosURL do servidor AS2 do parceiro e URL pública do serviço AS2 DirectLink, inclusive para os MDNs assíncronos.
CertificadosTroca dos certificados de assinatura e de criptografia dos dois lados, e os algoritmos usados.
Opções do documentoAssinado, criptografado e comprimido, no envio e no recebimento.
MDNSíncrono ou assíncrono, assinado ou não.
Autenticação HTTPBasic ou Bearer, quando exigida.

Esses dados são cadastrados no usuário, no Riversoft Console Portal.

Segurança

  • Assine e criptografe os documentos e peça MDN assinado: assim a troca tem comprovação de entrega e não repúdio.
  • Publique o serviço AS2 DirectLink somente por HTTPS e, sempre que possível, exija mTLS do parceiro.
  • Renove os certificados antes do vencimento e combine a troca com o parceiro com antecedência.
  • Veja os algoritmos suportados em Segurança: AS2.