App connector inrichten voor confidential client (Profit 9)
Je maakt een app connector aan voor een confidential client. Een confidential client kan een client secret veilig opslaan. De app connector biedt echter ook technieken waarbij dit niet nodig is.
Je kon een app connector op basis van OAuth inrichten met de methoden Client credentials flow en Authorization code flow. Hieronder zie je de uitbreidingen voor Profit 9.
|
Inhoud |
Beschrijving
![]()
Als je begint met een nieuwe app connector, dan baseer je deze op een Webapplicatie of Systeemservice. Deze keuze bepaalt je mogelijkheden bij de inrichting van de app connector. Een Systeemservice is altijd gebaseerd op de Client credentials flow, bij een Webapplicatie heb je de keuze tussen Client credentials flow en Authorization code flow.
Bij de Webapplicatie of Systeemservice maak je een keuze:
- Je gebruikt client secrets (al bekend van Profit 8)
Vanaf Profit 9 heeft de client secret een vaste geldigheidsduur van maximaal 2 jaar. Je kunt nu gebruik maken van een roterend client secret (je kunt meerdere client secrets per app connector opslaan).
Als de laatste geldige client secret binnen 14 dagen verloopt, dan wordt dit gemeld op Profit Home. Als er nog een andere client secret is met een langere geldigheidsduur, dan is er geen melding op Profit Home.
Je kunt de geldigheid van client secrets opvragen via de api. Als je de metainfo van een App Connector ophaalt, dan krijg je ook de client secret metadata terug inclusief de verloopdatum.
- Je gebruikt JWT in plaats van een client secret (nieuw in Profit 9)
Hierbij doe je een tokenaanvraag op basis van een eenmalige, kortlevende Json Web Token.
Toepassing van DPoP (Demonstrating Proof of Possession) is optioneel, Hierbij wordt een token aan een sleutelpaar gekoppeld dat deze applicatie zelf aanmaakt. Bij elke aanroep stuurt de applicatie een ondertekend bewijs mee dat zij de bijbehorende private sleutel bezit. Profit accepteert het token alleen samen met een geldig bewijs, waardoor een onderschept token niet in een andere applicatie of op een ander apparaat werkt.
Technische informatie en endpoints
Verwijs je koppelpartner of de ontwikkelaar van je applicatie naar de API Docs voor een overzicht van de endpoints, codevoorbeelden, etc.
App connector aanmaken voor een Systeemservice
Een Systeemservice is altijd gebaseerd op de Client credentials flow. 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.
- Ga naar: Algemeen / Beheer / App connector.
- Klik op: Nieuw.
- Vul de omschrijving in.
- Selecteer OAuth bij het veld Type authenticatie.
- Selecteer Systeemservice bij het veld Type applicatie.
- Bepaal of je DPOP wilt gebruiken.
- Bepaal de Clientauthenticatiemethode: op basis van een client secret of JWK (Jason web token.
Let op:
Je kunt de bovenstaande keuzen niet meer wijzigen, behalve het veld DPoP. Dit veld kun je na het aanmaken van de app connector nog aan -of uitvinken.
Na het aanmaken van de app connector maakt Profit automatisch een gebruikersgroep en een systeemgebruiker aan met de naam van de app connector.
- Klik op: Voltooien.
- De eigenschappen van de app connector worden geopend. Je kunt de OAuth client id kopiƫren.
Let op:
Je OAuth client id wel raadplegen via de eigenschappen van de app connector, maar niet wijzigen.
- Ga door met de Vervolgstappen (onderaan deze pagina).
App connector aanmaken voor een Webapplicatie
Bij een webapplicatie bepaal je zelf of je de Client credentials flow en Authorization code flow wilt gebruiken.
- Ga naar: Algemeen / Beheer / App connector.
- Klik op: Nieuw.
- Vul de omschrijving in.
- Selecteer OAuth bij het veld Type authenticatie.
- Selecteer Webapplicatie bij het veld Type applicatie.
- Bepaal of je DPOP wilt gebruiken.
- Bepaal of je de Client credentials flow en Authorization code flow wilt gebruiken.
- Bij de Authorization code flow selecteer je de Profit-gebruikersgroep en vul je de redirect url in.
- 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.
- Bepaal de Clientauthenticatiemethode: op basis van een client secret of JWK (Jason web token.
Let op:
Je kunt de bovenstaande keuzen niet meer wijzigen, behalve het veld DPoP. Dit veld kun je na het aanmaken van de app connector nog aan -of uitvinken.
Na het aanmaken van de app connector maakt Profit automatisch een gebruikersgroep en een systeemgebruiker aan met de naam van de app connector. Je
- Klik op: Voltooien.
- De eigenschappen van de app connector worden geopend. Je kunt de OAuth client id kopiƫren.
Let op:
Je kunt de OAuth client id wel raadplegen via de eigenschappen van de app connector, maar niet wijzigen.
Client secret aanmaken:
Deze stap geldt alleen bij de Client credentials flow.
Omdat een client secret een vervaldatum heeft, kun je meerdere client secrets aanmaken. Dit is nodig voor een roterend client secret.
Let op:
Je kunt de OAuth client id raadplegen via het tabblad Algemeen, maar niet meer wijzigen.
De OAuth client secret zie je alleen bij het aanmaken van de secret.
In de weergave Client secrets zie je de eerste vier tekens van een client secret, zodat je dit kunt herkennen ![]()
- Ga naar het tabblad: Client secret.
- Klik op: Nieuw.
- Maak een client secret aan.
- Klik op: Volgende.
- Kopieer de OAuth secret en sla deze op een veilige plaats op.
- Klik op: Voltooien.
Vervolgstappen
Voer deze stappen uit na het aanmaken van een app connector.
Instellingen van de app connector volledig maken:
- Selecteer de
Get- en UpdateConnectoren die via de app connector mogen worden aangeroepen. - Op het tabblad Connectoren vind je enkele speciale connectoren. De meestgebruikte is AppConnectorSubject, deze is nodig voor het openen van bijlagen bij dossieritems.
- Kijk of je nog IP-restricities moet vastleggen.
Filterautorisatie uitdelen voor GetConnectoren:
De GetConnectoren die je via de app connector gaat aanroepen, kunnen alleen records ophalen voor zover dit is toegestaan op basis van de filterautorisatie. Wil je bijvoorbeeld medewerkergegevens ophalen via een app connector, dan moet dit zijn toegestaan op basis van filterautorisatie op medewerker.
Let op:
Richt dit altijd in voordat een app connector op een productieomgeving (of een kopie hiervan) in gebruik wordt genomen. Als er geen filterautorisatie is ingesteld, kan een koppeling via een GetConnector namelijk alle records ophalen, bijvoorbeeld alle medewerkers en hun gegevens.
Autoriseer de gebruikersgroep NIET voor functies (menu-items), tabbladen en acties. Het is immers niet de bedoeling dat via deze gebruikersgroep in Profit gewerkt wordt.
- Ga naar: Algemeen / Beheer / App connector.
- Op het tabblad Algemeen zie je de gebruikersgroep waarvoor je de filterautorisatie moet instellen.
- Ga naar het tabblad: GetConnectoren.
- In de eigenschappen van een app connector zie je per GetConnector welke filterautorisatie je kunt toepassen.


- Ga naar: Algemeen / Beheer / Autorisatie tool.
- Ga naar het tabblad: Onderhoud groepen.
- Selecteer de gebruikersgroep die aan de app connector gekoppeld is.
- Ga naar het tabblad: Autorisatie.
- Deel rechten uit op de juiste filters.

Zie ook: