NetSuite HMAC-SHA1 veraltet

Zusammenfassung

Der Signaturalgorithmus HMAC-SHA1 wird von NetSuite oder den Harmony NetSuite Konnektoren nicht mehr unterstützt. Daher sollten Sie alle Harmony Projekte, die derzeit HMAC-SHA1 als Signaturalgorithmus verwenden, so schnell wie möglich auf HMAC-SHA256 umstellen, um Probleme mit diesen Integrationen zu vermeiden.

Weitere Informationen

NetSuite lehnt den Signaturalgorithmus HMAC-SHA1 ab den folgenden Versionen als gültige Signaturmethode für die tokenbasierte Authentifizierung (TBA) ab:

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 Harmony NetSuite Endpoint angeben.

In einer kommenden Harmony Version wird der Signaturalgorithmus HMAC-SHA1 als Auswahlmöglichkeit im Harmony NetSuite Connector für Design Studio entfernt. Diese Auswahl wurde bereits aus Integration Studio entfernt. Wir empfehlen Ihnen, alle Harmony Projekte, die derzeit HMAC-SHA1 als Signaturalgorithmus verwenden, so schnell wie möglich auf HMAC-SHA256 umzustellen, um Probleme mit diesen Integrationen zu vermeiden.

Wichtige Daten

Die wichtigsten Termine finden Sie hier:

Termin	Veranstaltung
21. Juli 2021	NetSuite beginnt mit dem Upgrade der führenden Konten des SuiteCloud Developer Network (SDN) auf NetSuite Version 2021.2.
30. Juli 2021	NetSuite beendet das Upgrade führender SDN-Konten auf NetSuite Version 2021.2. Die HMAC-SHA1-Signatur funktionierte auf allen SDN-Konten dauerhaft nicht mehr.
Mitte bis Ende August 2021	NetSuite Testfenster für Kundenproduktionskonten, während dessen HMAC-SHA1 pro Region für 6 Stunden nicht funktionierte.
Frühjahr 2022	NetSuite Upgrade der Kundenproduktionskonten auf NetSuite Version 2022.1. NetSuite hatte ursprünglich angekündigt, dass die HMAC-SHA1-Signatur mit NetSuite Version 2022.1 dauerhaft nicht mehr funktionieren würde. NetSuite gab jedoch später bekannt, dass das Ende des Supports für HMAC-SHA1 verschoben wurde.
14. Juni 2022	NetSuite-Testfenster für Kundenproduktionskonten, während dessen HMAC-SHA1 pro Region für 24 Stunden nicht funktioniert.
Februar bis April 2023	NetSuite aktualisiert die Produktionskonten der Kunden auf NetSuite Version 2023.1. Ab diesem Zeitpunkt funktioniert die Signaturmethode HMAC-SHA1 dauerhaft nicht mehr.
Wird noch festgelegt	In einer kommenden Harmony Version wird die HMAC-SHA1-Auswahl aus Design Studio entfernt. Diese Auswahl wurde bereits aus Integration Studio entfernt.

Erforderliche Änderungen

Änderungen sind erforderlich, wenn ein Projekt aktuell HMAC-SHA1 als Signaturalgorithmus für die Kommunikation mit NetSuite verwendet. Nachfolgend finden Sie Anweisungen für Projekte, die den Design Studio NetSuite Connector verwenden. Wenn ein Projekt über eine andere Methode als den NetSuite-Connector eine Verbindung zu NetSuite herstellt und Sie Hilfe beim Aktualisieren des Signaturalgorithmus benötigen, wenden Sie sich an den Jitterbit-Support.

Wenn ein Projekt bereits HMAC-SHA256 als Signaturalgorithmus verwendet, sind keine Änderungen erforderlich.

Design Studio

So überprüfen Sie den vom Design Studio NetSuite Connector verwendeten Signaturalgorithmus und führen Sie die folgenden Schritte aus, um gegebenenfalls die erforderlichen Änderungen vorzunehmen:

Öffnen Sie in der Design Studio-Anwendung jedes Projekt mit dem Design Studio NetSuite Connector.
Öffnen Sie jeden NetSuite Endpoint und suchen Sie das Feld Signaturalgorithmus. Wenn die Auswahl HMAC-SHA256 anzeigt, sind keine Änderungen erforderlich. Wenn die Auswahl HMAC-SHA1 anzeigt, ändern Sie den Signaturalgorithmus über die Dropdown-Liste in HMAC-SHA256:
Testen, speichern und stellen Sie jeden NetSuite Endpoint erneut bereit, bei dem der Signaturalgorithmus aktualisiert wurde.

Wenn erforderliche Änderungen nicht vorgenommen werden

Wenn ein Harmony-Projekt immer noch HMAC-SHA1 verwendet, während NetSuite diese Signaturmethode für Ihr NetSuite Konto ablehnt, funktioniert die Integration nicht mehr.

Wenn Sie den Endpoint testen oder eine Operation Durchführen, tritt ein Fehler ähnlich dem unten gezeigten auf:

<?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>

Informationen zur Behebung des Fehlers und zur Fehlerbehebung der Integration finden Sie unter Erforderliche Änderungen, um den Signaturalgorithmus auf HMAC-SHA256 zu ändern.