This article applies to the following CloudExtend Apps.
CloudExtend Excel Data Management for NetSuite
CloudExtend Excel Analytics for NetSuite
CloudExtend Outlook for NetSuite
CloudExtend Gmail for NetSuite
CloudExtend login flow overview
The CloudExtend login flow supports all NetSuite login flows out of the box without the administrative overhead of managing tokens.
Two-Factor Authentication
SAML Single Sign-On
Token Based Authentication
Basic User Credentials
Prerequisites
NetSuite Account Number
In order to use the login flow you will need your NetSuite Account Number. This can be located in the URL while you are logged in to NetSuite in a browser.
End-User Permissions
Please make sure your Admin has set up the following permissions for the roles you plan to login with.
SOAP Web Services - SOAP Web Services are required for the App to communicate with NetSuite post login.
User Access Tokens - When your role has this permission the NetSuite login flow will automatically generate tokens on your behalf and log you in with token-based authentication which can greatly reduce NetSuite concurrency issues.
Users without this permission will see an error when logging inYou cannot continue this authorization flow. Your current role has insufficient permission. Please contact your account administrator. and will need to click the back button and will only be able to login with basic credentials.Optional - SAML Single Sign On - If your organization uses Single Sign On (SSO) then your role likely already has SAML Single Sign On enabled. Note that if you have SSO enabled for any of your roles you will not be able to login to roles that do not support SSO.
Allow JS/HTML uploads - if your user will need to upload .js and .htm files.
Do you have Custom fields?
For Outlook and Gmail Apps: Add custom field permissions to each role.
For Excel Apps: Add custom field permission to each role.
Confused?
If you're not sure what any of this means don't worry about it, your Admin will understand and can help set this up. Click here to send them an email request or share this article with them.
Logging In
🚨 Important Note About NetSuite deprecation of basic credential login
NetSuite has deprecated support for users that log in with basic credentials (using the link shown in the screenshot below). Users should only click Connect to NetSuite which will start NetSuite's own 3-step secure authorization flow.
If you have trouble ask your admin to provision the user access tokens permission to your role.
Step 1: Go to Menu and select Connection.
Step 2: Click Add then enter your NetSuite account ID and click Connect to NetSuite.
Learn how to find your NetSuite account ID here.
Step 3: Enter your NetSuite credentials. Select the role you want to log in with and hit Allow.
Step 4: Click Yes. Now, you have a new connection in CloudExtend.
🚨 IMPORTANT
You will be logged out of your current NetSuite session the first time you log in. Don't worry though, once logged in you'll be able to have both sessions active at the same time. As long as you don't log out of CloudExtend you won't need to enter your credentials again, even if your password expires.
Authorization Flow Error
If you see the error below then please ask your admin to enable user access tokens for you and try again.
Additional Troubleshooting
If your user is receiving an unexpected two-factor authentication prompt and you have not explicitly required two-factor authentication for their role, please note that NetSuite enforces two-factor authentication when certain permissions are enabled for the role.
👉 See this article from NetSuite for a complete list.