Verwenden Sie NetSuite TBA im NetSuite Connector in Jitterbit Design Studio

Einführung

Auf dieser Seite wird die Verwendung der tokenbasierten Authentifizierung (TBA) mit dem NetSuite-Connector von Jitterbit beschrieben. Bevor Sie TBA in Jitterbit konfigurieren, lesen Sie die Empfehlungen von Jitterbit zum Aktivieren von TBA in NetSuite.

Diese Anweisungen setzen voraus, dass Sie bereits SSO-Authentifizierung auf einem NetSuite Endpoint verwenden und die Authentifizierungsmethode ändern möchten, um TBA zu verwenden. Die vollständige Dokumentation zum Konfigurieren eines neuen TBA- oder SSO- Endpoint finden Sie unter NetSuite-Connector-Endpoint.

Um mit dem NetSuite Connector einen vorhandenen NetSuite Endpoint, der mit SSO-Authentifizierung konfiguriert ist, für die Verwendung von TBA zu konvertieren, befolgen Sie die Schritte auf dieser Seite:

1. Backup erstellen
2. In TBA konvertieren
3. Testen Sie den Endpoint

Voraussetzungen

Um TBA mit dem NetSuite Connector in Jitterbit zu verwenden, müssen diese Kriterien erfüllt sein:

1. Sie müssen über die entsprechende Rolle für Ihr NetSuite-Konto verfügen.

2. Sie müssen SuiteTalk Version 2015.2 oder höher verwenden.

3. Sie müssen TBA für Ihr NetSuite-Konto aktiviert haben.

4. Sie müssen Jitterbit-Agenten Version 9.2 verwenden oder höher und Design Studio Version 9.3.1 oder höher, um einen vorhandenen SSO- Endpoint für die Verwendung von TBA zu konvertieren.

Erstellen Sie ein Backup

Zuerst möchten Sie vielleicht ein Jitterpak erstellen, um bei Bedarf eine Sicherungskopie des Projekts zu haben.

Konvertieren zu TBA

Öffnen Sie Ihren vorhandenen NetSuite Endpoint, indem Sie im Baum links unter Connectors > NetSuite > NetSuite Endpoints auf den Endpoint doppelklicken.

Klicken Sie in der Konfiguration auf die Schaltfläche In TBA konvertieren.

Geben Sie im Popup-Fenster die Werte ein, die Jitterbit zur Authentifizierung bei Ihrer NetSuite-Instanz mithilfe von TBA verwenden soll. Klicken Sie dann auf Speichern.

• Konto: Geben Sie die NetSuite Konto-ID ein, die Ihrem NetSuite-Konto zugeordnet ist. Anweisungen zum Abrufen dieses Werts finden Sie unter TBA in NetSuite aktivieren.

• WSDL-Download-URL: Geben Sie die kontospezifische URL der von der NetSuite Instanz verwendeten NetSuite-WSDL ein. Jitterbit unterstützt die unter Voraussetzungen aufgeführten WSDL-Versionen weiter oben auf dieser Seite. Anweisungen zum Abrufen der kontospezifischen WSDL-URL finden Sie unter NetSuite-kontospezifische WSDL-URL.

  Notiz

  Zunächst wird empfohlen, dieselbe WSDL-Version wie Ihr vorhandener SSO- Endpoint zu verwenden. Wenn Sie Ihr WSDL aktualisieren müssen, sollten Sie dies separat tun. Dies ist ein empfohlener Schritt zur Fehlerbehebung, damit bei auftretenden Problemen die Ursache ermittelt werden kann.

• Consumer Key und Consumer Secret: Geben Sie die NetSuite Consumer Key- und Consumer Secret-Werte ein, die Sie von NetSuite erhalten haben. Anweisungen zum Abrufen dieser Werte finden Sie unter TBA in NetSuite aktivieren.

• Token Key und Token Secret: Geben Sie die von NetSuite NetSuite](/de/design-studio/design-studio-reference/connectors/netsuite-connector/enable-tba-in-netsuite).

  Vorsicht

  Wenn Sie ein NetSuite Sandbox-Konto verwenden, müssen Sie bei jeder Aktualisierung der Sandbox neue Token erstellen.

• Signaturalgorithmus: Verwenden Sie das Dropdown-Menü, um den Signaturalgorithmus auszuwählen, der zum Signieren der Anfrage verwendet werden soll, entweder HMAC-SHA1 oder HMAC-SHA256. Der Signaturalgorithmus bestimmt, wie die Payload verschlüsselt wird.

  Notiz

  NetSuite hat HMAC-SHA1 ab diesen Versionen als gültige Signaturmethode zugunsten von HMAC-SHA256 abgelehnt:

  • Nicht-Produktionskonten: NetSuite Version 2021.2 und höher.
  • Produktionskonten: NetSuite Version 2023.1 und höher.

  Die Abwertung von HMAC-SHA1 ist unabhängig davon, welche WSDL-Version Sie in der Konfiguration des NetSuite Endpoint angeben.

