Inleiding
AFAS stapt over van de huidige Classic tokens naar OAuth. Gebruikt jouw organisatie een AFAS-koppeling met BCS Connect, dan heeft dit gevolgen voor de manier waarop die koppeling inlogt bij AFAS.
In dit artikel lees je wat er verandert, wat de planning is, wat we van je vragen en hoe de overstap verloopt.
AFAS stopt stapsgewijs met Classic tokens. Wij nemen contact met je op wanneer jouw omgeving moet worden aangepast. Deel je OAuth-gegevens alleen via een beveiligd kanaal.
Wat verandert er?
Voor jou verandert vooral de manier waarop de koppeling zich bij AFAS aanmeldt. De gegevens die worden uitgewisseld en de inrichting van je koppeling blijven in principe hetzelfde. Je hoeft dus geen nieuwe GetConnectoren of veldkoppelingen in te richten.
- De bestaande Classic token wordt vervangen door een OAuth-client-ID en client secret.
- BCS Connect gebruikt deze gegevens automatisch om verbinding te maken met AFAS.
- Je AFAS-gebruiker en de rechten daarvan blijven bepalen welke gegevens kunnen worden opgehaald.
- Vanaf Profit 9 is een client secret beperkt geldig, standaard 180 dagen. Je moet hem dus af en toe vernieuwen.
Wij stemmen de overstap met je af en laten weten wanneer jouw omgeving aan de beurt is.
Globale planning
| Periode | Wat gebeurt er? |
|---|---|
| Vanaf september 2026 | Bestaande Classic tokens krijgen een einddatum. |
| Zodra de benodigde platformupdate beschikbaar is | Wij testen de OAuth-koppeling eerst in test- en acceptatieomgevingen. |
| Uiterlijk vóór 1 maart 2027 | Wij adviseren om productieomgevingen over te zetten. Zo blijft er genoeg tijd voor controle en herstel. |
| 1 mei 2027 | Bestaande Classic tokens verlopen. Een koppeling die alleen nog een Classic token gebruikt, kan stoppen. |
| 31 augustus 2027 | Classic tokens werken niet meer. |
Wat vragen we van je?
- Controleer welke AFAS-omgeving(en) je gebruikt: productie, test en/of acceptatie.
- Controleer welke Profit-versie je gebruikt.
- Spreek af wie binnen je organisatie de AFAS-app connector beheert.
- Maak OAuth-gegevens aan, of zet de bestaande app connector om, wanneer wij dat aangeven.
- Deel de client-ID en client secret alleen via het afgesproken beveiligde kanaal.
- Geef ons per omgeving het omgevingsnummer en de verloopdatum van de client secret door.
- Zet een herinnering om de client secret op tijd te vernieuwen.
Stuur de client secret nooit via gewone e-mail, chat of een reactie in een ticket. Behandel hem als een wachtwoord en gebruik alleen het beveiligde kanaal dat met je is afgesproken.
Hoe verloopt de overstap?
- Wij laten je weten wanneer jouw omgeving kan worden overgezet.
- Jij levert de OAuth-gegevens veilig aan.
- Wij passen de manier van aanmelden van de bestaande koppeling aan. De gegevensmapping en planning blijven hetzelfde.
- Wij testen de verbinding en controleren of de juiste gegevens binnenkomen.
- Is de test gelukt? Dan schakel je de oude Classic token uit, of zet je de app connector definitief op OAuth.
- Samen controleren we de eerstvolgende geplande synchronisatie.
Schakel de oude Classic token pas uit nadat wij hebben bevestigd dat de nieuwe koppeling werkt. Anders stopt de synchronisatie.
Na de overstap: client secret vernieuwen
Vanaf Profit 9 verloopt een client secret standaard na 180 dagen, tenzij in AFAS een andere periode is ingesteld. Begin daarom minstens twee tot drie weken voor de verloopdatum met vernieuwen.
Door op tijd over te stappen en te vernieuwen, voorkom je dat de synchronisatie van nieuwe medewerkers, wijzigingen en uitdiensttredingen stilvalt.
Veelgestelde vragen
Moet ik nieuwe GetConnectoren aanmaken?
In de meeste gevallen niet. De bestaande GetConnectoren en veldkoppelingen blijven hetzelfde.
Moet een medewerker inloggen of toestemming geven?
Nee. De koppeling werkt automatisch met de AFAS-gebruiker die aan de app connector is gekoppeld.
Wat gebeurt er als de client secret verloopt?
Dan kan de synchronisatie stoppen. Je levert dan een nieuwe secret aan via het beveiligde kanaal, en wij verwerken die in de koppeling.
Kunnen productie, test en acceptatie dezelfde OAuth-gegevens gebruiken?
Nee, elke AFAS-omgeving heeft eigen gegevens. Gebruik altijd de client-ID en client secret die bij die omgeving horen.
Heb je nog een vraag? Stuur een e-mail naar support.plek@bcs-hr.com.