Overstappen van classic tokens op OAuth

Het authenticatietype OAuth wordt de standaard voor je eigen app connectoren. Vanaf 1 september 2027 is het niet meer mogelijk om eigen app connectoren met een classic token te gebruiken. Heb je nog app connectoren op basis van classic tokens? Stap zo snel mogelijk over op app connectoren op basis van OAuth.

Lees eerst de themapagina Maak je koppelingen klaar voor OAuth.

Inhoud

  • Planning
  • Migratie van Classic app connector naar de methode OAuth
  • Nieuwe app connector met de methode OAuth
  • App_Cnr Eigen app connector inrichten (groep)
  • Nieuwe app connector met de methode OAuth

Planning

  • In september 2026 krijgen bestaande classic tokens een einddatum van 1 mei 2027. Hierna kun je deze tokens niet meer gebruiken. Wel kun je nog nieuwe classic tokens met een beperkte geldigheidsduur aanmaken (uiterlijk tot 31 augustus 2027).
  • App connectoren die 6 maanden of langer niet zijn gebruikt, worden geblokkeerd.
  • Zorg ervoor dat je app connectoren op basis van een classic token uiterlijk op 31 augustus 2027 hebt overgezet op OAuth. Hiervoor is vanaf Profit 9 een handige overstapwizard beschikbaar. Mocht je eerder willen overstappen, zie dan de onderstaande beschrijvingen.

    Let op:

    Omdat je dit waarschijnlijk met een externe koppelpartner moet regelen, is het aan te raden de overstap ruim voor 31 augustus 2027 te maken. Zo weet je zeker dat de koppelingen blijven werken.

Migratie van Classic app connector naar de methode OAuth

In dit artikel is gave nieuwe functionaliteit verwerkt die beschikbaar is vanaf Profit 9.

Voor het overzetten van 'classic' app connectoren gebruik je de handige migratiewizard. Hierdoor blijft de app connector met de instellingen (zoals gekoppelde connectoren en IP-restricties) behouden. De Oauth-inrichting moet je natuurlijk wel doen. Het belangrijkste hierbij is de keuze voor een bepaald applicatietype: Systeemservice, Webapplicatie, Single-page-application (SPA) of Mobiele en desktopapplicatie. Lees eerst de informatie op de pagina Eigen app connector inrichten o.b.v. OAuth.

Overleg met je koppelpartner welk applicatietype je gaat gebruiken en hoe je de overstap en het testen van de nieuwe app connector gaat aanpakken.

Bij deze migratie kun je het overstappen op het type authenticatie Hybride (dit ondersteunt zowel classic tokens als OAuth). Hierbij blijven de classic tokens ook na de migratie werken (t/m 31 augustus 2027).

Koppeling van de app connector met de gebruikersgroep:

Een classic app connector heeft altijd een gekoppelde gebruikersgroep. Deze kan worden meegenomen naar de nieuwe app connector op basis van OAuth, dit hangt af van de geselecteerde authenticatiemethode:

  • Single-page-application (SPA) of Mobiele en desktopapplicatie

    De gebruikersgroep van de classic app connector blijft behouden. In de migratietool kun je een andere gebruikersgroep koppelen.

  • Webapplicatie

    Bij een webapplicatie op basis van de Authorization code flow blijft de gebruikersgroep van de classic app connector behouden. In de migratietool kun je een andere gebruikersgroep koppelen.

    Bij een webapplicatie op basis van de Client credentials flow geldt hetzelfde als bij de Systeemservice, zie hieronder.

  • Systeemservice

    Je kunt de classic app connector alleen omzetten naar een systeemservice als de classic app connector gekoppeld is aan een gebruikersgroep die handmatig gevuld wordt met gebruikers. Als dit het geval is, controleert Profit of deze gebruikersgroep een systeemgebruiker bevat. Als dit niet zo is, dan maakt Profit een systeemgebruiker aan op basis van de naam van de app connector.

    Voorbeeld:

    Je wilt aan de slag met de classic app connector Kassasysteem in omgeving 12345. Deze is gekoppeld aan de gebruikersgroep Kassasysteem, maar deze gebruikersgroep heeft geen systeemgebruiker.

    Bij het omzetten naar OAuth maakt Profit de systeemgebruiker 12345.Kassasysteem aan. Deze gebruiker wordt gekoppeld aan de gebruikersgroep Kassasysteem.

    Als de classic app connector niet gekoppeld is aan een gebruikersgroep die handmatig gevuld wordt, dan verschijnt de melding:

    Kan de systeemgebruiker niet toevoegen aan de gebruikersgroep 'PR-152'. Deze groep wordt gevuld op basis van selectie of functie. Kies een andere gebruikersgroep of wijzig de bestaande gebruikersgroep en probeer het opnieuw.

    Voorbeeld:

    De classic app connector is gekoppeld aan de gebruikersgroep Medewerkers. Deze gebruikersgroep wordt gevuld met gebruikers op basis van een selectie (dit zie je in de Autorisatie tool in de eigenschappen van de gebruikersgroep). Als je deze app connector wilt omzetten in een systeemservice, dan volgt de melding.

    Hoe los je dit op? Koppel de eigenschappen van de classic app connector en selecteer een gebruikersgroep die handmatig gevuld wordt. Een andere mogelijkheid: Ga naar de Autorisatie tool en zorg dat de gebruikersgroep handmatig gevuld wordt. Dit kan uiteraard gevolgen hebben voor de toepassing van deze gebruikersgroep op andere plaatsen in Profit!

