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: