Upgrade Classic Token naar OAuth Token

Het is mogelijk om een bestaande Classic Token in STKKR te upgraden naar een OAuth-token. Op deze manier worden in één keer alle koppelingen die aan deze token hangen omgezet naar OAuth.

Om dit te doen, moet je eerst in AFAS een nieuwe App Connector met OAuth aanmaken (zie Stap 1 hieronder).
Daarna kun je in STKKR de bestaande token upgraden (zie Stap 2 hieronder).

Stap 1: App connector met OAuth aanmaken in AFAS:

1. Ga -in AFAS- naar: Algemeen / Beheer / App connector.
2. Klik op: Nieuw.
3. Vul de omschrijving in.
4. Selecteer OAuth bij het veld Authenticatieype.
5. Selecteer de autorisatiegroep waarvan de leden de app connector mogen gebruiken om zich aan te melden via de Authorisation code flow.
6. Selecteer Client credentials bij Type OAuth flow.
7. Je selecteert de gebruiker die zich mag aanmelden bij de api.
8. Selecteer de gewenste Get- en UpdateConnectoren in de volgende stappen.
9. In het laatste scherm zie je de OAuth client id en de OAuth client secret.
   Kopieer beide waarden en sla deze op een veilige plaats op.
   Let op:
   Na het voltooien van de wizard kun je OAuth client id nog wel raadplegen via de eigenschappen van de app connector, maar niet meer wijzigen.
   OAuth client secret kun je niet meer raadplegen EN niet meer wijzigen. Wel kun je een nieuwe OAuth client secret genereren, deze vervangt dan de oude. Als je een nieuwe OAuth client secret genereert, kan de oude niet meer gebruikt worden.
10. Klik op: Voltooien.

Stap 2: Upgrade bestaande Classic Token naar een OAuth token:

1. Klik -in STKKR- op de ‘aanpassen’ (potloodje) knop bij een bestaande Classic Token.
2. Klik dan op de knop ‘Upgraden naar OAuth‘.
3. Vul in het popup-scherm de velden OAuth Client ID en OAuth Cleint Secret in.
4. Gebruik de Token testen knop om de verbinding te testen:
   
5. Indien er connectie gemaakt kan worden dan verschijnt er een ‘Gefeliciteerd!’ melding.
6. Tevens wordt gecontroleerd of deze App connector minimaal dezelfde rechten heeft als de Classic Token. De Get- en UpdateConnectoren die missen worden getoond. Na het toevoegen van deze connectoren in AFAS kan opnieuw de Token testen knop gebruikt worden.
7. Kies voor Upgrade bevestigen om de nieuwe keys te gebruiken (deze zijn na deze stap nog niet definitief opgeslagen!).
8. Kies voor Token opslaan om de nieuwe gegevens definitief op te slaan.