Version: All
Audience: Administrator
OAuth 2.0 Client Credentials only need to be created when existing, valid credentials are not already present for Production, Sandbox, and Release Preview accounts.

If valid credentials are present, do not add additional credentials or revoke existing credentials.

Please reach out to support@extendtech.net if you have questions regarding whether a certificate needs to be added, updated, or revoked and prior to doing so.

Use Case

  • Creating OAuth 2.0 Client Credentials (M2M) to use on eXtendTech application setup pages.

Prerequisites 

  1. Ensure the OAUTH 2.0 feature is enabled in your NetSuite account.
    1. Navigate to Setup → Company → Enable Features.
    2. Select the SuiteCloud subtab.
    3. Scroll down the page to the Manage Authentication field group and confirm that the OAUTH 2.0 checkbox is enabled.
  2. Certificate file
    Contact eXtendTech to obtain the appropriate certificate file.
  3. Certificate version
    The certificates provided by eXtendTech have a lifecycle of one year and are rotated by eXtendTech every year. Confirm the version with eXtendTech Support.
  4. OAuth 2.0 Authentication Roles
    In general, eXtendTech provides a custom role for each bundle/SuiteApp that requires one. This role is created with the minimum-required permissions to run the feature set.

    It is recommended to create a copy of this bundled role as     “YOUR COMPANY NAME - eXtendTech Bundle Role” and assign this role to the user you will be using to create access tokens.

    For example: Company Name - eXtendMobile Server User.

Configuration

Please follow the below steps to create OAuth 2.0 Client Credentials.

  1. Navigate to Setup → Integration → Manage Authentication → OAuth 2.0 Client Credentials (M2M) Setup to access the OAuth 2.0 Client Credentials Setup page.

  2. To create a new mapping, click the Create New button.

  3. In the popup window, choose the entity, role, and application to be mapped. Upload the certificate file from your computer.

    1. Entity
      Use the employee record that the eXtendMobile Server User role is applied. This user must always have access to NetSuite.

      Note: See the table at the end of this article for other roles which may be used depending on the bundle/SuiteApp being configured.
    2. Application
      Select the eXtendTech application for which you are creating OAuth 2.0 Client Credentials. For example, for eXtendMobile you will find option named eXtendMobile.
    3. Role
      Select the eXtendMobile Server User role.

      Note: See the table at the end of this article for other roles which may be used depending on the bundle/SuiteApp being configured.
    4. Certificate
      Upload the certificate file provided by eXtendTech.
  4. Upon saving, a Certificate ID will be generated. Save this Certificate ID for use on applicable eXtendTech application setup pages.

Please see NetSuite’s SuiteAnswers Article ID 101101* for information on creating OAuth 2.0 client credentials. 
* You must log in to SuiteAnswers to access the links above.

Custom Role and Integration Names

Below is a list of custom roles that we offer our bundles/SuiteApps:
Bundle Name
 Role
 eXtendFiles
 eXtendFiles Server User
 eXtendFrame
 eXtendFn Server User
 eXtendMobile
 eXtendMobile Server User
Integration Records for Applications to Use OAuth 2.0 - For each eXtendTech bundle/SuiteApp, an integration record is provided and must be used for generating the OAuth 2.0 credentials. Below is a list of integration records provided for along with our bundles/SuiteApps:

 Bundle Name
 Integration Name
 eXtendFiles
 eXtendTech Files
 eXtendFrame
 eXtendFrame Functions
 eXtendMobile
 eXtendMobile