> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CSV SFTP Advanced Security Connector

## Intro

A character-separated values (CSV) file stores tabular data in plain-text form. Domo provides connectors that allow you to access CSV files you have uploaded to an SFTP (Secure File Transfer Protocol) server:

* The Domo CSV SFTP Pull connector (formerly called the "CSV-SFTP" connector) allows you to access CSV files that you have uploaded to your own SFTP server.
* The Domo CSV SFTP Advanced Security connector allows you to access CSV files from a directory or a zip file that you have uploaded to your own SFTP server.
* The Domo CSV SFTP Push connector allows you to capture and process CSV files that have been uploaded to Domo's own SFTP. With this connector, Domo gives you credentials, then you push your data to Domo.

This article discusses the **CSV SFTP Advanced Security** connector. For information about the CSV SFTP Push connector, visit [CSV SFTP Push Connector](/s/article/360042931914 "CSV SFTP Push Connector").

The CSV SFTP Advanced Security connector is a "File" connector, meaning it retrieves files and output them to Domo. In the Data Center, you can access the connector page for this and other File connectors by clicking ****File**** in the toolbar at the top of the window.

You connect to CSV files in the Data Center. This topic discusses the fields and menus that are specific to the CSV SFTP Advanced Security connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

## Prerequisites

To authenticate to the SFTP server, you must have the following:

* SFTP Host name
* SFTP Port number
* SFTP Server Username
* Public Key

##### To obtain your Public Key:

* Enter the host name, port number, and SFTP server username then click
  **Generate Key**.
* Copy the Public key on to the SFTP server.

You must also whitelist the IP addresses from the following article on the server: [Whitelisting IP Addresses for Connectors](/s/article/360043630093 "Whitelisting IP Addresses for Connectors").

## Connecting to CSV Files

This section enumerates the options in the ****Credentials**** and ****Details**** panes for the CSV SFTP Advanced Pull connector. The components of the other panes in this page, ****Scheduling**** and ****Name & Describe Your DataSet****, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

### Credentials Pane

This pane contains fields for entering credentials to connect to your SFTP server. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:201;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"> Host </td><td colspan="1" rowspan="1"> Enter the name of the SFTP host you want to connect to. This <em> must </em> begin with sftp\://. For example: <a target="_blank" title="sftp://hostname"> sftp\://hostname </a>. </td></tr><tr><td colspan="1" rowspan="1"> Port </td><td colspan="1" rowspan="1"> Enter the port number for your SFTP server. </td></tr><tr><td colspan="1" rowspan="1"> Username </td><td colspan="1" rowspan="1"> Enter the username you use to authenticate to the SFTP server. </td></tr></tbody></table>

After entering the host, port, and username, click the **Generate Key** button. Copy your **Public Key** to the SFTP server.

Looking to upload a CSV file but do not have an SFTP server? Take a look at our [Workbench solution](/s/article/360043437233 "Box Connector") available for download in your Domo instance.

### Details Pane

