Articles in this section

Set up token-based authentication for the NetSuite connection

Permanently deleted user
Updated

The BigCommerce - NetSuite integration app's NetSuite connection signs in to NetSuite with token-based authentication (TBA). In NetSuite, you turn on TBA, give a role the permissions the integration app needs, assign that role to the employee the connection uses, and create a token. Then you enter the token in the integration app's NetSuite connection, either during installation or to switch an existing connection from Basic authentication, which is marked to be deprecated. This article is for NetSuite administrators and integrator.io administrators.

Turn on token-based authentication in NetSuite

  1. In NetSuite, go to Setup > Company > Enable Features, and then select SuiteCloud.
  2. Under Manage Authentication, select TOKEN-BASED AUTHENTICATION.
  3. Select Save.

Create a role for the connection

You can't create a token for the Administrator role, so create a role, or edit an existing one, with an identifiable name such as Celigo integrator.io.

The role needs these permissions:

Permission group Permission Level
Transactions Find Transaction Full
Transactions Invoice Full
Transactions Item Fulfillment Full
Transactions Opportunity Full
Transactions Estimate Full
Transactions Sales Order Full
Transactions Track Time Full
Lists Cases Full
Lists Contacts Full
Lists Currency Full
Lists Customers Full
Lists Custom Record Entries Full
Lists Documents and Files Full
Lists Employee Navigation Full
Lists Employee Search Allowed
Lists Employees Full
Lists Items Full
Lists Track Messages Full
Setup Custom Fields Full
Setup Custom Lists Full
Setup Custom Record Types Full
Setup SuiteBundler Full
Setup SuiteBundler Audit Trail Full
Setup SuiteScript Full
Setup User Access Tokens Full
Setup Users & Passwords Full
Setup Web Services Full
  1. In NetSuite, go to Setup > Users/Roles > Manage Roles > New.
  2. Enter a name for the role, and add the permissions in the preceding table.
  3. Select Save.

Assign the role to an employee

  1. In NetSuite, go to Setup > Users/Roles > Manage Users, and edit the employee record that the connection will use.
  2. On the Access subtab, add the role on the Roles subtab, and then select Save.
  3. Sign out of NetSuite, and sign in again as that employee.

Create the access token

  1. In the NetSuite global search, enter access token, and then select Page: New Access Token.
  2. For APPLICATION NAME, select eTail Connectors (Token-Based Auth).
  3. For User, select the employee, and for Role, select the role you created.
  4. Select Save.
  5. Copy the TOKEN ID and TOKEN SECRET that appear on the confirmation page, and keep them somewhere secure. NetSuite shows them only once. If you lose them, create a new token.

Enter the token in the NetSuite connection

  1. Open the BigCommerce - NetSuite integration app, and go to Connections.
  2. Select Edit for the NetSuite connection.
  3. For Authentication type, select Token Based Auth (Manual).
  4. Enter your NetSuite Account ID, and paste the Token ID and Token secret you copied.
  5. Select Test connection, and when the test succeeds, select Save & close.

During installation, you enter the same details in the connection that opens when you select Click to Configure for NetSuite Connection.

Legacy integration tiles

A legacy (v2) Celigo integration tile shows a gray bar at the top with text such as NetSuite - <NetSuite Account ID>. Its NetSuite connection needs a consumer key and consumer secret from a NetSuite integration record, in addition to a token ID and token secret. Before you start, turn on token-based authentication, create the role, and assign it to an employee as described in the earlier sections.

  1. As a NetSuite administrator, go to Setup > Integration > Manage Integrations > New.
  2. Enter a name for the integration record, such as Legacy Integrations Connector. Make sure State is Enabled, and select TOKEN-BASED AUTHENTICATION on the Authentication subtab.
  3. Select Save. Copy the CONSUMER KEY and CONSUMER SECRET from the confirmation page, and keep them somewhere secure. NetSuite shows them only once.
  4. Sign in to NetSuite as the employee, and switch to the role you assigned.
  5. In the Settings portlet, select Manage Access Tokens, and then select New My Access Token.
  6. For Application Name, select the integration record you created, and then select Save. Copy the TOKEN ID and TOKEN SECRET from the confirmation page.
  7. In integrator.io, on the legacy integration tile, select Settings, and then select Connections.
  8. Select Edit for the NetSuite connection, and change Authentication Type to Token.
  9. Enter the Consumer Key, Consumer Secret, Token Id, and Token Secret.
  10. Select Test. When you see Connection is working fine!, select Save.

For connections in integrations built natively in integrator.io, see Set up a manual token-based auth connection to NetSuite.