Eigen app connector inrichten o.b.v. OAuth (vanaf Profit 9)

Je kunt Profit-connectoren aanroepen op basis van OAuth 2.1. OAuth is de wereldwijde standaard om externe applicaties veilig toegang te geven tot een ander systeem, zonder dat je wachtwoorden of vaste sleutels uitwisselt. AFAS ondersteunt twee methoden: de Client credentials flow en de Authorization code flow. AFAS werkt hierbij volgens standaarden, je vindt online (veel) meer informatie over de toegepaste technieken en het bouwen van een koppeling met deze technieken.

Een app connector kan gebaseerd zijn op classic tokens in plaats van OAuth, maar deze methode wordt uitgefaseerd. Heb je nog eigen app connectoren op basis van classic tokens? Stap voor 31 augustus 2027 over op een app connector gebaseerd op OAuth. Gebruik hiervoor vanaf Profit 9 de migratiewizard.

Let op:

Deze pagina is volledig gericht op Profit 9.

Werk je met Profit 8? Zie dan deze beschrijving van de Oauth-inrichting.

Inhoud

  • Beschrijving
  • Inrichten

Beschrijving

Je kunt een app connector inrichten op basis van de Client credentials flow en de Authorization code flow. Hieronder zie je de uitbreidingen in Profit 9.

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

Je kunt een public client inrichten via de app connector (de bestaande app connector ging altijd uit van een confidential client). Wat is het verschil tussen een public client en een confidential client? Een confidential client kan een geheim (een client secret of een private key) veilig opslaan, een public client kan dit niet. Om je te helpen bij de inrichting selecteer je bij een nieuwe app connector eerst wat voor type applicatie je wilt inrichten. Op basis hiervan bepaalt de wizard of je een confidential of public client nodig hebt.

De authenticatie is uitgebreid met de technieken DPoP en JWK. In het onderstaande schema zie je wanneer deze verplicht of optioneel zijn.

Overzicht van de mogelijkheden

Bij het aanmaken van een nieuwe app connector begin je met de keuze van een applicatietype. Het applicatietype bepaalt of het client type een confidential client is, of een public client. Ook de andere mogelijkheden t.a.v. authenticatie zijn een gevolg van de keuze van een bepaald applicatietype.

  • Systeemservice

    Er logt geen gebruiker in en de applicatie communiceert zelfstandig met Profit. Profit koppelt één systeemgebruiker aan een gebruikersgroep; alle aanroepen van de app connector lopen via de autorisatie van deze gebruikersgroep.

  • Webapplicatie

    De applicatie draait op een webserver en die webserver bewaart een client secret. Profit richt deze in als Confidential client. Kies vervolgens één flow: de Client credentials flow voor zelfstandig werken met één gebruiker en autorisatiegroep, of de Authorization code flow voor werken namens een ingelogde gebruiker met één bestaande autorisatiegroep.

  • Single-page-application (SPA)

    De applicatie draait in de browser van de gebruiker en de gebruiker logt zelf in. Profit koppelt hieraan een gebruikersgroep, net als bij een mobiele en desktopapplicatie. Een SPA bevat geen client secret.

  • Mobiele en desktopapplicatie

    Eindgebruikers gebruiken een geïnstalleerde mobiele of desktopapplicatie loggen daarbij zelf in. Profit koppelt hieraan een gebruikersgroep; iedereen in die groep kan inloggen en de app connector gebruiken. Deze applicatie bevat geen client secret.

Een app connector is altijd een een confidential client of een public client; je kunt beide niet combineren in één app connector. Hierbij kunnen zich de volgende situaties voordoen:

  • De applicatie wordt zowel door gebruikers als machine-naar-machine gebruikt zonder dat de applicatie zelf een server met een client secret heeft. Dan richt je hiervoor twee aparte app connectoren in: één met Mobiele en desktopapplicatie en één met Systeemservice.
  • De applicatie heeft wél een eigen server die een client secret kan bewaren. Gebruik dan één app connector waarbij je kiest voor Webapplicatie en maak een keuze voor de Auhtorization code flow of de Client credentials flow.

Signaal op verlopen laatste clientauthenticatie

Met een signaal op de verloopdatum van de laatste clientauthenticatie kun je automatisch een workflow starten of een e-mail versturen. Hiervoor gebruik je een signaal dat gebaseerd is op de nieuwe gegevensverzameling App connectoren: clientauthenticatie.

Inrichten

  • App connector inrichten voor public client
  • App connector inrichten voor Confidential client