Use o TBA do NetSuite no conector do NetSuite no Jitterbit Design Studio

Introdução

Esta página descreve como usar a autenticação baseada em token (TBA) utilizando o conector do NetSuite do Jitterbit. Antes de configurar o TBA no Jitterbit, consulte as recomendações do Jitterbit para habilitar o TBA no NetSuite.

Estas instruções assumem que você já está utilizando autenticação SSO em um endpoint do NetSuite e deseja alterar o método de autenticação para usar o TBA. Para documentação completa sobre como configurar um novo endpoint TBA ou SSO, consulte endpoint do conector do NetSuite.

Para usar o Conector do NetSuite para converter um endpoint existente do NetSuite configurado com autenticação SSO para usar TBA, siga os passos nesta página:

1. Crie um backup
2. Converta para TBA
3. Teste o endpoint

Pré-requisitos

Para usar o TBA com o Conector do NetSuite no Jitterbit, os seguintes critérios devem ser atendidos:

1. Você deve ter a função de permissões apropriada na sua conta do NetSuite.

2. Você deve estar usando a versão 2015.2 ou posterior do SuiteTalk.

3. Você deve ter TBA habilitado para sua conta do NetSuite.

4. Você deve estar usando a versão 9.2 ou posterior dos agentes Jitterbit e a versão 9.3.1 ou posterior do Design Studio para converter um endpoint SSO existente para usar TBA.

Criar um backup

Primeiro, você pode querer criar um Jitterpak para ter uma cópia de backup do projeto, se necessário.

Converter para TBA

Abra seu endpoint do NetSuite existente clicando duas vezes no endpoint na árvore à esquerda em Conectores > NetSuite > Endpoints do NetSuite.

Na configuração, clique no botão Converter para TBA.

Na janela pop-up, insira os valores a serem usados para que o Jitterbit se autentique com sua instância do NetSuite usando TBA. Em seguida, clique em Salvar.

• Conta: Insira o ID da Conta do NetSuite associado à sua conta do NetSuite. Para instruções sobre como obter esse valor, consulte Habilitar TBA no NetSuite.

• Url de Download do Wsdl: Insira a URL específica da conta do WSDL do NetSuite usada pela instância do NetSuite. O Jitterbit suporta as versões do WSDL listadas em Pré-requisitos anteriormente nesta página. Instruções para obter a URL do WSDL específica da conta estão disponíveis em URL do WSDL específica da conta do NetSuite.

  Nota

  Inicialmente, recomenda-se usar a mesma versão do WSDL que seu endpoint SSO existente. Se você precisar atualizar seu WSDL, é recomendável fazê-lo separadamente. Este é um passo recomendado para fins de solução de problemas, para que, se você enfrentar problemas, a causa possa ser determinada.

• Chave do Consumidor e Segredo do Consumidor: Insira os valores de Chave do Consumidor e Segredo do Consumidor obtidos do NetSuite. Para instruções sobre como obter esses valores, consulte Ativar TBA no NetSuite.

• Chave do Token e Segredo do Token: Insira os valores de ID do Token e Segredo do Token obtidos do NetSuite. Para instruções sobre como obter esses valores, consulte Ativar TBA no NetSuite.

  Atenção

  Se você estiver usando uma conta sandbox do NetSuite, cada vez que a sandbox for atualizada, será necessário criar novos tokens.

• Algoritmo de Assinatura: Use o menu suspenso para selecionar o algoritmo de assinatura a ser usado para assinar a solicitação, um dos HMAC-SHA1 ou HMAC-SHA256. O algoritmo de assinatura determina como a carga útil é criptografada.

  Nota

  O NetSuite descontinuou o HMAC-SHA1 como um método de assinatura válido em favor do HMAC-SHA256 a partir das seguintes versões:

  • Contas Não-Produção: versão 2021.2 do NetSuite e posteriores.
  • Contas de Produção: versão 2023.1 do NetSuite e posteriores.

  A descontinuação do HMAC-SHA1 é independente da versão do WSDL que você especifica na configuração do endpoint do NetSuite.

  Aviso

  Se você estiver atualmente usando HMAC-SHA1, recomendamos mudar o algoritmo de assinatura para HMAC-SHA256 o mais rápido possível para evitar problemas com suas integrações. Para mais informações e etapas para mudar o algoritmo de assinatura, consulte Descontinuação do HMAC-SHA1 no NetSuite.

