Configuring login credentials

Authentication methods

The connector can authenticate to NetSuite via SuiteTalk using the following methods:

• username and password
• token

Out of the two, username and password will stop working in early 2019 except for users with limited privileges. Depending on the connector's settings and features, this method might not work so we don't recommend it, token-based authentication should be used in all cases.

Username and password

NetSuite setup

1. In NetSuite, navigate to Lists > Employees > New
2. Add the following information for a new employee:
   1. Email address
   2. Check "Give access" (under the Access tab)
   3. Add the "Administrator" role (under the Access tab)
   4. Fill in "Password" and "Confirm password" fields (under the Access tab)
3. Go to Setup > Company > Enable Features.
4. In the SuiteCloud tab, make sure "Web services" is checked 
5. Go to Setup > Integration > Web Service Preferences
6. Add the employee you just created to the user list. Select "Administrator" as Web Services default role
7. From this screen, note the "ACCOUNT ID" value
8. Go to Setup > Integrations > Manage integrations and press New to create a new integration
9. Add the following details and save:
   1. Name - something representative, like "Magento connector"
   2. State - Enabled
   3. Check "User Credentials" under "Authentication"
10. After saving, you will be taken to a view screen where NetSuite will generate an application ID for you. 

Magento Setup

1. In the admin, go to System > NetSuite > Settings
2. Expand the General Settings page and set:
   1. Enable Integration - Yes
   2. Authentication type - Username and password
   3. NetSuite host - https://webservices.netsuite.com/
   4. NetSuite account id - Value from step 7 above
   5. NetSuite account email - value from step 2.a. above
      
   6. NetSuite account password - value from step 2.d. above
      
   7. NetSuite Role ID - 3 (default Administrator role ID)
   8. Application ID - grab from step 10 above
   9. Click "Test connection" to check the credentials
3. Save the settings

Token-based

NetSuite setup

1. Go to Setup > Company > Enable Features.
2. In the SuiteCloud tab, make sure the following features are enabled:
   1. Web Services
   2. Token-based Authentication
3. Go to Setup > Integrations > Manage integrations and press New to create a new integration
4. Add the following details and save:
   1. Name - something representative, like "Magento connector"
   2. State - Enabled
   3. Uncheck "User Credentials" under "Authentication"
   4. Check "Token-Based Authentication" under "Authentication"
5. After saving, copy the generated "Consumer Key" and "Consumer secret" values. Note that this is your only chance to view them, if you don't copy them now you'll have to create another application. Also note the application id.
6. Go to Setup > User Roles > Manage Roles
7. Click "Customize" for the "CEO" role (or any role that has most permissions set). Add the following:
   
   1. Name - "Token access with all privileges"
   2. Under permissions > setup tab add the following permissions (each with "FULL" level): Web Services, User Access Tokens, Access Token Management
8. In NetSuite, navigate to Lists > Employees > New
9. Add the following information for a new employee:
   1. Email address
   2. Check "Give access" (under the Access tab)
   3. Add the "Token access with all privileges" role (under the Access tab). This is the role you defined in step 7
   4. Fill in "Password" and "Confirm password" fields (under the Access tab). Not absolutely needed in case you don't want to login via the UI, but useful.
10. Go to Setup > User Roles > Access Tokens and add a new Token with:
    1. Application name - the one defined at step 4
    2. User - the one defined at step 9
    3. Role - the one defined at step 7
11. Save. At this point, you will be presented with a token ID and a Token Secret. Copy them.
12. Go to Setup > Integration > Web Service Preferences. From this screen, note the "ACCOUNT ID" value
13. Go to Setup > Company > Company Information. Select "Company URLs" tab and note the "SUITETALK (SOAP AND REST WEB SERVICES)" URL. 

Magento setup

1. In the admin, go to System > NetSuite > Settings
2. Expand the General Settings page and set:
   1. Enable Integration - Yes
   2. Authentication type - Token
   3. NetSuite host - Value from step 13 above
   4. NetSuite account id - Value from step 12 above
   5. Consumer key and consumer secret - values from step 5 above
      
   6. Token Id and Token secret - values from step 11 above
   7. Application ID - grab from step 5 above
   8. Click "Test connection" to check the credentials
3. Save the settings