Skip to end of metadata
Go to start of metadata

Introduction

This page summarizes how to enable token-based authentication (TBA) in NetSuite and obtain the values needed for configuring Jitterbit Harmony to authenticate with NetSuite using TBA.

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.

After TBA is enabled in NetSuite, refer to these pages for next steps in Harmony:

Jitterbit Recommendations for Switching to TBA

If you are currently using username/password (SSO) authentication with NetSuite in Jitterbit Harmony, there are several recommended options for the path forward to switching to TBA:

TIP: For additional information, refer to the following NetSuite documentation (login to NetSuite required):

Enable Token-Based Authentication

Enabling TBA for NetSuite is the first step, and is applicable to all options (Options 1, 2, and 3) described under Jitterbit Recommendations for Switching to TBA. This is done at the organization level.

  1. Log in to your NetSuite organization.
  2. From the top menu bar, navigate to Setup > Company > Enable Features.
  3. On the Enable Features screen, go to the SuiteCloud tab.
    1. Under the SuiteScript section, select Client SuiteScript and Server SuiteScript.
    2. Under the Manage Authentication section, select Token-Based Authentication.
    3. Click Save.

Create a New Role

This step is applicable only for Options 2 and 3 described under Jitterbit Recommendations for Switching to TBA. If you are using Option 1, you can skip this step, as you will be using your existing role assigned to the Jitterbit Harmony NetSuite user.

Install the Custom Administrator Bundle

We recommend using NetSuite's Administrator-like role that is available as a customization bundle. This will help in making sure that Jitterbit Harmony has the most elevated access to items that were formerly accessed through a highly privileged role such as Administrator.

If you do not want to use this bundle and instead add permissions individually, you can skip this part. Keep in mind that you must know which record types you are using in your Harmony integration, including any custom records, fields, or lists, so that you are able to add the appropriate permissions.

To install the customization bundle and add the role:

  1. From the NetSuite's top menu bar, navigate to Customization > SuiteBundler > Search & Install Bundles. (Do not click on List.)
  2. On the Search & Install Bundles page, in the Keywords search box, enter "1251" and click Search.
  3. From the search results, select the bundle Administrator Role - Customizable.
  4. On the Bundle Details page, click Install. Then from the next page, Preview Bundle Install, click Install Bundle.
  5. On the Installed Bundles page, the Status will show "Pending..." Installation may take awhile. You can click Refresh to see the progress.
  6. When installation is successful, the Status will show a green checkmark:

  7. After installation is successful, from NetSuite's top menu bar, navigate to Setup > Users/Roles > Manage Roles. (Do not click New or Search).

  8. On the Manage Roles page, on the row for the Custom Administrator role, click Edit.
  9. Navigate to the Permissions tab > Setup subtab to review the permissions granted for the role and make any edits if necessary. At a minimum, add permissions for Access Token ManagementUser Access Tokens, and Web Services.

Add a New Role

An alternative to using the customization bundle is to add a new role and permissions individually. Before doing this, you should know which record types you are using in your Harmony integration, including any custom records, fields, or lists, so that you are able to add the appropriate permissions.

To add a new role:

  1. From NetSuite's top menu bar, navigate to Setup > Users/Roles > Manage Roles > New.
  2. On the Role screen, fill out these fields:
    1. Enter a Name, such as "Jitterbit TBA."
    2. Select the desired Center Type. This selection depends on what actions you will be taking. If you don't know which one to select, you can keep the default selection as Accounting Center.
    3. Near the bottom of the Role screen, navigate to the Permissions tab > Setup subtab. Use the Permission dropdown to select each type of record that you will need access to in Jitterbit Harmony and click Add one at a time. At a minimum, add permissions for:
      • Access Token Management
      • User Access Tokens
      • Web Services
      You may also want to add custom fields. For example:
      • Custom Body Fields
      • Custom Column Fields
      • Custom Entity Fields
      • Custom Event Fields
      • Custom Fields
      • Custom Item Fields
      • Custom Item Number Fields
      • Custom Lists
      • Custom Record Types
      • Custom Transaction Fields
      • Other Custom Fields
      • Other Lists
    4. Navigate to the Permissions tab > Lists subtab. Use the Permission dropdown to select each type of custom list that you will need access to in Jitterbit Harmony. Use the Level dropdown to select Full for each and click Add one at a time. For example:
      • Employees
      • Customers
    5. Click Save.

Add a New User to Role

This step is applicable only for Option 3 described under Jitterbit Recommendations for Switching to TBA. If you are using Options 1 or 2, you can skip this step, as you will be using your existing NetSuite user that you are currently using in Jitterbit Harmony.

To add a new user:

  1. From NetSuite's top menu bar, navigate to Lists > Employees > Employees > New.
  2. On the Employee screen, fill out these fields:
    1. Under Primary Information, enter a Name, such as "Jitterbit" for the first name and "TBA" for the last name.
    2. Under Email | Phone | Address, provide an Email.
    3. In the Access section, select Give Access and set the Password and Confirm Password.
    4. In the Access section under Roles, use the Role dropdown to select the role you created above. Then click Add.
    5. Click Save.

Assign a Role to an Existing User

This step is applicable only for Option 2 described under Jitterbit Recommendations for Switching to TBA. If you are using Option 1, you can skip this step, as you will be using your existing role assigned to the Jitterbit Harmony NetSuite user. If you are using Option 3, you should have already assigned the role when you created the new user, as described above.

To assign a role to an existing user:

  1. From NetSuite's top menu bar, navigate to Lists > Employees > Employees.
  2. On the Employees page, on the row for the user you are currently using for your Harmony integration, click Edit.
  3. On the Employee page, in the Access section under Roles, use the Role dropdown to select the role you created above. Then click Add.
  4. Click Save.

Gather Values for Configuring TBA in Jitterbit

After TBA is enabled and you know which role and user you are using in Jitterbit Harmony, you can gather the values needed for configuring TBA in Harmony. This is required for all options (Options 1, 2, and 3) described under Jitterbit Recommendations for Switching to TBA.

Consumer Key and Consumer Secret

  1. From the top menu bar, navigate to Setup > Integration > Manage Integrations > New.
  2. On the Integration screen, fill out these fields:
    1. Enter a Name, such as "Jitterbit TBA."
    2. From the State dropdown, select Enabled.
    3. Under the Authentication tab, select Token-Based Authentication.

      NOTE: The selection for User Credentials is used only if you want the user to also be able to log in with standard username/password authentication.
    4. Click Save.
  3. A confirmation message will be displayed, along with values for the following fields that you will need later when configuring TBA in Jitterbit Harmony.

    CAUTION: Be sure to copy or save these values, as you will not be able to return to this screen.
    • Application ID: Save this value.
    • Consumer Key: Save this value. It will not be displayed again.
    • Consumer Secret: Save this value. It will not be displayed again.

Token ID and Token Secret

  1. Search for "tokens" using the search bar at the top. You should arrive at the page Access Tokens.
  2. Click the button New Access Token.
  3. On the Access Token screen, fill out these fields:
    1. Enter an Application Name such as "Jitterbit TBA."
    2. From the User dropdown, select the user you created above.
    3. From the Role dropdown, select the role you created above.
    4. Make any edits to the Token Name as desired.
    5. Click Save.
  4. A confirmation message will be displayed, along with the values for the following fields that you will need later when configuring TBA in Jitterbit Harmony.

    CAUTION: Be sure to copy or save these values, as you will not be able to return to this screen.
    • Token ID: Save this value.
    • Token Secret: Save this value.

Account ID

  1. From the top menu bar, navigate to Setup > Integration > Web Services Preferences.
  2. On the Web Services Preferences screen, save the value of the Account ID to use later when configuring TBA in Jitterbit Harmony.
On This Page

Last updated:  Oct 26, 2018