Ir para o conteúdo

Substituiçã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 qualquer projeto Harmony que esteja usando HMAC-SHA1 como o 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á depreciando 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 de HMAC-SHA1 é independente de qual versão WSDL você especifica na configuração do endpoint Harmony NetSuite.

Em uma versão futura do Harmony, o algoritmo de assinatura HMAC-SHA1 será removido como uma seleção nos conectores Harmony NetSuite para Cloud Studio e Design Studio. Mesmo que o fim do suporte tenha sido adiado, você deve alterar todos os projetos do Harmony que atualmente usam HMAC-SHA1 como o 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 principais datas:

Data Chave Evento
21 de julho de 2021 Início da atualização do NetSuite da SuiteCloud Developer Network (SDN) levando as contas para o NetSuite versão 2021.2.
30 de julho de 2021 Fim do NetSuite da atualização das principais contas SDN para o NetSuite versão 2021.2. A assinatura HMAC-SHA1 parou de funcionar permanentemente em todas as contas SDN.
Meados a finais 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 2022

Atualização do NetSuite das contas de produção do cliente para o NetSuite versão 2022.1.

O NetSuite anunciou originalmente que a assinatura HMAC-SHA1 deixaria de funcionar permanentemente com o NetSuite versão 2022.1; 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 do cliente, durante a qual o HMAC-SHA1 deixará de funcionar por 24 horas por região.
fevereiro a abril de 2023 Atualizações NetSuite de contas de produção do cliente para NetSuite versão 2023.1, momento em que o método de assinatura HMAC-SHA1 deixará de funcionar permanentemente.
A determinar Uma versão futura do Harmony removerá a seleção HMAC-SHA1 da interface do usuário do Cloud Studio e do Design Studio.

Alterações 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 Cloud Studio NetSuite Connector ou o Conector NetSuite do Design Studio. Se um projeto se conectar ao NetSuite usando um método diferente de um de nossos conectores NetSuite e você precisar de ajuda para atualizar o algoritmo de assinatura, entre em contato com Jitterbit Support.

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

Cloud Studio

Para verificar o algoritmo de assinatura em uso pelo Cloud Studio NetSuite Connector e para fazer as alterações necessárias, se necessário, siga estas etapas:

  1. Acesse o Cloud Studio por meio do Harmony Portal em https://login.jitterbit.com.

  2. Abra cada projeto usando o Cloud Studio NetSuite Connector.

  3. Abra cada conexão NetSuite e localize o campo Algoritmo de assinatura. Se a seleção mostrar HMAC-SHA256, nenhuma alteração será necessária. Se a seleção mostrar HMAC-SHA1 ou se a seleção estiver vazia, use o menu suspenso para alterar o algoritmo de assinatura para HMAC-SHA256:

    algoritmo de assinatura de configuração do netsuite

  4. Teste, salve e reimplemente cada conexão NetSuite em que o algoritmo de assinatura foi atualizado.

Design Studio

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

  1. No aplicativo Design Studio, abra cada projeto usando o Design Studio NetSuite Connector.

  2. Abra cada NetSuite Endpoint e localize o campo Algoritmo de assinatura. 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:

    configuração de endpoint com algoritmo de assinatura anotado

  3. 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 substituir esse método de assinatura para sua conta NetSuite, a integração deixará de funcionar.

Ocorrerá um erro semelhante ao mostrado abaixo 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 Mudanças necessárias acima para alterar o algoritmo de assinatura para HMAC-SHA256.