Maak een Exact Online-database met een bestaande OAuth access token/refresh token

Ga naar de Nederlandse versie

Op bepaalde platformen, waaronder Exact Online en Twinfield, biedt Invantive Cloud de mogelijkheid om de OAuth-autorisatie buiten Invantive Cloud om te voltooien. De resulterende inloggegevens kunnen vervolgens (later) worden gebruikt om een Invantive Cloud-database voor het betreffende platform te registreren.

Bij Exact Online was dit, tot release 25.0.147, alleen mogelijk op basis van de OAuth-autorisatiecode. Een OAuth-autorisatiecode verloopt echter meestal na een beperkte tijd, afhankelijk van het platform, variërend van enkele seconden tot enkele minuten.

De korte maximale duur voor het aanmaken van de Invantive Cloud-database is geen probleem als de gebruiker zelf – eventueel samen met de eindgebruiker – de voorafgaande authenticatie uitvoert met de bijbehorende Invantive Cloud-module.

OEM-partners willen echter de authenticatie volledig buiten Invantive Cloud om kunnen uitvoeren, bijvoorbeeld door gebruik te maken van hun eigen webapplicatie met bijpassende huisstijl, en ook losgekoppeld in de tijd, zodat de database pas uren of dagen later wordt aangemaakt.

Vanaf release 25.0.147 is het voor Exact Online-ontwikkelaars mogelijk om buiten Invantive Cloud om een access token en/of refresh token te genereren, deze vast te leggen en dagen later alsnog te gebruiken om een Invantive Cloud-database op Exact Online aan te maken.

Op deze manier kunnen OEM-partners hun klanten beter helpen door Invantive SQL-technologie te combineren met hun eigen applicaties.

Hoe registreer ik een Exact Online-database met een access/refresh token?

Volg deze stappen om een nieuwe Exact Online-database aan te maken op basis van een eerder verkregen access/refresh token:

  • Verkrijg een Exact Online access token en bijbehorend refresh token via uw eigen webapplicatie, Invantive Cloud-voorauthenticatie of een andere methode.
  • Ga naar het toevoegen van een database in Invantive Cloud via https://cloud.invantive.com/app/setup/databases/new/exactonline.
  • Selecteer het gewenste land:
  • Kies “Preauthenticated Credentials”.
  • Voer de gebruikte client-ID, client secret en redirect-URL in:
  • Selecteer autorisatiecode (zoals voorheen) of access token / refresh token:
  • Voer het Exact Online access token en refresh token in.
  • Selecteer “Doorgaan”.
  • De database is aangemaakt en gereed voor gebruik:

Let op 1! Houd er rekening mee dat een access token bij Exact Online maximaal 10 minuten geldig is, en een refresh token maximaal 30 dagen. De volledige OAuth-authenticatieflow moet opnieuw worden doorlopen als het refresh token niet binnen 30 dagen is gebruikt om de Invantive Cloud-database aan te maken.

Let op 2! Houd er ook rekening mee dat een refresh token slechts één keer kan worden ingewisseld voor een nieuw access en refresh token. Exact heeft deze wijziging in 2022 doorgevoerd, en dit wijkt af van veel andere OAuth-gebaseerde platformen. Is een refresh token al gebruikt om een nieuw access token en refresh token op te halen? Dan is het niet langer bruikbaar.