Descontinuação do NetSuite HMAC-SHA1

Resumo

O algoritmo de assinatura HMAC-SHA1 não será mais suportado pelos conectores NetSuite ou Harmony NetSuite. Portanto, você deve alterar quaisquer projetos Harmony que estejam usando HMAC-SHA1 como algoritmo de assinatura para usar HMAC-SHA256 o mais rápido possível para evitar problemas com essas integrações.

Informações adicionais

O NetSuite está descontinuando o algoritmo de assinatura HMAC-SHA1 como um método de assinatura válido para autenticação baseada em token (TBA) a partir destas versões:

Contas de não produção: NetSuite versão 2021.2 e posterior.
Contas de produção: NetSuite versão 2023.1 e posterior.

A descontinuação do HMAC-SHA1 é independente da versão do WSDL especificada na configuração do endpoint do Harmony NetSuite.

Em uma próxima versão do Harmony, o algoritmo de assinatura HMAC-SHA1 será removido como uma seleção no conector Harmony NetSuite para Design Studio. Esta seleção já foi removida do Integration Studio. Recomendamos que você altere quaisquer projetos Harmony que estejam usando HMAC-SHA1 como algoritmo de assinatura para usar HMAC-SHA256 o mais rápido possível para evitar problemas com essas integrações.

Datas importantes

Abaixo está um resumo das datas principais:

Data principal	Evento
21 de julho de 2021	Início da atualização do SuiteCloud Developer Network (SDN) da NetSuite para as principais contas da versão 2021.2 do NetSuite.
30 de julho de 2021	Fim da atualização do NetSuite das contas líderes SDN para a versão 2021.2 do NetSuite. A assinatura HMAC-SHA1 parou de funcionar permanentemente em todas as contas SDN.
Meados ou final de agosto de 2021	Janela de teste do NetSuite para contas de produção do cliente, durante a qual o HMAC-SHA1 parou de funcionar por 6 horas por região.
Primavera de 2022	Atualização do NetSuite das contas de produção do cliente para a versão 2022.1 do NetSuite. O NetSuite anunciou originalmente que a assinatura HMAC-SHA1 deixaria de funcionar permanentemente com a versão 2022.1 do NetSuite; no entanto, o NetSuite anunciou posteriormente que o fim do suporte para HMAC-SHA1 foi adiado.
14 de junho de 2022	Janela de teste do NetSuite para contas de produção de clientes, durante a qual o HMAC-SHA1 deixará de funcionar por 24 horas por região.
Fevereiro a abril de 2023	Atualizações do NetSuite das contas de produção do cliente para a versão 2023.1 do NetSuite, quando o método de assinatura HMAC-SHA1 deixará de funcionar permanentemente.
A ser determinado	Uma próxima versão do Harmony removerá a seleção HMAC-SHA1 do Design Studio. Esta seleção já foi removida do Integration Studio.

Mudanças necessárias

Alterações são necessárias se um projeto estiver usando HMAC-SHA1 como o algoritmo de assinatura para comunicação com o NetSuite. As instruções são fornecidas abaixo para projetos que usam o conector Design Studio NetSuite. Se um projeto se conectar ao NetSuite usando um método diferente do conector NetSuite e você precisar de assistência para atualizar o algoritmo de assinatura, entre em contato com suporte Jitterbit.

Se um projeto já estiver usando HMAC-SHA256 como algoritmo de assinatura, nenhuma alteração será necessária.

Design Studio

Para verificar o algoritmo de assinatura em uso pelo conector Design Studio NetSuite e para fazer as alterações necessárias, se necessário, siga estes passos:

No aplicativo Design Studio, abra cada projeto usando o conector Design Studio NetSuite.
Abra cada endpoint do NetSuite e localize o campo Signature Algorithm. Se a seleção mostrar HMAC-SHA256, nenhuma alteração será necessária. Se a seleção mostrar HMAC-SHA1, use o menu suspenso para alterar o algoritmo de assinatura para HMAC-SHA256:
Teste, salve e reimplante cada NetSuite Endpoint onde o algoritmo de assinatura foi atualizado.

Se as alterações necessárias não forem feitas

Se um projeto Harmony ainda estiver usando HMAC-SHA1 quando o NetSuite descontinuar esse método de assinatura para sua conta NetSuite, a integração deixará de funcionar.

Um erro semelhante ao mostrado abaixo ocorrerá quando você testar o endpoint ou executar uma operação usando 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 o erro e corrigir a integração, consulte Alterações necessárias acima para alterar o algoritmo de assinatura para HMAC-SHA256.