• Tempo Limite da Chamada: Opcionalmente, insira o valor do tempo limite da chamada em segundos, se você quiser que o valor do tempo limite seja menor do que a configuração do agente.

  Nota

  A configuração padrão do agente para o tempo limite das chamadas do NetSuite é de 300 segundos.

• Repetir em Exceção Recuperável (rotulado como Ativar Opção de Repetição nas versões 10.36 e 10.37): Esta opção está presente nas versões 10.36 e posteriores do Design Studio, e é funcional apenas quando se utiliza um ambiente associado a um grupo de agentes privado cujos agentes são da versão 10.24 ou posterior. Seu comportamento depende da versão do agente privado. Quando selecionada, esta configuração é usada para repetir uma solicitação rejeitada ao NetSuite quando um desses critérios for atendido:

• Agentes privados 10.24 e posteriores: O limite de governança de solicitações simultâneas do NetSuite é atingido e o erro WS_REQUEST_BLOCKED é retornado.

• Agentes privados 10.36 e posteriores: O NetSuite não retorna uma resposta no prazo esperado e ocorre uma exceção de timeout.

Para verificar os limites de concorrência da sua conta do NetSuite, na interface do usuário do NetSuite, vá para Configuração > Integração > Governança de Integração. Para mais informações, consulte a documentação do NetSuite sobre Limites de Governança de Concorrência Baseados em Níveis de Serviço e Licenças SuiteCloud Plus.

Para que essa configuração tenha efeito, a variável Jitterbit jitterbit.netsuite.async não deve ser definida como true antes da operação.

Com agentes privados na versão 10.23 ou anterior, em agentes em nuvem, ou se a variável assíncrona do Jitterbit estiver habilitada, essa configuração será ignorada.

Selecione a caixa de seleção Tentar Novamente em Exceção Recuperável para habilitar opções de configuração adicionais:

• Número Máximo de Tentativas (rotulado como Max Retry nas versões 10.36 e 10.37): Insira o número de vezes (máximo de 5 tentativas) que uma solicitação rejeitada será reenviada ao NetSuite. Se a solicitação ainda for rejeitada após o número máximo de tentativas, uma exceção com uma mensagem de erro será retornada no log da operação. Além disso, o agente privado registrará cada tentativa no arquivo de log jitterbit-agent.log.

  Cada tentativa é tratada como parte da mesma execução da operação, onde apenas um único registro aparece no log da operação. Quaisquer condições Em Sucesso ou Em Falha configuradas para executar operações subsequentes são acionadas com base no status final da operação após tentar até o número máximo de tentativas.

• Intervalo de Tentativa: Insira o número de segundos (máximo de 5 segundos) para aguardar entre o reenvio de uma solicitação rejeitada ao NetSuite.

Teste o endpoint

Após criar seu endpoint, clique duas vezes no endpoint na árvore à esquerda em Conectores > NetSuite > Endpoints do NetSuite.

Em seguida, clique no botão Testar Conexão para verificar a conexão com sua conta do NetSuite.

Uma mensagem indicará se a conexão foi bem-sucedida. Se a conexão não for bem-sucedida, certifique-se de atender aos pré-requisitos e verifique novamente os valores que você forneceu nesta tela. Se você receber um erro ao testar a conexão, consulte as informações de solução de problemas.

Depois de testar com sucesso seu endpoint TBA do NetSuite, basta implantar seu projeto para começar a usar o TBA.