invantive documentation
Invantive Support ForumsAanmelden / Inschrijven

Preauthenticate Exact Online

Voer de volgende stappen uit om een Exact Online-applicatie vooraf te authenticeren:

Voorbereiding

Voer de volgende stappen uit:

  • Ga naar het Exact App Center: De startpagina van het Exact App Center in een browser, met een zoekvak en de nieuwste apps zoals Invantive Bridge.
  • Kies het juiste land.
  • Inloggen: De inlogpagina van Exact Online, bereikbaar via het Exact App Center, met velden voor gebruikersnaam en wachtwoord.
  • Zorg er voor de volgende stap voor dat je een Exact Online App Center-abonnement hebt. Dit is een gratis abonnement waarmee je je eigen API-sleutels kunt registreren.
  • Om je voor zo’n account te registreren, ga je naar https://apps.exactonline.com
  • Scroll naar beneden en zoek naar "Bent u een app-ontwikkelaar?", klik vervolgens op "Meer informatie". De Exact App Center-pagina met het gedeelte "Bent u een app-ontwikkelaar?" en de link "Meer informatie".
  • Kies op de volgende pagina ‘Stap 1: Registreren’ en klik op de knop ‘Je app registreren’. De Exact App Center-pagina met stap 1, "Registreer" en de knop om een app te registreren.
  • Op de volgende pagina ziet u een registratieformulier; u kunt onderaan het formulier ‘Inloggen’ kiezen. Het registratieformulier van het Exact Online App Center met de link "Inloggen" onderaan.
  • Controleer nu het volgende: "Abonnement beheren" moet zijn aangevinkt onder de Toekenningsrechten voor de gebruiker. Je kunt dit controleren op de pagina ‘Rechten toekennen’ voor de gebruiker: Stamgegevens > Overzicht | Gebruikers > Gebruiker > Rechten. Het Exact Online-bedrijfsmenu met "Stamgegevens" gemarkeerd onder "Huidig bedrijf beheren". Het Exact Online-menu "Gebruikers" met het item "Overzicht" gemarkeerd door een rood kader. De Exact Online-gebruikerslijst met het item van één gebruiker gemarkeerd door een rood kader. Het Exact Online-menu „Monitor“ met het item „Rechten“ gemarkeerd door een rood kader. De Exact Online-rechtenlijst op het tabblad „Algemeen“, met „Abonnement beheren“ gemarkeerd door een rood kader.
  • Als je teruggaat naar https://apps.exactonline.com, zou er een nieuwe optie beschikbaar moeten zijn:
  • Kies ‘Mijn apps beheren’ of ‘API-sleutels registreren’: De startpagina van Exact App Center na het inloggen, met de link "Mijn apps beheren" in de bovenste balk.
  • Kies de app waarmee je een gebruiker vooraf wilt authenticeren.
  • Klik op ‘Weergeven’ naast het clientgeheim.
  • Noteer de volgende waarden zoals hieronder weergegeven: client-ID, client-secret en omleidings-URI.
  • Wanneer je je vooraf authenticeert voor gebruik met Exact Online via een Invantive-product en het past binnen je beveiligingsbeleid om een extern aangeleverde callback-URL te gebruiken, kun je https://exactonlineclientredirect.invantive.com gebruiken. In feite ondersteunen de meeste Invantive-producten elke callback-URL, aangezien ze zonder browseromgeving draaien. Het dialoogvenster "Een productie-app registreren" van het Exact App Center, met app-naam, omleidings-URI en geaccepteerde voorwaarden. Autorisatiegegevens voor Exact Online-app Autorisatiegegevens voor Exact Online-app

Pre-authenticatie

Voer vervolgens de voorauthenticatie van de applicatie uit:

  • Open Invantive Cloud.
  • Kies "Preauthenticate" in het menu.
  • Lees het formulier door en vul het in zoals weergegeven, met behulp van de eerder genoteerde waarden: Het formulier "Preauthenticate Exact Online Application" van Invantive Cloud, met client-ID, omleidings-URI en bevestigingen.
  • Wanneer u een omleidings-URI gebruikt die afwijkt van cloud.invantive.com, vergeet dan niet het vakje "Afwijkende omleidings-URI" aan te vinken. In dat geval verschijnt er een extra formulier met de titel "Exchange Code".
  • Klik op de knop "Preauthenticate".
  • Exact Online vraagt je nu om je te authenticeren: Het Exact Online-inlogformulier met velden voor gebruikersnaam en wachtwoord, weergegeven tijdens de voorauthenticatie.
  • Na succesvolle authenticatie vraagt Exact Online u om de toegang van de applicatie tot uw Exact Online-gegevens te authenticeren met dezelfde rechten als de gebruiker: De toestemmingspagina van Exact Online waarin wordt gevraagd of een app toegang mag krijgen tot de Exact Online-gegevens, met "Toestaan" en "Weigeren".
  • Klik op "Toestaan".
  • De browser wordt doorgestuurd naar de omleidings-URI.
  • De URL bevat essentiële informatie voor preauthenticatie.
  • Klik in de URL en kopieer de volledige URL naar het klembord: De adresbalk van de browser toont de omleidings-URI met een codeparameter, die moet worden gekopieerd.
  • Wissel de URL in voor een OAuth2-vernieuwingstoken door deze in het veld "Code Return URL" te plakken en druk op de knop "Exchange". Het Invantive Cloud-formulier "Retrieve Refresh Token from Authorization Code", met een veld voor de retour-URL en een knop.
  • De pagina die vervolgens wordt weergegeven, toont de instellingen voor het vooraf authenticeren van je applicatie: De resultaten van de Invantive Cloud-preauthenticatie, met het vernieuwingstoken, de verbindingsstring en de instellingen-XML.
  • Het veld "Refresh Token" bevat het OAuth2-vernieuwingstoken.
  • De velden „Inhoud settings.json” en „Inhoud settings.xml” bevatten elk dezelfde Invantive-databasedefinitie, in de twee hieronder beschreven formaten. Beide bevatten het clientgeheim en het vernieuwingstoken, dus behandel ze als inloggegevens.

Vanaf release 27.0

Het veld "Inhoud settings.json" bevat een Invantive-databasedefinitie voor opslag als een bestand met de naam settings-<NAME>.json in %USERPROFILE%\invantive, zoals beschreven in Settings.

Tot en met release 26.0

Het veld "Inhoud settings.xml" bevat dezelfde database-definitie voor opslag als een bestand met de naam settings-<NAME>.xml in %USERPROFILE%\invantive, zoals beschreven in Settings.xml. Sla slechts één van de twee op: vanaf release 26.1 heeft een settings-<NAME>.json-bestand voorrang op een settings-<NAME>.xml-bestand met dezelfde naam.

Release Notes