NetSuite OAuth-Konfiguration

Schritt 1: Erstellen Sie ein OAuth-Konto in Coupa für NetSuite

So richten Sie Ihre Coupa-Instanz mit einer neuen Verbindung ein:

1. Gehen Sie zu Konfiguration > Integrationen > Oauth2/OpenID Connect Clientsund klicken Sie auf Erstellen.
2. Wählen Sie für "Grant Type " die Option "Client-Anmeldeinformationen".
3. Geben Sie einen Namen für den Kunden, die Anmeldung, die Kontaktinformationen und die Kontakt-E-Mail an.
4. Wählen Sie die folgenden Bereiche aus, um das NetSuite-Paket zu aktivieren:
   • core.common.read
   • core.common.write
   • core.expense.read
   • core.expense.write
   • core.inventory.receiving.read
   • core.inventory.receive.write
   • core.invoice.read
   • core.invoice.write
   • core.pay.payments.read
   • core.pay.payments.write
   • core.pay.virtual_cards.read
   • core.pay.virtual_cards.write
   • core.payables.invoice.read
   • core.payables.invoice.write
   • core.purchase_order.read
   • core.purchase_order.write
   • core.supplier.read
   • core.supplier.write
   Hinweis

   Bereiche sind wie ein Satz von Berechtigungen, die für den API-Schlüssel festgelegt sind. Um API-Berechtigungen mit OIDC zu implementieren, haben wir mehrere neue Bereiche erstellt, die Zugriff auf bestimmte Funktionen für die API bieten.

   Die Liste der Geltungsbereiche und der ihnen zugrunde liegenden Coupa-Berechtigungen finden Sie auf der Seite "Scope-Management" unter /oauth2/scopes. Wenn Sie einen Bereich aufschlüsseln, können Sie die spezifischen API-Berechtigungen sehen, die diesem Bereich zugeordnet sind.

5. Klicken Sie auf Speichern.
   Wenn Sie den Client speichern, erhalten Sie Werte für die Client-ID und den Schlüssel, die erforderlich sind, um Zugriff auf die API-Bereiche zu erhalten, die Sie dafür definiert haben.  Klicken Sie auf Einblenden/Ausblenden, um den Schlüssel anzuzeigen und zu kopieren.
   

Wir benötigen ein Zugriffstoken, um auf APIs zugreifen zu können, und es dauert nur 24 Stunden. Daher empfiehlt Coupa, das Token alle 20 Stunden zu erneuern (wie ein Aktualisierungstoken). Das Netsuite-Paket ist automatisiert.

Schritt 2: Aktualisieren Sie auf die neueste Version des Coupa P2P + Expenses-Pakets

1. Melden Sie sich bei NetSuite an und überprüfen Sie die Client-Version
2. Gehen Sie zuAnpassung > SuiteBundler > Pakete suchen und installieren > Listeaus der oberen Symbolleiste.
   
3. Suchen Sie nach Coupa P2P + Expenses Bundle.
   
   Hinweis

   Die Bundle-Version muss 7.0.0 oder höher sein, um OAuth zu unterstützen

4. Aktualisieren Sie auf das neueste Paket, indem Sie auf das Konfigurationssymbol () klicken und dann Aktualisierenauswählen.
   Die Seite Paket wird geöffnet.
5. Legen Sie alle Werte in der Spalte PREFERENCE aufKeine Bereitstellungenaktualisieren fest, da wir keine Skriptbereitstellungsparameter überschreiben möchten, die bereits eingerichtet wurden.
   
6. Wählen Sie Paketaktualisieren.
   Der Status ändert sich zu Ausstehend. Warten Sie, bis die Aktualisierung abgeschlossen ist.

Die Aktualisierung kann mehrere Minuten dauern. Nach Beendigung wird ein grünes Häkchen angezeigt.

Allgemeine Bemerkungen 

• Dieser Prozess sollte KEINE Ihrer Anpassungen in der Skriptbereitstellung überschreiben oder die Instanzanmeldeinformationen ändern.
• Installieren Sie es zuerst in Ihrer SANDBOX und bestätigen Sie, dass die Änderungen keine Auswirkungen auf Ihre aktuellen Prozesse haben.
• Bitte überprüfen Sie die in den Versionshinweisen vorgenommenen Änderungen, damit Sie wissen, welche Skripte betroffen sind und warum. Dies sollte Ihnen ermöglichen, Tests gezielter durchzuführen.

Schritt 3: Konfigurieren Sie NetSuite so, dass OAuth anstelle von API-Schlüsseln verwendet wird

1. Gehen Sie zu Konfiguration > Unternehmen > Allgemeine Einstellungen und scrollen Sie nach unten zu Kundeneinstellungen.
2. Geben Sie in der Kopfzeile des Coupa P2P + Expenses-Pakets die OIDC-Client-ID und das Kundengeheimnis aus Schritt 1: Erstellen Sie ein OAuth-Konto in Coupa für NetSuite. Fügen Sie auch die Basis-URL Ihrer Coupa-Instanz in Form von https://{your_instance}.coupahost.comein.
   
   Hinweis

   Wenn eines der oben genannten drei Felder fehlt, verwendet NetSuite OAuth nicht zur Authentifizierung.

3. Um den API-Schlüssel aus Ihren bestehenden Coupa-Skripten zu entfernen, gehen Sie zu Anpassung > Skripte > Skripte.
   Die Seite Skripte wird geöffnet.
4. Unter SCRIPT FILEwählen Sie - Alle - und unterAUS BUNDLEwählen Sie 84306.
   
   Alle von dem Paket verwendeten Coupa P2P-Skripte werden angezeigt.
5. Wählen Sie den Link Bereitstellungen für ein Skript aus.
   
   Die Seite Skriptbereitstellungen wird geöffnet.
6. Wählen Sie Bearbeiten für die Bereitstellung und dann Parameteraus.
7. Geben Sie den Wert für den COUPA-API-Schlüsselan. Ändern Sie die COUPA-URLnicht.
   
8. Wiederholen Sie den Vorgang für jedes Coupa-Skript, das in Schritt 5 angezeigt wird.

Durch Entfernen des Coupa-API-Schlüssels aus jedem Skript kann NetSuite keine Schlüssel für den Zugriff auf Coupa verwenden und muss sich nun auf OAuth verlassen.

Schritt 4: Überprüfen Sie während des Testens die OAuth-Protokollierung für jedes Skript

1. Gehen Sie zuAnpassung > Skripte > Skripte.
   Die SeiteSkriptewird geöffnet.
2. UnterSCRIPT FILEwählen Sie- Alle -und unterAUS BUNDLEwählen Sie84306.
   
   Alle von dem Paket verwendeten Coupa P2P-Skripte werden angezeigt.
3. Wählen Sie den LinkBereitstellungenfür ein Skript aus.
   
   Die Seite Skriptbereitstellungen wird geöffnet.
4. Wählen SieBearbeitenfür die Bereitstellung und dannAusführungsprotokollaus.
   

Jedes Skript, das OAuth verwenden kann, aber noch nicht konfiguriert ist, hat ähnliche Verfallsmitteilungen wie oben gezeigt. Diese Benachrichtigungen werden ausgeblendet, wenn Sie OAuth vollständig korrekt implementiert haben. Dann wird stattdessen der OAuth-Antwortcode 200 angezeigt.

Zusätzliche Ressourcen

• API-Schlüsselablösung - FAQ
• Webinar vom 3. Mai 2022:OAuth-Migration für NetSuite-Paket-Kunden