Protocolos e padrões
Protocolos e padrões suportados
| Padrão | Uso no Riversoft STCP DirectLink |
|---|---|
| HTTPS | Transporte do portal, da API e dos serviços HTTP. |
| REST / JSON | Estilo e formato da API (/directlink/v2). |
| HTTP Basic | Login com usuário e senha (somente em /auth/login). |
| OAuth 2.0 (password grant, pode ser desabilitado) | Emissão do token Bearer em /auth/token e /oauth2/token. |
| OAuth 2.0 e 2.1 Token Exchange (RFC 8693) | Troca de um JWT de um provedor confiável por um token Bearer. |
| OAuth 2.0 e 2.1 / OpenID Connect e SAML 2.0 | SSO com Google, Microsoft, Apple e provedores corporativos. |
| JWT | Tokens Bearer emitidos pelo serviço e tokens de origem no token exchange. |
| TOTP | Segundo fator (MFA) por aplicativo autenticador. |
multipart/form-data | Upload com metadados em campos de formulário. |
| SSH/SFTP, FTP/FTPS | Transferência de arquivos com parceiros. |
| AS2 | Troca B2B de documentos com assinatura, criptografia e MDN. |
| OpenTelemetry (OTLP) | Exportação de traces, logs e métricas. |
Serviços de integração
Os serviços recebem as conexões de entrada. São cadastrados nos serviços de rede da instância, no Riversoft Console Portal, com endereço, porta e TLS.
| Serviço | Protocolo | Uso |
|---|---|---|
| API DirectLink | HTTP/HTTPS | Portal, autenticação, MFA, SSO, upload, download, links seguros e relatórios. Veja Riversoft STCP DirectLink API. |
| SFTP DirectLink | SSH/SFTP | O parceiro se conecta para enviar e baixar arquivos. Veja SFTP. |
| AS2 DirectLink | AS2 sobre HTTP/HTTPS | O parceiro envia documentos com assinatura, criptografia e MDN. Veja AS2. |
| Webhook DirectLink | HTTP/HTTPS | O parceiro envia documentos. Veja Webhook. |
| WhatsApp DirectLink | WhatsApp Business Platform | Recebe os documentos que os contatos enviam pelo WhatsApp. Veja WhatsApp. |
| Supervisor DirectLink | Interface de supervisão | Operação administrativa da instância. |
Conectores
Os conectores fazem as conexões de saída: o Riversoft® STCP DirectLink se conecta ao parceiro ou ao repositório, por agendamento ou quando o operador inicia a conexão. O conector, o endereço, as credenciais e os diretórios ficam no cadastro de cada usuário, no Riversoft Console Portal.
| Conector | Protocolo | Operações e recursos |
|---|---|---|
| FTP | FTP/FTPS | Envio e busca; máscara, nome temporário, remoção e backup após a busca, FTPS explícito ou implícito e proxy. Veja FTP e FTPS. |
| SFTP | SSH/SFTP | Envio e busca; senha ou chave privada, fingerprint do servidor, máscara, nome temporário, remoção e backup após a busca e proxy. Veja SFTP. |
| Amazon S3 | S3 e compatíveis | Envio e busca; endpoint próprio, chave de acesso, profile, AssumeRole e IAM Roles Anywhere. Veja Armazenamento em nuvem. |
| Azure Blob Storage | Azure Blob Storage | Envio e busca; Shared Key ou token SAS, containers e prefixos. Veja Armazenamento em nuvem. |
| Google Cloud Storage | GCS | Envio e busca; chave JSON de conta de serviço ou credenciais do ambiente, buckets e prefixos. Veja Armazenamento em nuvem. |
| Oracle Cloud Object Storage | OCI | Envio e busca; chave de API, região, buckets e prefixos. Veja Armazenamento em nuvem. |
| AS2 | AS2 | Envio de documentos com assinatura, criptografia e MDN síncrono ou assíncrono, TLS e proxy. Veja AS2. |
| Webhook | HTTP/HTTPS | Envio de documentos ao endpoint do parceiro com autenticação, assinatura, criptografia, headers customizados, TLS e proxy. Veja Webhook. |
| WhatsApp Business Platform | Envio de documentos e links seguros; nome do arquivo no formato <celular>@<nome-do-arquivo>. Veja WhatsApp. |
Notificações
| Componente | Protocolo | Uso |
|---|---|---|
| SMTP | Login, primeiro acesso, recuperação de senha, PIN, disponibilidade de arquivo e confirmação de transferência. | |
| eSafer, Twilio, Zenvia | API do provedor | SMS. |
| Zendesk | API do provedor | Mensagens e templates. |
| WhatsApp Business API | Templates, mídia, links, botões e PIN. | |
| Bitly | API do provedor | Encurtamento de links. |
Os parâmetros de e-mail, SMS e encurtador estão em Configuração.
Integração com o Riversoft STCP
O Riversoft STCP DirectLink opera integrado ao Riversoft STCP Gemini Server (Linux) ou ao Riversoft STCP Enterprise Server (Windows), de onde vêm os usuários, as credenciais, os diretórios, os serviços e a configuração dos conectores.