• Anruf-Timeout: Geben Sie optional den Anruf-Timeout-Wert in Sekunden ein, wenn der Timeout-Wert kleiner als die Agenteneinstellung sein soll.

  Notiz

  Die Standard-Agenteneinstellung für das Timeout von NetSuite-Anrufen beträgt 300 Sekunden.

• Bei behebbarer Ausnahme erneut versuchen (in den Versionen 10.36 und 10.37 als Wiederholoption aktivieren gekennzeichnet): Diese Option ist in Design Studio Versionen 10.36 und höher vorhanden und funktioniert nur, wenn eine Umfeld verwendet wird, die mit einer privaten Agentengruppe verknüpft ist, deren Agenten Version 10.24 oder höher sind. Ihr Verhalten hängt von der privaten Agentenversion ab. Wenn diese Einstellung ausgewählt ist, wird eine abgelehnte Anfrage an NetSuite erneut versucht, wenn eines dieser Kriterien erfüllt ist:

  • Private Agenten 10.24 und höher: Das Governance Limit von NetSuite für gleichzeitige Anfragen ist erreicht und der Fehler WS_REQUEST_BLOCKED wird zurückgegeben.
  • Private Agenten 10.36 und höher: NetSuite gibt im erwarteten Zeitrahmen keine Antwort zurück und es tritt eine Timeout-Ausnahme auf.

  Um die Parallelitätslimits Ihres NetSuite Kontos zu überprüfen, gehen Sie in der NetSuite Benutzeroberfläche zu Setup > Integration > Integration Governance. Weitere Informationen finden Sie in der NetSuite-Dokumentation zu Grenzwerte für Parallelitäts-Governance basierend auf Service-Stufen und SuiteCloud Plus-Lizenzen.

  Damit diese Einstellung wirksam wird, muss die Variable Jitterbit jitterbit.netsuite.async darf nicht gesetzt werden auf true davorlegende der Operation.

  Bei privaten Agenten der Version 10.23 oder früher, auf Cloud-Agenten oder wenn die asynchrone Variable Jitterbit aktiviert ist, wird diese Einstellung ignoriert.

  Aktivieren Sie das Kontrollkästchen Bei behebbarer Ausnahme erneut versuchen, um zusätzliche Konfigurationsoptionen zu aktivieren:

  

  • Maximale Anzahl von Wiederholungsversuchen (beschriftet mit Maximale Wiederholung in den Versionen 10.36 und 10.37): Geben Sie die Anzahl der Versuche ein (maximal 5 Wiederholungsversuche), die eine abgelehnte Anfrage erneut an NetSuite gesendet wird. Wenn die Anfrage nach der maximalen Anzahl von Wiederholungsversuchen immer noch abgelehnt wird, wird eine Ausnahme mit einer Fehlermeldung im Operation zurückgegeben. Darüber hinaus protokolliert der private Agent jeden Wiederholungsversuch im jitterbit-agent.log Protokolldatei.

    Jeder Wiederholungsversuch wird als Teil desselben Operation behandelt, wobei nur ein einziger Datensatz im Operation erscheint. Alle zum Ausführen nachlegende Vorgänge konfigurierten Bedingungen Bei Erfolg oder Bei Fehler werden basierend auf dem Endstatus des Operation nach einer Wiederholung bis zur maximalen Anzahl von Wiederholungsversuchen ausgelöst.

  • Wiederholungsintervall: Geben Sie die Anzahl der Sekunden (maximal 5 Sekunden) ein, die zwischen dem erneuten Senden einer abgelehnten Anfrage an NetSuite gewartet werden soll.

Testen des Endpoint

Nachdem Ihr Endpoint erstellt wurde, doppelklicken Sie im Baum links unter Connectors > NetSuite > NetSuite Endpoints auf den Endpoint.

Klicken Sie dann auf die Schaltfläche Verbindung testen, um die Verbindung zu Ihrem NetSuite-Konto zu überprüfen.

Eine Meldung zeigt an, ob die Verbindung erfolgreich war. Wenn die Verbindung nicht erfolgreich war, stellen Sie sicher, dass Sie die Voraussetzungen erfüllen, und überprüfen Sie die Werte, die Sie auf diesem Bildschirm angegeben haben, noch einmal. Wenn beim Testen der Verbindung ein Fehler auftritt, lesen Sie Informationen zur Fehlerbehebung.

Nachdem Sie Ihren NetSuite TBA- Endpoint erfolgreich getestet haben, einsetzen Ihr Projekt einfach bereit, um mit der Verwendung von TBA zu beginnen.