Op geselecteerde platformen waaronder Exact Online en Twinfield biedt Invantive Cloud de mogelijkheid om de OAuth autorisatie buiten Invantive Cloud te doorlopen. De resulterende credentials kunnen dan (later) gebruikt worden om een Invantive Cloud-database voor het desbetreffende platform te registreren.
Op Exact Online was dit tot release 25.0.147 enkel mogelijk op basis van de OAuth autorisatiecode. Een OAuth autorisatiecode verliest echter zijn geldigheid meestal na een beperkte tijd, afhankelijk van het platform, varierend tussen enkele seconden en enkele minuten.
De korte maximale duur om de Invantive Cloud-database aan te maken is geen probleem als de gebruiker zelf - eventueel samen met eindgebruiker - de pre-authenticatie uitvoert met de bijpassende Invantive Cloud-module.
Echter, een wens van OEM-partners is om de authenticatie volledig buiten Invantive Cloud te kunnen laten plaatsvinden, bijvoorbeeld door een eigen webapplicatie met bijpassende branding, en mede losgekoppeld in tijd, waardoor de database pas uren of dagen later aangemaakt wordt.
Vanaf release 25.0.147 is het voor Exact Online-ontwikkelaars mogelijk om een access token en/of refresh token buiten Invantive Cloud te generen, vast te leggen en dagen later alsnog te gebruiken om een Invantive Cloud-database op Exact Online te maken.
Op deze wijze kunnen OEM-partners hun relaties beter helpen door de combinatie van Invantive SQL-techniek en hun eigen applicaties.
Hoe registreer ik een Exact Online-database met access/refresh token?
Doorloop de volgende stappen om een nieuwe Exact Online-database te maken op basis van eerder verworven access/refresh token:
- Verwerf een Exact Online-access token en gerelateerd refresh token via een eigen webapplicatie, Invantive Cloud-preauthenticatie of een andere wijze.
- Ga naar het toevoegen van een database in Invantive Cloud via
https://cloud.invantive.com/app/setup/databases/new/exactonline. - Kies het gewenste land:
- Kies “Preauthenticated Credentials”.
- Vul de gebruikte client ID, client secret en redirect URL in:
- Kies voor autorisatiecode (zoals voorheen) of access token / refresh token:
- Vul het Exact Online access token en refresh token in.
- Kies “Continue”.
- De database is aangemaakt en meteen bruikbaar:
Attentie 1! Merk dat een access token op Exact Online maximaal 10 minuten geldig is, en een refresh token maximaal 30 dagen. De gehele OAuth authenticatieflow dient nogmaals doorlopen te worden indien het refresh token niet binnen 30 dagen gebruikt is om de Invantive Cloud-database aan te maken.
Attentie 2! Merk ook op dat een refresh token maar 1x ingewisseld mag worden voor een nieuw access en refresh token. Deze wijziging heeft Exact doorgevoerd in 2022, en is afwijkend van veel andere OAuth-gebaseerde platforms. Is een refresh token al een keer gebruikt om een nieuw access token en refresh token op te halen? Dan is het niet meer bruikbaar.