FTPS file source

Use the FTPS file source to check a secure file server for new files and publish each matching file to a SQIP topic.

Info

This connector uses FTPS, which encrypts the connection. Plain FTP and anonymous access are not supported.

Before you begin

Ask the file server owner for:

The FTPS hostname and port.
Your username and password.
The absolute remote directory path.
The filename pattern for files SQIP should import.
The server's timezone.

Files should use names that sort in the same order they are produced, such as orders-20260903T120000Z-0001.csv. The producer should finish uploading a file before giving it its final matching name.

Install the connector

Select the connector

In Connectors, find FTPS File Source and select Select and install.

Choose the output

Enter an installation name, select the tenant, cluster, and namespace, and choose the output topic that will receive the files.

Configure the file server

Enter the hostname, directory, filename pattern, and limits using the table below.

Add credentials

Enter or select the FTPS username and password in SQIP's credential section.

Install and verify

Select Install connector and wait for Running. Place one complete matching file in the remote directory and confirm it appears in the output topic.

Configuration fields

Field	What to enter	Example	Required
Host	The FTPS server's DNS hostname, without `ftp://` or a path	`files.example.com`	Yes
Port	The FTPS control port	`21`	No
Remote Directory	The full server directory beginning with `/`	`/exports/orders`	Yes
File Name Pattern	A filename filter using `*` for any characters and `?` for one character	`orders-*.csv`	No; defaults to `*`
Start After File Name	Skip this file and all names that sort before it; leave blank to start from the beginning	`orders-20260901T000000Z-0001.csv`	No
Poll Interval Ms	How often SQIP checks the directory	`30000`	No
Minimum File Age Ms	How old a file must be before SQIP imports it	`60000`	No
Connect Timeout Ms	How long SQIP waits to connect	`10000`	No
Data Timeout Ms	How long SQIP waits while listing or downloading	`30000`	No
Max File Bytes	Largest file SQIP may import, in bytes	`10485760` (10 MiB)	No
Max Files Per Poll	Largest number of files imported during one check	`100`	No
Max Directory Entries	Largest directory listing SQIP accepts	`10000`	No
Server Time Zone	The server's IANA timezone	`UTC`	No
Parallelism	Number of connector instances	`1`	Yes; fixed at `1`

Enter the FTPS Username and Password under One-time credentials. If your administrator supplied a prepared secret name, expand Use an existing secret reference instead and enter that name. Do not use both approaches.

Filename pattern examples

Pattern	Matches
`*`	Every filename
`*.csv`	Every CSV file
`orders-*.csv`	CSV files beginning with `orders-`
`orders-2026-??.csv`	Two-character suffixes such as `orders-2026-09.csv`

Warning

Choose Start After File Name carefully. Files with names equal to or alphabetically before this value will not be imported. Leave it blank for a new directory unless you intentionally need to skip older files.

Recommended starter values

Field	Input
Port	`21`
File Name Pattern	`orders-*.csv`
Start After File Name	Leave empty
Poll Interval Ms	`30000`
Minimum File Age Ms	`60000`
Connect Timeout Ms	`10000`
Data Timeout Ms	`30000`
Max File Bytes	`10485760`
Max Files Per Poll	`100`
Max Directory Entries	`10000`
Server Time Zone	`UTC`

If installation fails

Enter only the hostname in Host; do not include a protocol, port, or directory.
Confirm that Remote Directory starts with / and that your account can list and read it.
Confirm that the server supports FTPS and that your organization trusts its certificate.
Confirm that the filename pattern matches the exact capitalization of uploaded files.
If the server is private, ask your SQIP administrator to approve access.