Requirements for Using Token-Based Authentication
To use token-based authentication (TBA) with SOAP web services, meet these requirements:
General Setup Requirements
To use token-based authentication, complete these setup tasks:
-
Enable the Token-based Authentication feature. For details, see Enable the Token-based Authentication Feature.
-
Create a role that allows token-based authentication login. For details, see Set Up Token-based Authentication Roles.
-
Assign a user to a role with token-based authentication permission. For details, see Assign Users to Token-based Authentication Roles.
-
Create an integration record for the app at Setup > Integration > Manage Integrations. Enable Token-based Authentication on the integration record. For help creating an integration record, see Creating an Integration Record.
-
Get the consumer key and secret generated when enabling Token-based Authentication on the integration record. If you don't have the credentials, generate new ones for apps created in your NetSuite account. If the record was bundled, the credentials are included, and only the app owner can regenerate them. For details, see Regenerating a Consumer Key and Secret.
-
Create a token and token secret for the user sending the SOAP request. For details on this process, see Manage TBA Tokens in the NetSuite UI.
Additional SOAP Web Services Requirements
To use token-based authentication (TBA) with SOAP web services, meet these requirements:
-
The request must use request-level credentials, not the login operation. For details on the difference, see Authentication for SOAP Web Services.
-
The request must use a TokenPassport object, not a Passport object. For help updating an integration to use a TokenPassport, see TokenPassport Complex Type and Updating a SOAP Web Services Integration to Send Token-Based Authentication Details.