Skip to end of metadata
Go to start of metadata

Introduction

This page describes how to use token-based authentication (TBA) using Jitterbit's NetSuite Connector. Prior to configuring TBA in Jitterbit, see Jitterbit's recommendations for enabling TBA in NetSuite.

NOTE: Those using two-factor authentication (2FA or TFA) in NetSuite are required to use TBA with Jitterbit Harmony. Learn more in NetSuite 2018.2 Token-Based Authentication.

These instructions assume that you are already using SSO authentication on a NetSuite endpoint and want to change the method of authentication to use TBA. For full documentation on configuring a new TBA or SSO endpoint, see NetSuite Connector Endpoint.

Using the NetSuite Connector is one of several ways to use NetSuite TBA with Harmony. Other options include using a web service method or calling a RESTlet:

To use the NetSuite Connector to convert an existing NetSuite endpoint configured with SSO authentication to use TBA, follow the steps on this page:

  1. Create a Backup
  2. Convert to TBA
  3. Test the Endpoint

Prerequisites

To use TBA with the NetSuite Connector in Jitterbit, these criteria must be met:

  1. You must have the appropriate permissions role on your NetSuite account.
  2. You must be using SuiteTalk version 2015.2 or higher.
  3. You must have TBA enabled for your NetSuite account.
  4. You must be using Jitterbit Harmony Agents version 9.2 or higher and Design Studio version 9.3.1 or higher to convert an existing SSO endpoint to use TBA.

TIP: For additional information, refer to the NetSuite documentation on Getting Started with Token-based Authentication (login to NetSuite required).

Create a Backup

First, you may want to create a Jitterpak to have a backup copy of the project if needed.

Convert to TBA

Open your existing NetSuite endpoint by double-clicking the endpoint in the tree on the left under Connectors > NetSuite > NetSuite Endpoints

In the configuration, click the button Convert to TBA.

In the popup window, enter the values to be used for Jitterbit to authenticate with your NetSuite instance using TBA. Then click Save.

TIP: For instructions on enabling TBA in NetSuite and obtaining the values needed for this screen, see Enabling TBA in NetSuite.

Test the Endpoint

After your endpoint is created, double-click the endpoint in the tree on the left under Connectors > NetSuite > NetSuite Endpoints.

Then click the Test Connection button to verify the connection to your NetSuite account. 

A message will indicate if the connection is successful. If the connection is not successful, make sure you meet the prerequisites and double check the values you provided on this screen. If you receive an error testing the connection, refer to troubleshooting information.

After you have successfully tested your NetSuite TBA endpoint, simply deploy your project to begin using TBA. 

On This Page

Last updated:  Dec 12, 2019