redb.Route.Sftp 4.2.2

redb.Route.Sftp

SFTP transport for redb.Route. Polling consumer and atomic producer via SSH.NET — key/password auth, proxy, idempotency, glob filtering, temp-file upload, chmod, and recursive directory traversal.

Installation

dotnet add package redb.Route.Sftp

Usage

Fluent DSL

using redb.Route.Sftp.Fluent;

// Poll remote directory
From(Sftp.Directory("/uploads")
        .Host("sftp.example.com").Port(22)
        .Username("user").PrivateKey("/keys/id_rsa")
        .Include("*.xml")
        .Delay(10000)
        .MoveTo("/uploads/archive")
        .Recursive()
        .Idempotent())
    .Log("Downloaded: ${header.CamelFileName}")
    .To("direct://process");

// Upload files atomically
From("direct://export")
    .To(Sftp.Directory("/outgoing")
        .Host("sftp.example.com")
        .Username("user").Password("secret")
        .TempPrefix(".uploading-")
        .Chmod("0644")
        .AutoCreate());

// With proxy
From(Sftp.Directory("/data")
        .Host("internal-sftp")
        .Username("svc")
        .Proxy(ProxyTypes.Http, "proxy.corp.net", 8080)
        .ProxyAuth("proxy-user", "proxy-pass"))
    .To("direct://ingest");

Fluent Builder API

Most builder methods accept both constant values and IExpression for runtime resolution via the expression engine.

Part of

redb.Route — ESB & EIP Framework for .NET

Named connection factory

Keep credentials out of the route URI: register a factory in the context registry and reference it by name. A set-but-unknown name fails loud at startup — a typo can never silently fall back to inline URI parameters.

context.AddToRegistry("prod", new SftpConnectionFactory
{
    Host = "sftp.partner.com",
    Username = "exchange",
    PrivateKeyPath = "/secrets/id_ed25519",
});
// sftp://outbox?connectionFactory=prod

Tracing

As every connector built on redb.Route.GenericFile (see the redb.Route.File README): a root Consumer span, file read sftp, per routed file, none for an empty poll, an error when the route fails; a Producer span per upload, file write sftp, an error when it fails. RouteEngineOptions.EnableTelemetry = false opens neither.