Universal/Generic Writeback not able to use two-factor authentication

Applies to:

• Velixo Classic
• Velixo NX
• Acumatica, CEGID, Haufe x360, JAMIS Prime, MYOB Acumatica

TABLE OF CONTENTS

• Overview
• Cause
• Resolution

Overview

When attempting to use the Velixo NX Universal Writeback or Velixo Classic Generic Writeback feature, one of the following messages is displayed:

or

Text of Message

Generic Writeback can't be used while logged in using single sign-on.  To use Generic Writeback, you must log in using username and password.

or

Something went wrong, please carefully check the function arguments.

The ERP system's import API returned the following error (note that it can sometimes be deeply technical, confusing, and/or not reflecting the real root cause of the failure):

System.Web.Services.Protocols.SoapException: Server was unable to process request. --- > PX.Data.PXException: Two-factor authentication is enabled for this user.  You cannot log in with this user account.

Cause

The first message indicates that you are using a version of Acumatica (prior to 2022R1) that does not support the use of two-factor authentication with the Universal/Generic Writeback feature.  

As is noted in the second message, two-factor authentication has been enabled for the account being used to access the ERP.  Additional configuration is required for using two-factor authentication with the Universal/Generic Writeback feature.

Resolution

Configure Acumatica 2022R1 or higher to use mutli-factor authentication and OAuth2 (aka SSO).

Acumatica 2022R1 or higher, includes the ability to use the Velixo Writeback Feature with either username/password authentication or Single Sign-on authentication.  

Important: ... Using multi-factor authentication requires that OAuth2 also be enabled.

Note:

This does *not* require an SSO/Advanced Authentication License with Acumatica (which is only required if you want to link Acumatica to ActiveDirectory, Okta, or another provider).

Older versions of Acumatica ONLY support using username and password with the Velixo Univerasl/Generic Writeback feature.  Those versions do not support using multi-factor authentication (MFA) and single sign-in (SSO) with Universion/Generic Writeback.