Gebruik je een AFAS-koppeling in Simplex Flow? Dan is het belangrijk om tijdig over te stappen van Classic Token naar OAuth. AFAS maakt OAuth de nieuwe standaard voor authenticatie van App Connectoren. Classic tokens worden vanaf 31 augustus 2027 niet meer ondersteund.
Waarom deze wijziging?
Tot nu toe maakten veel koppelingen gebruik van een Classic Token. OAuth werkt met tijdelijke toegangstokens en biedt meer controle over:
- Wie toegang krijgt
- Welke gegevens toegankelijk zijn
- Hoe lang de toegang geldig blijft
Volgens AFAS sluit OAuth beter aan op moderne beveiligingsstandaarden.
Wat betekent dit voor Simplex Flow?
De technische ondersteuning voor OAuth is beschikbaar binnen Simplex Flow. Jij dient zelf de overstap uit te voeren. De overstap bestaat uit twee onderdelen:
- De AFAS App Connector gereedmaken voor OAuth.
- De OAuth-gegevens invoeren in Simplex Flow.
Stap 1: Controleer het type App Connector
Ga in AFAS naar:
Algemeen → Beheer → App Connector
Controleer het authenticatietype van de bestaande App Connector.
Situatie 1: Authenticatietype = Classic Token
Gebruik je een Classic Token App Connector? Dan moet je:
- Een nieuwe App Connector aanmaken met OAuth.
- De instellingen van de huidige App Connector overnemen. Let op de tabbladen GetConnectoren, UpdateConnectoren en “Connectoren”
- De nieuwe OAuth-gegevens gebruiken in Simplex Flow.
- De oude App Connector pas verwijderen nadat alles succesvol getest is.
Dit is de situatie die voor de meeste klanten van toepassing is.
Situatie 2: Authenticatietype = Hybride
Gebruik je een Hybride App Connector?
Dan hoef je geen nieuwe App Connector aan te maken maar moet je wel de Simplex Flow inrichting doen.
Stap 2: Nieuwe OAuth App Connector aanmaken
Heb je een specifieke AppConnector o.b.v. Classic token? Maak een nieuwe App Connector aan in AFAS.
Kies hierbij:
- Authenticatietype: Hybride
- OAuth Flow: Client Credentials
- Automatisch token genereren: Ja
Voor de meeste systeemkoppelingen is de Client Credentials Flow de beste keuze. Dit is ook de aanbevolen methode voor Simplex Flow omdat hierbij geen handmatige gebruiker hoeft in te loggen. Andere applicaties van Simplex zullen soms de andere methode gebruiken; dit geven we daar dan specifiek aan.
Stap 3: OAuth-gegevens vastleggen
Na het aanmaken van de App Connector genereert AFAS de benodigde OAuth-gegevens.
Bewaar deze Client ID en Client Secret tijdelijk op een veilige plek. Deze zijn nodig voor de configuratie binnen Simplex Flow.
Stap 4: OAuth configureren in Simplex Flow
Bekijk nu de bijbehorende instructievideo voor Flow.
In de video wordt uitgelegd hoe je:
- De OAuth-app selecteert
- De Client ID invoert
- De Secret invoert
- De verbinding valideert
- De Flow opnieuw activeert
Stap 5: Test de koppeling
Controleer altijd:
- Kan de Flow gegevens ophalen uit AFAS?
- Kunnen Update Connectors nog gegevens verwerken?
- Werken geplande en automatische Flows correct?
Wij adviseren om de nieuwe OAuth-koppeling volledig te testen voordat de oude verbinding wordt verwijderd.
Belangrijk: uiterste overstapdatum
AFAS heeft aangekondigd dat:
- Bestaande Classic Tokens een einddatum krijgen.
- Classic Tokens uiterlijk 31 augustus 2027 niet meer werken.
- Oude ongebruikte App Connectoren na langdurige inactiviteit kunnen worden geblokkeerd.
Wacht daarom niet tot het laatste moment met de overstap.
Veelgestelde vragen
Moet ik direct overstappen?
Nee, maar AFAS adviseert om de overstap ruim vóór 31 augustus 2027 te plannen zodat er voldoende tijd is om te testen.
Werkt Simplex Flow al met OAuth?
Ja. Simplex Flow ondersteunt OAuth-authenticatie. De resterende stap is het inrichten van de OAuth App Connector in AFAS en het vastleggen van de OAuth-gegevens in Flow.
Welke OAuth-methode gebruik ik?
Voor vrijwel alle automatische koppelingen tussen AFAS en Simplex Flow gebruik je Client Credentials Flow.