This notice applies to customers who use the Token-based Authentication (TBA) feature in your account for integrations that use HMAC-SHA1 as a signature method. As of NetSuite 2023.1, HMAC-SHA1 will no longer be accepted as a signature method for TBA integrations. Before your account is upgraded to 2023.1, you must update your TBA integrations to use the HMAC-SHA256 signature method.
What is Changing?
When your account is upgraded to NetSuite 2023.1, any TBA integrations that are still using the HMAC-SHA1 as a signature method will stop working. This prohibition will apply to all integrations in your account, including integrations from third-party solution providers. Upgrades to NetSuite 2023.1 are targeted to occur between February and April of 2023.
What Will Happen During this Test Window?
The planned 24-hour test window will help you identify TBA integrations in your NetSuite account that are still using the HMAC-SHA1 signature method. During the test window, the HMAC-SHA1 signature method will not be allowed and any TBA integrations using it will stop working.
The 24-hour test window will begin on Tuesday, June 14, 2022, at 9:00 a.m. Central Time (CT).
After the test window ends, TBA integrations using the HMAC-SHA1 signature method will be accepted again, until your account is upgraded to NetSuite 2023.1.
Recommended Action
Update your TBA integrations to use the HMAC-SHA256 signature method. If you use any integrations provided by a third party, you must inform the third party that HMAC-SHA1 will no longer be supported as a signature method for TBA in NetSuite. The third party must provide you with an updated solution before the NetSuite 2023.1 release.
You must update the authorization header to use HMAC-SHA256. The value of the oauth_signature_method parameter must be changed from HMAC-SHA1 to HMAC-SHA256, and the value of the oauth_signature parameter also must change accordingly. For more information, see the help topic Example OAuth Header (SuiteAnswers, ID 50996).
If you are using a library for signing, you must verify that the library supports HMAC-SHA256. If the library you are using does not support HMAC-SHA256, you must either update the library to use HMAC-SHA256 or start using another library that supports HMAC-SHA256.
The 24-hour test window in your account will begin on Tuesday, June 14, 2022, at 9:00 a.m. CST.
If you require assistance or more information, please contact NetSuite Customer Support.