Articles in this section

Set up a connection to BarTender

Rachel Shanthi Bijja
Updated

BarTender is an enterprise labeling and barcode software that helps organizations design, manage, and automate the printing of labels, barcodes, RFID tags, and documents for manufacturing, warehousing, and compliance needs.

Set up a connection

After you start the connection, configure it in the Create connection panel and complete all of the required * authentication settings:

Setting

Instructions

Name your connection * 

Enter a clear and distinguishable name.

Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

API type * 

Choose your BarTender API type:

  • Cloud: Manage label templates and automate print jobs from cloud applications.

  • Print portal (On-premise): Submit data and trigger secure label printing from internal systems.

API type: Cloud

Region * 

Select your BarTender account region (America, APAC, or Europe).

OAuth 2.0 client * 

Select the OAuth 2.0 client that stores the client ID and client secret provided to you by BarTender.

dataLoad.svg​​ How to retrieve the client ID and client secret

To add an OAuth 2.0 client and configure your credentials, click the plus (+) button. Click the edit (pencil.svg) button to modify a selected OAuth 2.0 client. For more information, see Create an OAuth 2.0 iClient resource.

Username * 

Enter your BarTender Cloud username.

Password * 

Enter your BarTender Cloud password.

Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s password safe. When editing this form later, you must enter this password again; it is stored only when the connection is saved and never displayed as text.

API type: Print portal (On-premise)

Agent * 

Select an agent from the list.

To connect to an on-premise application, integrator.io requires that an agent be installed on a networked computer. An agent is a small application that allows you to connect to data behind your firewall. When installing an agent, you will specify a unique access token, which then populates the Agent drop-down list. The installed agents connect to integrator.io and establish a reverse SSH tunnel, allowing secure communication without the need to whitelist integrator.io IP addresses in your firewall settings. A single agent can be used by multiple different connections.

Print portal base URL * 

Enter the BarTender Print portal Base URL.

For example, if your print portal is located at http://localhost/BarTender/api, enter http://localhost.

Username * 

Enter your BarTender Print portal username.

Password * 

Enter your BarTender Print portal password.

Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s password safe. When editing this form later, you must enter this password again; it is stored only when the connection is saved and never displayed as text.

Tip

This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP settings, see the OAuth 2.0 auth universal connector documentation.

How to retrieve the client ID and client secret

  1. Sign in to your BarTender cloud account.

  2. Navigate to Administration> API keys > Web applications (OAuth).

  3. Click Register application for OAuth access.

  4. Enter a Name and Description.

  5. Enter Celigo integrator.io Redirect URL.

  6. Click Register. For detailed information, see Authentication.

  7. From the Applications list, copy the Client ID.

  8. Copy the Client secret.

Save and authorize

  1. Click Save and authorize to commit your changes and proceed to sign in with BarTender.

  2. After signing in, review the permissions for the integration and click Accept.

Additional references