SFTP Access Instructions

To access the SFTP ongoing, please enter the following information. Note - password is not required as the Label Insight SFTP site utilizes the SSH key authentication.

  • Host: sftp.labelinsight.com
  • Username: ____
  • Port: 22

SFTP Directory Structure

The following represents the basic Label Insight SFTP directory structure. Depending on your submissions and deliveries your actual structure may vary slightly. Please note if you select batching, scheduling, or zipping features your structure will appear differently.

deliveries > [delivery folder name]

  • %upc%.json
  • %upc%.json
  • %upc%.json

Deliveries: for each delivery licensed from Label Insight, a new folder will be created within the “deliveries” folder. Most customers will only have 1 delivery, although it’s possible to have more than one. If additional folders are created for any reason your account manager will alert you.

In rare instances, the SFTP site may have a different structure. In these cases, our team works closely with you to ensure transparency & alignment. Please contact your account manager with questions.

SFTP File Structure

Once the specific delivery folder is selected, there will be one JSON file per product unzipped.

SFTP File Updates

Data flows in real-time from Label Insight’s system to the SFTP site. The following events will trigger an update to the product JSON file within your deliveries folder on the SFTP site.

Batching

Interested in receiving multiple products in a single JSON file? Let our team know you prefer batches.

Zipping

Interested in receiving multiple JSON files zipped into 1 zip file? Let our team know you prefer zipping.

Schedule

While the recommended integration is real-time, we also support scheduled pushes such as daily, weekly, monthly, and more. Let our team know if you have a preferred delivery schedule!

Event

Description

Initial Launch

Pushes will occur on a product-by-product basis. Upon initial launch, we will push all applicable products to your destination

New Products

Any new product that falls within the licensing agreement will be sent as soon as it is available.

Data Edits

Any update to a licensed product reflected in your schema will result in a push

Schema Updates

In the future, should additional data (such as attributes) be licensed, an update to the schema will occur and all impacted products will result in a new push.

Initial Setup Inputs

The following steps must be completed prior to Label Insight setting up an SFTP delivery.

User Identification - For each user who will require access to the SFTP site provide:

  • User Name - most often provided as a list of email addresses
  • Public SSH Key - if you do not yet have SSH keys please see the section below.

SSH Key Generation - Label Insight’s SFTP utilizes SSH Key Authentication. If you already have SSH keys generated please skip this section. If you do not have SSH keys generated, please continue on and follow the instructions below for your operating system:

System

Instructions

Mac
or
Linux

◦ Open Terminal
◦ Paste the Following Text and Press Enter: ssh-keygen -t rsa -b 2048 -f my-ssh-key
◦ Enter a Passphrase and Press Enter: this acts as a password, but you may leave this blank
◦ Re-Enter the Paraphrase and Press Enter: note this must match the first entry exactly
◦ Close Terminal

Windows

◦ Open cmd.exe
◦ Paste the Following Text and Press Enter: ssh-keygen -t rsa -b 2048 -f my-ssh-key
◦ Enter a Passphrase and Press Enter: this acts as a password, but you may leave this blank
◦ Re-Enter the Paraphrase and Press Enter: note this must match the first entry exactly
◦ Close cmd.exe

If you or your team are still unsure or experiencing difficulties, we’re happy to connect and help you self-generate SSH keys (recommended). Alternatively, Label Insight can generate SSH Keys for you, although it is a less secure path forward. For an overview on SSH Keys please read more information here.

Submission - Once steps “a” and “b” are complete, please provide an email to Label Insight with the list of designated usernames and associated the public SSH keys attached.
Public SSH keys can be identified by finding the file ending in .pub

SSH Key Authentication Set-Up

If you have already added your SSH key file to your FTP software you may skip this step. If you have not added the key file, please note this is a one-time required initial step and you’ll need to follow the instructions below.

Instructions:
◦ Open FTP Software App, such as Filezilla
◦ Press Edit → Settings → Connection → FTP → SFTP
◦ Click “Add Key File” and Upload the SSH Key File
◦ Filezilla will Convert the Key
◦ Press “Ok”

If you or your team are still unsure or experiencing difficulties, we’re happy to connect and help you add your SSH key authentication. Please note if you utilize software other than Filezilla the instructions may vary slightly. Each FTP software provider will have SSH key instructions online.