QuickBooks Online-OAuth-Verbindungshandbuch für Jitterbit App Builder

Voraussetzungen

• Sie müssen über ein Intuit-Entwicklerkonto verfügen

Konfiguration in Intuit Developer

1. Melden Sie sich bei Ihrem Intuit Developer-Konto an.
2. Wählen Sie im Menü oben rechts auf der Seite Dashboard aus.
3. Erstellen Sie eine neue App, indem Sie auf die Schaltfläche + App erstellen klicken.
4. Wählen Sie Quickbooks Online and Payments als Plattform, für die Sie entwickeln möchten.

5. Geben Sie einen App-Namen an und wählen Sie die Bereiche für die APIs aus, auf die Sie zugreifen möchten.

   

6. Sobald die App erstellt wurde, navigieren Sie über das Menü auf der linken Seite zur Seite Schlüssel und Anmeldeinformationen. Hier finden Sie Ihre Client-ID und Ihr Client-Geheimnis. Notieren Sie sich diese Werte.

7. Auf derselben Seite konfigurieren Sie auch die Umleitungs-URI für den Sicherheitsanbieter auf der App Builder Instanz. Wenn Sie den Namen Ihres Anbieters kennen, können Sie dies konfigurieren. Wenn nicht, können wir später darauf zurückkommen. In diesem Beispiel lautet der Anbietername QBOnlineSupport. Das Format der Umleitungs URL sollte sein https://<App Builder-Instance>/signin-<Security-Provider-Name>.

   

Konfiguration in App Builder

Erstellen eines Sicherheitsanbieters

Nachdem Sie eine benutzerdefinierte OAuth-App im Intuit-Entwickler erstellt haben, erstellen Sie einen Sicherheitsanbieter in App Builder.

1. Navigieren Sie in der IDE zum Abschnitt Sicherheitsanbieter und erstellen Sie mit der Schaltfläche + Datenquellenauthentifizierung einen neuen Sicherheitsanbieter.
2. Geben Sie die folgenden Details an:
   • Name - Identifiziert den Sicherheitsanbieter und erscheint in der URL. Beispiel: QuickBooksOnline
   • Typ - OAuth
   • Authentifizierungstyp - OAuth
   • OAuth Grant - Autorisierungscode
   • OAuth-Client-Authentifizierung - Grundlegend
   • OAuth-Ressourcenauthentifizierung - Träger
   • Token-Besitzer - Benutzer
   • Weiterleitung bei Herausforderung - Wahr
3. Klicken Sie auf + Endpoints und konfigurieren Sie die folgenden 2 Endpoints:
   • Endpoint - https://appcenter.intuit.com/connect/oauth2
   • Token Endpoint - https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer
4. Klicken Sie auf + Anmeldeinformationen:
   • Typ - Client
   • Benutzername - Client-ID aus benutzerdefinierter OAuth-App
   • Passwort - Client-Geheimnis aus benutzerdefinierter OAuth-App
5. Klicken Sie im Abschnitt Eigenschaften auf die Schaltfläche + Eigenschaft, um eine neue Eigenschaft hinzuzufügen.
   • Der Wert sollte sein com.intuit.quickbooks.accounting.
6. Wenn Sie die Umleitungs-URI in der benutzerdefinierten OAuth-App im Intuit Developer-Portal für diesen Sicherheitsanbieternamen nicht konfiguriert haben, können Sie dies nun tun. (Schritt 7 aus dem obigen Abschnitt - Der Eigenschaftsname sollte Scopes sein.
7. Damit ist die Einrichtung des Sicherheitsanbieters abgeschlossen.

Erstellen Sie eine QuickBooks Online-Datenquelle

Nachdem Sie nun eine benutzerdefinierte OAuth-App und einen Sicherheitsanbieter erstellt haben, erstellen Sie die QuickBooks Online-Datenquelle.

1. Klicken Sie in der IDE auf Datenserver.
2. Klicken Sie auf die Schaltfläche + Server.

3. Geben Sie dem Server einen Namen und wählen Sie als Typ Quick Books Online.

   

4. Für den Instanznamen müssen wir zurück zum Intuit Developer-Portal navigieren. Den Instanznamen finden Sie auf der Sandbox-Seite Ihres Unternehmens.

5. Klicken Sie oben rechts im Intuit Developer-Portal auf das Symbol Benutzer und dann auf Sandbox.

6. Dadurch sollte die Seite Sandbox-Unternehmen verwalten geöffnet werden, auf der Sie dann auf Ihre Sandbox klicken können.

7. Klicken Sie auf der Sandbox-Seite oben rechts auf der Seite auf das Zahnradsymbol und dann auf Zusätzliche Informationen.

   

8. Hier finden Sie die Firmen-ID, die wir für den Instanznamen verwenden werden in App Builder.

9. Zurück zu App Builder, konfigurieren Sie den Instanznamen und fügen Sie den Sicherheitsanbieter hinzu, den wir im Abschnitt Sicherheitseinstellungen erstellt haben.

   

10. Nachdem wir nun die benutzerdefinierte OAuth-App, den Sicherheitsanbieter und die Datenquelle erstellt haben, können wir mit dem Testen beginnen.

11. Testen Sie die Verbindung mit der Schaltfläche Verbindung testen und aktivieren Sie das Feld Challenge zulassen.
12. Wenn alles richtig konfiguriert wurde, sollte eine Erfolgsmeldung angezeigt werden. Jetzt können Sie Tabellen importieren und mit dieser Datenquelle arbeiten.