Classic app connector migreren:

  1. Ga naar: Algemeen / Beheer / App connector.
  2. Filter op het type Onderhoud door klant en het Authenticatietype Classic token:

  3. Selecteer de te migreren app connector.
  4. Klik op: Acties / Wijzig authenticatiemethode.
  5. Selecteer de authenticatiemethode.

    Let op:

    Bij de authenticatiemethode Hybride combineer je classic token met OAuth. Je oude koppeling op basis van tokens blijft dan werken.

    Bij de authenticatiemethode OAuth vervalt de authenticatie op basis van classic tokens direct na het voltooien van de wizard. De koppeling werkt dan niet meer, tot je OAuth hebt ingericht

  6. Klik op: Volgende.
  7. Selecteer het type authenticatie. Dit bepaalt de mogelijkheden in de rest van de Oauth-inrichting.
  8. Rond de inrichting af.

Nieuwe app connector met de methode OAuth

App connectoren met het authenticatietype Classic token kunnen niet meer gebruikt worden na 31 augustus 2027. Maak hiervoor nieuwe app connectoren aan.

In dit artikel is gave nieuwe functionaliteit verwerkt die beschikbaar is vanaf Profit 9.

We werken momenteel hard aan de documentatie van dit onderdeel.

Vanaf Profit 9 hoef je geen nieuwe App Connector aan te maken. Wij raden daarom aan om te wachten met het maken van nieuwe App Connectoren. Vanaf Profit 9 zet je de App Connector om van Classic token naar Hybride of OAuth en doorloop je de OAuth-inrichting. De bestaande inrichting, zoals gekoppelde connectoren en IP-restricties, blijft dan behouden. Bij de overstap op Hybride blijven ook de gebruikerstokens behouden.

GEBRUIK DE ONDERSTAANDE STAPPEN ALLEEN ALS JE VÓÓR PROFIT 9 AL WILT OVERSTAPPEN.

Overleg met je koppelpartner welke OAuth-methode je gaat gebruiken (Authorization code flow of Client credentials). Bekijk ook hoe je de overstap en het testen van de nieuwe app connector gaat aanpakken.

Welke gegevens zet je over:

Je kijkt hoe de bestaande app connectoren zijn ingericht.

  1. Ga naar: Algemeen / Beheer / App connector.
  2. Filter op het type Onderhoud door klant en het Authenticatietype Classic token:

  3. Open de eigenschappen van een app connector.
  4. Ga naar het tabblad: Algemeen.
  5. Noteer de gekoppelde gebruikersgroep.
  6. Ga naar het tabblad: Gebruikerstokens.
  7. Noteer de gebruikers waarvoor een token is uitgedeeld.
  8. Noteer welke connectoren gekoppeld zijn op de tabbladen UpdateConnectoren, GetConnectoren en Connectoren.
  9. Noteer eventuele IP-restricties en kijk welke client-certificaten gekoppeld zijn.
  10. Sluit de eigenschappen van de app connector.

App connector van type OAuth aanmaken:

Let op:

Hieronder zie je enkele stappen die specifiek voor de overstap van belang zijn. Neem alle informatie op de pagina Eigen app connector inrichten in vogelvlucht (OAuth token) door voor je begint met het aanmaken van een nieuwe app connector.

  1. Maak een nieuwe app connector aan, gebaseerd op het authenticatietype OAuth.
  2. Selecteer de gebruikersgroep die je eerder genoteerd hebt.
  3. Selecteer bij Type OAuth flow de gewenste methode.
  4. Selecteer Gebruik bestaande gebruiker en selecteer de gebruiker die je eerder genoteerd hebt.
  5. Selecteer de gewenste Get- en UpdateConnectoren in de volgende stappen.

    Koppel de gewenste GetConnectoren aan de app connector. Met een GetConnector kan een externe applicatie gegevens ophalen uit Profit. Alleen de gekoppelde GetConnectoren kunnen in combinatie met deze app connector worden aangeroepen door een externe applicatie.

    Het koppelen kan op twee manieren:

    • Handmatig. Klik op Nieuw. Vink de gewenste GetConnectoren aan en klik op Voltooien om deze te koppelen.
    • Via een import. Klik op Acties / Importeren en importeer de GetConnectoren, bijvoorbeeld GetConnectoren die je eerder van een partner gekregen hebt.

    Koppel de gewenste UpdateConnectoren aan de app connector. Met een UpdateConnector kan een externe applicatie gegevens aanmaken, wijzigen of verwijderen in Profit. Alleen de gekoppelde UpdateConnectoren kunnen in combinatie met deze app connector worden aangeroepen door een externe applicatie.

  6. 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.

  7. De 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.

App_Cnr Eigen app connector inrichten (groep)

Bij de client credentials flow wordt altijd een nieuwe gebruikersgroep met een systeemgebruiker aangemaakt. De naam van de nieuwe gebruikersgroep en systeemgebruiker is gebaseerd op de naam van de nieuwe app connector.

Nieuwe app connector met de methode OAuth

App connectoren met het authenticatietype Hybride token blijven na 31 augustus 2027 in gebruik. Wel moet je checken of deze app connectoren classic tokens bevatten.

Welke gegevens zet je over:

  1. Ga naar: Algemeen / Beheer / App connector.
  2. Filter op het type Onderhoud door klant en het Authenticatietype Hybride:

  3. Open de eigenschappen van een hybride app connector.
  4. Ga naar het tabblad: Gebruikerstokens.
  5. Je ziet alleen gebruikers waarvoor een classic token is uitgedeeld. Zorg dat deze gebruikers voortaan worden geauthenticeerd via OAuth.
  6. Als de authenticatie via OAuth helemaal goed loopt, verwijder je de classic tokens.