Setup NetSuite Token Based (TBA) Authentication

Overview

The following instructions detail how to configure Token Based Authentication with the Administrator role in an account. This can be used for various external integrations with ICS Payroll, includingĀ Payroll REST Integration.

NetSuite's token-based authentication (TBA) is a standard OAuth implementation. Full instructions for using TBA, are available from the NetSuite Help Centre:Ā 

For sample libraries and services that support TBA/OAuth, see:

Instructions

  1. Login as anĀ Administrator
  2. Go toĀ Setup > Company >Ā Enable Features
    1. UnderĀ SuiteCloud, checkĀ Token-Based Authentication
    2. ClickĀ I AgreeĀ in popup
    3. ClickĀ Save
  3. Select/create aĀ User / Employee Ā that the integration will function under
  4. Go to:Ā Setup > Integration > Manage Integrations >Ā NewĀ and set the following fields
    1. NameĀ = ICS Payroll Integration
    2. UnderĀ Authentication, mark theĀ TOKEN-BASED AUTHENTICATIONĀ checkbox
    3. ClickĀ Save
    4. Record the displayedĀ Consumer KeyĀ andĀ Consumer SecretĀ in a safe place
  5. Log into NetSuite as theĀ UserĀ (the one from step #3)
  6. On theĀ Home screen, from theĀ SettingsĀ portlet, selectĀ Manage Access Tokens
  7. ClickĀ New My Access Token
    1. Select theĀ IntegrationĀ you created earlier (e.g.Ā ICS Payroll Integration),Ā from theĀ Application NameĀ field
    2. ClickĀ Save
    3. Record the displayedĀ Token IDĀ andToken SecretĀ in a safe place
  8. Input the recorded Consumer Key, Consumer Secret, Token ID and Token Secret into the application you are integrating.

Obtaining a Token programmatically

Aternatively, it's possible to obtain (issue and get) a token by calling a special endpoint with user credentials. For full details see NetSuite's Help Article:Ā Issue Token and Revoke Token REST Services for Token-Based Authentication