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:
-
Acesse o Cloud Studio por meio do Harmony Portal em https://login.jitterbit.com.
-
Abra cada projeto usando o Cloud Studio NetSuite Connector.
-
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:
-
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:
-
No aplicativo Design Studio, abra cada projeto usando o Design Studio NetSuite Connector.
-
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:
-
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.