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:

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:

   

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:

   

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.