Exact Online-Datenbank erstellen mit bereits vorhandenem OAuth Access Token / Refresh Token

Zur englischen Version gehen

Auf ausgewählten Plattformen, darunter Exact Online und Twinfield, bietet Invantive Cloud die Möglichkeit, die OAuth-Authentifizierung außerhalb von Invantive Cloud durchzuführen. Die resultierenden Anmeldedaten können dann (später) verwendet werden, um eine Invantive Cloud-Datenbank für die entsprechende Plattform zu registrieren.

Bei Exact Online war dies bis Release 25.0.147 nur auf Basis des OAuth-Autorisierungscodes möglich. Ein OAuth-Autorisierungscode verliert jedoch in der Regel nach kurzer Zeit seine Gültigkeit, abhängig von der Plattform, variierend zwischen wenigen Sekunden und wenigen Minuten.

Die kurze maximale Dauer zur Erstellung der Invantive Cloud-Datenbank ist kein Problem, wenn der Benutzer selbst — eventuell zusammen mit dem Endbenutzer — die Vor-Authentifizierung mit dem entsprechenden Invantive Cloud-Modul durchführt.

Ein Wunsch von OEM-Partnern ist es jedoch, die Authentifizierung vollständig außerhalb von Invantive Cloud durchführen zu können, beispielsweise durch eine eigene Webanwendung mit passendem Branding, und auch zeitlich entkoppelt, so dass die Datenbank erst Stunden oder Tage später erstellt wird.

Ab Release 25.0.147 ist es für Exact Online-Entwickler möglich, ein Access-Token und/oder Refresh-Token außerhalb von Invantive Cloud zu generieren, zu erfassen und Tage später dennoch zu verwenden, um eine Invantive Cloud-Datenbank auf Exact Online zu erstellen.

Auf diese Weise können OEM-Partner ihren Kunden besser helfen, indem sie die Kombination von Invantive SQL-Technik und ihren eigenen Anwendungen nutzen.

Wie registriere ich eine Exact Online-Datenbank mit Access-/Refresh-Token?

Führen Sie die folgenden Schritte aus, um auf Basis eines zuvor erworbenen Access-/Refresh-Tokens eine neue Exact Online-Datenbank zu erstellen:

  • Erwerb eines Exact Online-Access-Tokens und eines dazugehörigen Refresh-Tokens über eine eigene Webanwendung, die Invantive Cloud-Vorauthentifizierung oder eine andere Methode.
  • Gehen Sie zum Hinzufügen einer Datenbank in Invantive Cloud über https://cloud.invantive.com/app/setup/databases/new/exactonline.
  • Wählen Sie das gewünschte Land:
  • Wählen Sie „Preauthenticated Credentials“.
  • Geben Sie die verwendete Client-ID, das Client-Geheimnis und die Redirect-URL ein:
  • Wählen Sie den Autorisierungscode (wie zuvor) oder Access-/Refresh-Token aus:
  • Tragen Sie das Exact Online Access-Token und das Refresh-Token ein.
  • Wählen Sie „Continue“.
  • Die Datenbank ist erstellt und sofort nutzbar:

Achtung 1! Beachten Sie, dass ein Access-Token bei Exact Online maximal 10 Minuten gültig ist und ein Refresh-Token maximal 30 Tage. Der gesamte OAuth-Authentifizierungsablauf muss erneut durchlaufen werden, wenn das Refresh-Token nicht innerhalb von 30 Tagen verwendet wurde, um die Invantive Cloud-Datenbank zu erstellen.

Achtung 2! Beachten Sie auch, dass ein Refresh-Token nur einmal gegen ein neues Access- und Refresh-Token eingetauscht werden darf. Diese Änderung hat Exact im Jahr 2022 durchgeführt und weicht von vielen anderen OAuth-basierten Plattformen ab. Wurde ein Refresh-Token bereits einmal verwendet, um ein neues Access-Token und Refresh-Token abzurufen, ist es nicht mehr verwendbar.