Protocols and standards
Supported protocols and standards
| Standard | Use in Riversoft STCP DirectLink |
|---|---|
| HTTPS | Transport for the portal, the API and the HTTP services. |
| REST / JSON | API style and format (/directlink/v2). |
| HTTP Basic | Sign-in with user name and password (only on /auth/login). |
| OAuth 2.0 (password grant, can be disabled) | Bearer token issuance on /auth/token and /oauth2/token. |
| OAuth 2.0 and 2.1 Token Exchange (RFC 8693) | Exchange of a JWT from a trusted provider for a Bearer token. |
| OAuth 2.0 and 2.1 / OpenID Connect and SAML 2.0 | SSO with Google, Microsoft, Apple and corporate providers. |
| JWT | Bearer tokens issued by the service and source tokens in token exchange. |
| TOTP | Second factor (MFA) through an authenticator app. |
multipart/form-data | Upload with metadata in form fields. |
| SSH/SFTP, FTP/FTPS | File transfer with partners. |
| AS2 | B2B document exchange with signing, encryption and MDN. |
| OpenTelemetry (OTLP) | Export of traces, logs and metrics. |
Integration services
Services receive the inbound connections. They are registered in the instance network services, in the Riversoft Console Portal, with address, port and TLS.
| Service | Protocol | Use |
|---|---|---|
| DirectLink API | HTTP/HTTPS | Portal, authentication, MFA, SSO, upload, download, secure links and reports. See Riversoft STCP DirectLink API. |
| SFTP DirectLink | SSH/SFTP | The partner connects to upload and download files. See SFTP. |
| AS2 DirectLink | AS2 over HTTP/HTTPS | The partner sends documents with signature, encryption and MDN. See AS2. |
| Webhook DirectLink | HTTP/HTTPS | The partner sends documents. See Webhook. |
| WhatsApp DirectLink | WhatsApp Business Platform | Receives the documents contacts send through WhatsApp. See WhatsApp. |
| DirectLink Supervisor | Supervision interface | Administrative operation of the instance. |
Connectors
Connectors make the outbound connections: Riversoft® STCP DirectLink connects to the partner or repository, by schedule or when the operator starts the connection. The connector, address, credentials and directories are in each user’s registration, in the Riversoft Console Portal.
| Connector | Protocol | Operations and features |
|---|---|---|
| FTP | FTP/FTPS | Send and fetch; mask, temporary name, removal and backup after fetching, explicit or implicit FTPS and proxy. See FTP and FTPS. |
| SFTP | SSH/SFTP | Send and fetch; password or private key, server fingerprint, mask, temporary name, removal and backup after fetching and proxy. See SFTP. |
| Amazon S3 | S3 and compatible | Send and fetch; custom endpoint, access key, profile, AssumeRole and IAM Roles Anywhere. See Cloud storage. |
| Azure Blob Storage | Azure Blob Storage | Send and fetch; Shared Key or SAS token, containers and prefixes. See Cloud storage. |
| Google Cloud Storage | GCS | Send and fetch; service account JSON key or environment credentials, buckets and prefixes. See Cloud storage. |
| Oracle Cloud Object Storage | OCI | Send and fetch; API key, region, buckets and prefixes. See Cloud storage. |
| AS2 | AS2 | Sending documents with signature, encryption and synchronous or asynchronous MDN, TLS and proxy. See AS2. |
| Webhook | HTTP/HTTPS | Sending documents to the partner endpoint with authentication, signature, encryption, custom headers, TLS and proxy. See Webhook. |
| WhatsApp Business Platform | Sending documents and secure links; file name in the <mobile>@<file-name> format. See WhatsApp. |
Notifications
| Component | Protocol | Use |
|---|---|---|
| SMTP | Sign-in, first access, password recovery, PIN, file availability and transfer confirmation. | |
| eSafer, Twilio, Zenvia | Provider API | SMS. |
| Zendesk | Provider API | Messages and templates. |
| WhatsApp Business API | Templates, media, links, buttons and PIN. | |
| Bitly | Provider API | Link shortening. |
The email, SMS and shortener parameters are in Configuration.
Integration with Riversoft STCP
Riversoft STCP DirectLink works integrated with Riversoft STCP Gemini Server (Linux) or Riversoft STCP Enterprise Server (Windows), which provide the users, credentials, directories, services and connector configuration.