OAuth 1 authentication

To view this content in our official product documentation, click here.

Introduction

When a user chooses to add a connector instance using OAuth 1 authentication, they are required to enter the following credentials:

Credential	Notes
Consumer key	Generated in Netsuite as part of your initial Patchworks integration. For more information see: Consumer key & consumer secret.
Consumer secret	Generated in Netsuite as part of your initial Patchworks integration. For more information see: Consumer key & consumer secret.
Account id	This is always the first element of the URL that you can see having logged into NetSuite. For more information see: Consumer key & consumer secret.
Token	Generated per user in Netsuite. For more information see: Token key & token secret.
Token secret	Generated per user in Netsuite. For more information see: Token key & token secret.
Signature algorithm	Always set to sha256.
Signature method	Always set to HMAC-SHA256.
Realm	For a NetSuite sandbox the accountid shown in NetSuite (as opposed to your NetSuite URL) typically includes an -SB element - for example: 1234567-SB1. The realm will be the same value EXCEPT that the -SB element changes from a dash to an underscore. So, an accountid of 1234567-SB1 becomes 1234567_SB1 for the realm.

Setting up OAuth 1 authentication

In order to add connector instances for NetSuite using OAuth 1 authentication, you must have completed all generic setup detailed in our Preparing your NetSuite environment to work with Patchworks guide.

Finding your credentials

{% hint style="warning" %} If you are using a custom version of our prebuilt NetSuite connector (i.e. if authentication method and/or endpoint settings have been updated after the original installation), please be aware that your settings and requirements may vary. {% endhint %}

Consumer key & consumer secret

If you have followed our Preparing your NetSuite environment to work with Patchworks guide, you will have added a Patchworks integration and saved your client credentials (consumer key/client id and consumer secret/client secret) to a password manager.

If you can't find these credentials, a new set can be generated.

Show me

{% hint style="danger" %} Be aware that if you reset credentials that have already been used to configure Patchworks connector instances, process flows will fail until you apply the new credentials. {% endhint %}

Account ID

This is always the first element of the URL that you can see having logged into NetSuite. For example, with the following URL: \ \ https://tstdrv1431250.app.netsuite.com/app/center/card.nl?sc=-29&whence=

...the account id would be:\ \ tstdrv1431250

Show me

Token key & token secret

A token key and token secret can be generated for users with a Patchworks integration role. In NetSuite, navigate to setup | users/roles | access tokens.

These values should be added to a password manager at the time they are generated as they can't be re-accessed in NetSuite. If you can't find these credentials, a new set can be generated.

Show me

{% hint style="danger" %} Be aware that if you reset credentials that have already been used to configure Patchworks connector instances, process flows will fail until you apply the new credentials. {% endhint %}