Desuso de NetSuite HMAC-SHA1

Resumen

El algoritmo de firma HMAC-SHA1 ya no será compatible con NetSuite ni con los conectores Harmony NetSuite. Por lo tanto, debe cambiar cualquier proyecto de Harmony que actualmente use HMAC-SHA1 como algoritmo de firma para usar HMAC-SHA256 lo antes posible para evitar problemas con esas integraciones.

Información adicional

NetSuite está dejando obsoleto el algoritmo de firma HMAC-SHA1 como método de firma válido para la autenticación basada en token (TBA) a partir de estas versiones:

Cuentas que no son de producción: NetSuite versión 2021.2 y posteriores.
Cuentas de producción: NetSuite versión 2023.1 y posteriores.

La desuso de HMAC-SHA1 es independiente de la versión de WSDL que especifique en la configuración del extremo de Harmony NetSuite.

En una próxima versión de Harmony, el algoritmo de firma HMAC-SHA1 se eliminará como opción en el conector Harmony NetSuite para Design Studio. Esta opción ya se eliminó de Integration Studio. Le recomendamos que cambie cualquier proyecto de Harmony que actualmente use HMAC-SHA1 como algoritmo de firma para usar HMAC-SHA256 lo antes posible para evitar problemas con esas integraciones.

Fechas clave

A continuación, un resumen de las fechas clave:

Fecha clave	Evento
21 de julio de 2021	NetSuite inicia la actualización de las cuentas líderes de SuiteCloud Developer Network (SDN) a la versión 2021.2 de NetSuite.
30 de julio de 2021	Fin de la actualización de las cuentas principales de SDN de NetSuite a la versión 2021.2. La firma HMAC-SHA1 dejó de funcionar permanentemente en todas las cuentas de SDN.
Mediados a finales de agosto de 2021	Ventana de prueba de NetSuite para cuentas de producción de clientes, durante la cual HMAC-SHA1 dejó de funcionar durante 6 horas por región.
Primavera de 2022	Actualización de las cuentas de producción de clientes de NetSuite a la versión 2022.1 de NetSuite. NetSuite anunció originalmente que la firma HMAC-SHA1 dejaría de funcionar permanentemente con la versión 2022.1 de NetSuite; sin embargo, NetSuite anunció posteriormente que el fin del soporte para HMAC-SHA1 se pospuso.
14 de junio de 2022	Ventana de prueba de NetSuite para cuentas de producción de clientes, durante la cual HMAC-SHA1 dejará de funcionar durante 24 horas por región.
Febrero a abril de 2023	NetSuite actualiza las cuentas de producción de clientes a la versión 2023.1 de NetSuite, momento en el que el método de firma HMAC-SHA1 dejará de funcionar de forma permanente.
Por determinar	Una próxima versión de Harmony eliminará la selección HMAC-SHA1 de Design Studio. Esta selección ya se eliminó de Integration Studio.

Cambios requeridos

Se requieren cambios si un proyecto utiliza actualmente HMAC-SHA1 como algoritmo de firma para la comunicación con NetSuite. A continuación, se proporcionan instrucciones para proyectos que utilizan el conector Design Studio NetSuite. Si un proyecto se conecta a NetSuite mediante un método distinto al conector de NetSuite y necesita ayuda para actualizar el algoritmo de firma, póngase en contacto con soporte de Jitterbit.

Si un proyecto ya utiliza HMAC-SHA256 como algoritmo de firma, no se requieren cambios.

Design Studio

Para verificar el algoritmo de firma utilizado por el conector Design Studio NetSuite y para realizar los cambios necesarios, si es necesario, siga estos pasos:

En la aplicación Design Studio, abra cada proyecto utilizando el conector Design Studio NetSuite.
Abra cada extremo de NetSuite y localice el campo Algoritmo de firma. Si la selección muestra HMAC-SHA256, no es necesario realizar cambios. Si la selección muestra HMAC-SHA1, utilice el menú desplegable para cambiar el algoritmo de firma a HMAC-SHA256:
Pruebe, guarde y vuelva a desplegar cada Extremo de NetSuite donde se actualizó el algoritmo de firma.

Si no se realizan los cambios necesarios

Si un proyecto de Harmony todavía usa HMAC-SHA1 cuando NetSuite desaprueba ese método de firma para su cuenta de NetSuite, la integración dejará de funcionar.

Se producirá un error similar al que se muestra a continuación cuando pruebe el extremo o ejecutar una operación utilizando HMAC-SHA1:

<?xml version="1.0" encoding="utf-8"?>
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soapenv:Body>
        <soapenv:Fault>
            <faultcode>soapenv:Server.userException</faultcode>
            <faultstring>The request could not be understood by the server due to malformed syntax.</faultstring>
            <detail>
                <platformFaults:invalidCredentialsFault
                    xmlns:platformFaults="urn:faults_2019_2.platform.webservices.netsuite.com">
                    <platformFaults:code>USER_ERROR</platformFaults:code>
                    <platformFaults:message>The request could not be understood by the server due to malformed syntax.</platformFaults:message>
                </platformFaults:invalidCredentialsFault>
                <ns1:hostname
                    xmlns:ns1="http://xml.apache.org/axis/">example123
                </ns1:hostname>
            </detail>
        </soapenv:Fault>
    </soapenv:Body>
</soapenv:Envelope>

Para resolver el error y corregir la integración, consulte Cambios necesarios arriba para cambiar el algoritmo de firma a HMAC-SHA256.