Enabling the OpenAir Within NetSuite Feature in OpenAir

After you setup the OpenAir Within NetSuite (NetSuite Single Sign-On Integration) feature in NetSuite, you need to enable it in OpenAir and allow NetSuite single sign-on access for users before they can access OpenAir from within NetSuite.

For steps to set up the OpenAir Within NetSuite (NetSuite Single Sign-On Integration) using NetSuite as OIDC Provider in NetSuite, see Enabling Access to OpenAir From Within NetSuite.

Warning:

The steps in this help topic describe how to enable the upgraded version of the OpenAir Within NetSuite feature, which uses NetSuite as OIDC Provider as outbound single sign-on method instead of SuiteSignOn, in OpenAir.

Until the OpenAir 2023.2 release, OpenAir Within NetSuite relied on the NetSuite Outbound Single Sign-On (SuiteSignOn) feature as outbound single sign-on method. NetSuite plans to end support for SuiteSignOn with the NetSuite 2024.2 for production accounts. The functionality relying on SuiteSignOn may stop working at any time after its end-of-support date.

If you are using the previous feature version relying on NetSuite Outbound Single Sign-On (SuiteSignOn), upgrade before the NetSuite 2024.2 release to ensure service continuity. For upgrade instructions, see Upgrading OpenAir NetSuite Connector Features to Remove the Dependency on SuiteSignOn.

You should test all integration configuration changes on sandbox NetSuite and OpenAir accounts before implementing them in your production accounts.

To enable the NetSuite Single Sign-On integration in OpenAir:

1. Enable the upgraded OpenAir Within NetSuite and Real-Time Record Import features using OAuth 2.0 in OpenAir.

   1. In OpenAir, go to Administration > NetSuite Connector > Credentials.

   2. Check the Use OAuth 2.0 for NetSuite Single Sign-On Integration and Real-Time Record Import (Configuration Changes Required Before Enabling – See Documentation) box under the Additional Integrations section.

   3. Click Save.

      Important:

      Switching to using OAuth 2.0 instead of the SuiteSignOn is not reversible. After you check this box and click Save, you cannot undo the change and go back to using SuiteSignOn.

   4. Click Close to return to the OpenAir NetSuite Connector Credentials tab.

   Tip:

   If you are setting up the upgraded versions of both the OpenAir Within NetSuite and Real-Time Record Import features at the same time, do this step after completing the steps to enable the Real-Time Record Import feature. OpenAir NetSuite Connector then generates a certificate for real-time imports and saves it to NetSuite and OpenAir automatically.

2. In OpenAir, go to Administration > NetSuite Connector > Credentials.

3. Click the Tips button then NetSuite Connector administration.

   The OpenAir NetSuite Connector administration form appears.

4. Check the Enable NetSuite Single Sign-On box under the Other Features section of the form. See Enable NetSuite single sign-on.

5. Click Save.

6. Click Close to return to the OpenAir NetSuite Connector Credentials form.

7. Under NetSuite OAuth 2.0 credentials, enter the Consumer Key and the Shared Secret you copied when creating an integration record for the NetSuite as OIDC Provider integration. See Enabling Access to OpenAir From Within NetSuite.

   

8. Click Save.

9. Run the integration for the Employees (Employees) import workflow, to ensure that all relevant user records are integrated. The OpenAir employee record must have the correct NetSuite Employee ID for single sign-on. See Running the Bulk Import and Export Integration on Demand and Employees (Employees) Import Workflow.

10. For all relevant users, do the following:

    1. Go to Administration > Global Settings > Users > Employees > [Select an employee] > Demographic

    2. Check the Allow NetSuite Single Sign-On box.

       Note:

       If you cannot locate the Allow NetSuite Single Sign-On box, check that the custom field is active and not hidden in the custom field properties and form permissions for the Employee demographic form.

    3. Click Save.

    Tip:

    Use the bulk user change wizard to enable NetSuite single sign-on access for all relevant users. See Making Changes to Multiple Employee Records at the Same Time.