In this pane you choose a CSV report from the SFTP server you've connected to.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:201;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"> How Would You Like To Choose Your Directory? </td><td colspan="1" rowspan="1"> Select how would you like to choose the directory. </td></tr><tr><td colspan="1" rowspan="1"> Directory </td><td colspan="1" rowspan="1"> Select the directory that contains the file you want to access. </td></tr><tr><td colspan="1" rowspan="1"> Enter Directory </td><td colspan="1" rowspan="1"> Enter the directory path. </td></tr><tr><td colspan="1" rowspan="1"> File Type </td><td colspan="1" rowspan="1"> Select the file type of the file selected from the directory. </td></tr><tr><td colspan="1" rowspan="1"> Filter Your CSV File </td><td colspan="1" rowspan="1"> You can select the below options to filter your CSV file. <br /><ul><li><b> Select file - </b> You can filter from the available CSV files using the <b> Select CSV File Name </b> field. </li><li><b> Enter file name – </b> You can enter the name of the specific CSV file you want to filter using the <b> Enter </b><b> CSV File Name </b> field. </li><li><b> All matching files - </b> Filters out all the matching CSV files. </li></ul></td></tr><tr><td colspan="1" rowspan="1"> Select CSV File Name </td><td colspan="1" rowspan="1"> Select the CSV file name from the drop-down list. </td></tr><tr><td colspan="1" rowspan="1"> Enter CSV File Name </td><td colspan="1" rowspan="1"> Enter the file name. </td></tr><tr><td colspan="1" rowspan="1"> File Extension </td><td colspan="1" rowspan="1"> You can either enter csv or txt and search for files with the.csv or.txt extension. This is an optional field. </td></tr><tr><td colspan="1" rowspan="1"> Partial/ Complete CSV File Name </td><td colspan="1" rowspan="1"> Enter the CSV file name you want to match and filter using the <b> File Name Match Criteria </b> field. </td></tr><tr><td colspan="1" rowspan="1"> File Name Match Criteria </td><td colspan="1" rowspan="1"> Select the match criteria to filter out the CSV files. <br /><ul><li><b> Exact Match - </b> Filters for the exact CSV file(s) that match the same file name entered in the <b> Partial/ Complete CSV File Name </b> field. </li><li><b> Contains - </b> Filters the CSV file(s) which contains the file name entered in the <b> Partial/ Complete CSV File Name </b> field. </li><li><b> Starts With - </b> Filters the CSV file(s) that starts with the file name entered in the <b> Partial/ Complete CSV File Name </b> field. </li><li><b> Ends With - </b> Filters the CSV file(s) that ends with the file name entered in the <b> Partial/ Complete CSV File Name </b> field. </li><li><b> Regular Expression - </b> Filters for a regular expression. For more information refer <a href="https://en.wikipedia.org/wiki/Regular_expression" target="_blank" title="Regular expression"> Regular expression </a>. </li></ul></td></tr><tr><td colspan="1" rowspan="1"> Match Case Sensitive </td><td colspan="1" rowspan="1"> Select this checkbox if you want to filter the CSV file(s) that matches the case sensitive of the entered file name. </td></tr><tr><td colspan="1" rowspan="1"> Filter Your ZIP File </td><td colspan="1" rowspan="1"> You can select the below options to filter your Zip file. <br /><ul><li><b> Select file - </b> You can filter from the available ZIP file(s) using the <b> Select ZIP File </b> field. </li><li><b> Enter file name - </b> You can enter the name of the specific ZIP file you want to filter using the <b> Enter ZIP File Name </b> field. </li><li><b> All matching files - </b> Filters out all the matching ZIP file(s). </li></ul></td></tr><tr><td colspan="1" rowspan="1"> Select ZIP File </td><td colspan="1" rowspan="1"> Select a CSV file to parse from the unzip folder. </td></tr><tr><td colspan="1" rowspan="1"> Enter ZIP File Name </td><td colspan="1" rowspan="1"> Enter a file name to parse from the zip archive. </td></tr><tr><td colspan="1" rowspan="1"> Partial/ Complete ZIP File Name </td><td colspan="1" rowspan="1"> Enter the ZIP file name that you want to match and filter using the <b> ZIP File Name Match Criteria </b> field. </td></tr><tr><td colspan="1" rowspan="1"> Zip File Name Match Criteria </td><td colspan="1" rowspan="1"> Select the match criteria to filter for the ZIP files. <br /><ul><li><b> Exact Match - </b> Filters for the exact ZIP file(s) that match the same file name entered in the <b> Partial/ Complete ZIP File Name </b> field. </li><li><b> Contains - </b> Filters the ZIP file(s) which contains the file name entered in the <b> Partial/ Complete ZIP File Name </b> field. </li><li><b> Starts With - </b> Filters the ZIP file(s) that starts with the file name entered in the <b> Partial/ Complete ZIP File Name </b> field. </li><li><b> Ends With - </b> Filters the ZIP file(s) that ends with the file name entered in the <b> Partial/ Complete ZIP File Name </b> field. </li><li><b> Regular Expression - </b> Filters for a regular expression. For information refer to <a href="https://en.wikipedia.org/wiki/Regular_expression" target="_blank" title="Regular Expression"> Regular Expression </a>. </li></ul></td></tr><tr><td colspan="1" rowspan="1"> Match Case Sensitive </td><td colspan="1" rowspan="1"> Select this checkbox if you want to filter the ZIP file that match the case sensitive of the entered file name. </td></tr><tr><td colspan="1" rowspan="1"> Filter Your ZIP Sub File </td><td colspan="1" rowspan="1"> You can select the below options to filter your file(s) from the selected Zip file. </td></tr><tr><td colspan="1" rowspan="1"> Select Sub File From ZIP File </td><td colspan="1" rowspan="1"> Select a CSV file to parse from the unzipped folder. </td></tr><tr><td colspan="1" rowspan="1"> Enter Sub File Name From ZIP File </td><td colspan="1" rowspan="1"> Enter a file name to parse from the zip archive. </td></tr><tr><td colspan="1" rowspan="1"> Enter ZIP Sub File Extension </td><td colspan="1" rowspan="1"> Limits the search only to files with the specified extension, for example, csv, txt, and so on. </td></tr><tr><td colspan="1" rowspan="1"> Partial/ Complete ZIP Sub-File Name </td><td colspan="1" rowspan="1"> Enter the ZIP sub-file name you want to match and filter using the <b> Zip Sub-File Name Match Criteria </b>. </td></tr><tr><td colspan="1" rowspan="1"> Zip Sub-File Name Match Criteria </td><td colspan="1" rowspan="1"> Select the match criteria to filter for the ZIP sub-files. <br /><ul><li><b> Exact Match - </b> Filters for the exact ZIP sub-file(s) that match the same file name entered in the <b> Partial/ Complete ZIP Sub-File Name </b> field. </li><li><b> Contains - </b> Filters the ZIP file(s) which contains the file name entered in the <b> Partial/ Complete ZIP Sub-File Name </b> field. </li><li><b> Starts With - </b> Filters the ZIP file(s) that starts with the file name entered in the <b> Partial/ Complete ZIP Sub-File Name </b> field. </li><li><b> Ends With - </b> Filters the ZIP file(s) that ends with the file name entered in the <b> Partial/ Complete ZIP Sub-File Name </b> field. </li><li><b> Regular Expression - </b> Filters with a regular expression. For information refer to <a href="https://en.wikipedia.org/wiki/Regular_expression" target="_blank" title="Regular Expression"> Regular Expression </a>. </li></ul></td></tr><tr><td colspan="1" rowspan="1"> Match Case Sensitive </td><td colspan="1" rowspan="1"> Select this checkbox if you want to filter the ZIP sub-files that match the case sensitive of the entered file name. </td></tr><tr><td colspan="1" rowspan="1"> Delimiting Character </td><td colspan="1" rowspan="1"> Select the delimiting character used in your file. If your delimiter is not listed, then select 'Other.' </td></tr><tr><td colspan="1" rowspan="1"> Specify your delimiter </td><td colspan="1" rowspan="1"> Enter the character used to delimit your character separated values (CSV) text. </td></tr><tr><td colspan="1" rowspan="1"> Quote Character </td><td colspan="1" rowspan="1"> Select the desired quote character for parsing CSV files. Double quote is the CSV standard default quote character. </td></tr><tr><td colspan="1" rowspan="1"> Custom Quote Character </td><td colspan="1" rowspan="1"> Enter the desired CSV Quote character. </td></tr><tr><td colspan="1" rowspan="1"> Escape Character </td><td colspan="1" rowspan="1"> Select the desired escape character for parsing CSV files. </td></tr><tr><td colspan="1" rowspan="1"> Custom Escape Character </td><td colspan="1" rowspan="1"> Enter the desired CSV escape character. </td></tr><tr><td colspan="1" rowspan="1"> File Encoding </td><td colspan="1" rowspan="1"> Select the file encoding. </td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").
