Erstellen einer Exact Online-Datenbank mit einem vorhandenen OAuth-Zugriffs-/Aktualisierungstoken

Zur niederländischen Version

Auf ausgewählten Plattformen, einschließlich Exact Online und Twinfield, bietet Invantive Cloud die Möglichkeit, die OAuth-Autorisierung außerhalb von Invantive Cloud abzuschließen. Die daraus resultierenden Anmeldeinformationen können dann (später) verwendet werden, um eine Invantive Cloud-Datenbank für die betreffende Plattform zu registrieren.

Bei Exact Online war dies bis Release 25.0.147 nur auf Basis des OAuth-Autorisierungscodes möglich. Ein OAuth-Autorisierungscode läuft jedoch in der Regel nach kurzer Zeit ab, je nach Plattform variierend zwischen wenigen Sekunden und wenigen Minuten.

Die kurze maximale Zeitspanne zum Erstellen der Invantive Cloud-Datenbank ist kein Problem, wenn der Benutzer selbst – gegebenenfalls zusammen mit dem Endbenutzer – die Vorauthentifizierung mit dem passenden Invantive Cloud-Modul durchführt.

OEM-Partner möchten jedoch in der Lage sein, die Authentifizierung vollständig außerhalb von Invantive Cloud durchzuführen, zum Beispiel durch die Verwendung ihrer eigenen Webanwendung mit passendem Branding, und zudem zeitlich entkoppelt, sodass 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 Zugriffstoken (Access Token) und/oder ein Aktualisierungstoken (Refresh Token) außerhalb von Invantive Cloud zu generieren, zu speichern und auch Tage später noch zu verwenden, um eine Invantive Cloud-Datenbank auf Exact Online zu erstellen.

Auf diese Weise können OEM-Partner ihre Kunden besser unterstützen, indem sie die Invantive SQL-Technologie mit ihren eigenen Anwendungen kombinieren.

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

Folgen Sie diesen Schritten, um eine neue Exact Online-Datenbank basierend auf einem zuvor erworbenen Access-/Refresh-Token zu erstellen:

  • Besorgen Sie sich ein Exact Online-Zugriffstoken und das zugehörige Aktualisierungstoken über Ihre 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 aus:
  • Wählen Sie „Vorauthentifizierte Anmeldeinformationen“ (Preauthenticated Credentials).
  • Geben Sie die verwendete Client-ID, das Client-Secret und die Redirect-URL ein:
  • Wählen Sie Autorisierungscode (wie bisher) oder Zugriffstoken/Aktualisierungstoken:
  • Geben Sie das Exact Online-Zugriffstoken und das Aktualisierungstoken ein.
  • Wählen Sie „Weiter“.
  • Die Datenbank wurde erstellt und ist einsatzbereit:

Achtung 1! Bitte beachten Sie, dass ein Zugriffstoken bei Exact Online maximal 10 Minuten gültig ist und ein Aktualisierungstoken maximal 30 Tage. Der gesamte OAuth-Authentifizierungsablauf muss wiederholt werden, wenn das Aktualisierungstoken nicht innerhalb von 30 Tagen zur Erstellung der Invantive Cloud-Datenbank verwendet wurde.

Achtung 2! Bitte beachten Sie außerdem, dass ein Aktualisierungstoken nur einmal gegen ein neues Zugriffs- und Aktualisierungstoken eingetauscht werden kann. Exact hat diese Änderung 2022 eingeführt, und sie unterscheidet sich von vielen anderen OAuth-basierten Plattformen. Wurde ein Aktualisierungstoken bereits verwendet, um ein neues Zugriffstoken und Aktualisierungstoken abzurufen? Dann ist es nicht mehr nutzbar.