Using NetSuite’s Token Based Authentication
Here’s a guide to getting setup with token based authentication.
Create a Integration Record
The integration record identifies the application in NetSuite’s system.
Visit the integrations page or global search for page:integrations
Create a integration record if none exists. After you create the record you will need to copy/paste the consumer key and consumer secret to your secrets file.Name: Your-Application-NameAuthentication: Token-Based AuthenticationState: Enabled
If the integration record already exists, but you don’t have the consumer key and consumer secret, edit the record, then press “Reset Credentials”.
2. Enable Token Based Authentication
Setup > Company > Setup Tasks > Enable Features > SuiteCloud > Manage Authentication
Make sure “Token Based Authentication” is enabled
If this feature is not enabled, you will not see the permissions required in the next step.
3. Create a Token Role
Strangely enough, the administrator does not have token permissions by default. If you do not create a token role and assign it to your administrator, you will get a “Login access has been disabled for this role.” error when creating a token.
Global search for page:role, then choose “New Role”
Navigate to “Permissions > Setup” and add the following permissions:User Access Token: FullAccess Token Management: FullWeb Services: Full
4. Add Token Management Permissions
Global search for page:employees
Edit your employee record
Navigate to “Access > Roles” and add the token auth role you just created
5. Create Access Tokens
Global search for page: tokens
New Access Token
Select the application and role we created earlier, then press save.
Copy/past the token ID and token secret to your secrets file.s
6. Configure Your Client
Here’s how to setup the netsuite ruby client with token based authentication: