Document Delivery by SFTP

🔐 Sending Documents to the Communication Platform via SFTP

Overview

Our Communication Platform supports a secure, scalable way to send documents via SFTP (Secure File Transfer Protocol). This integration is ideal for customers who want to automate and securely transfer outgoing business documents—such as invoices, payslips, or fines—directly from their systems to our processing infrastructure.

This article explains how the SFTP connection works, how it's structured per tenant and workflow, and what you can expect in terms of setup and usage.

💡 What You Need to Know

Each tenant receives a dedicated SFTP user account with a unique key pair.

Navigate to settings / SFTP

For each Workflow created in Communication Platform, a new folder will be made.
Documents should be placed in a specific folder structure:
TenantSlug/WorkflowName/

🔑 Authentication & Access

Each tenant receives:

A dedicated SFTP user (e.g., sftp-user-tenant01)

A key pair for secure access (private key is shared once; store it securely)

Access to a dedicated directory with write permissions only within your own workspace

🔐 Bring Your Own Key (BYOK)

The platform also allows users to bring their own encryption key instead of using the default public key provided by speos. This gives organizations full control over key ownership and management while ensuring all encrypted data uses their chosen key.
 

🔔 Real-Time Processing Trigger (Message Queue)

Every time you drop a file into your SFTP directory:

An AWS SQS message is generated.

The message includes file metadata, triggering the consumer component to process the file according to your configured workflow.

You don’t need to trigger or call any additional API—the system is event-driven and automated.

🔐 Security Best Practices

Store your private key securely; we do not retain it.

Access is limited per tenant using strict directory isolation.

The system is deployed on AWS-hosted infrastructure, using encrypted channels and hardened SFTP settings.

Files are picked up quickly to minimize retention time on the SFTP storage.