Parkour Design kan worden gekoppeld aan systemen voor wedstrijdbeheer, platforms die evenementen en rubrieken beheren, documentworkflows en andere hulpmiddelen van organisatoren en parcoursbouwers. Een integratie kan gegevens en documenten veilig tussen systemen uitwisselen, zonder gegevens opnieuw met de hand in te voeren of bestanden buiten de normale werkwijze te versturen.
Door gangbare standaarden zoals OAuth 2.0 en OpenID Connect te gebruiken, wordt de implementatie voorspelbaar en veilig, zonder dat een partner het hele autorisatiemechanisme zelf hoeft te bouwen. De uiteindelijke omvang wordt afgestemd op het systeem van de partner en de goedgekeurde gebruikersflow.
Wil je eerst de productflow zien? Zie Parcoursplannen voor paardensportplatforms voor de voorgestelde publicatieflow en de grens tussen wat nu beschikbaar is en wat per partner wordt ontwikkeld.
Voordelen van een integratie
Een goed ontworpen integratie kan zorgen voor:
- snellere overdracht van parcoursontwerpen en gegevens van rubrieken;
- minder handmatige invoer en minder vermijdbare fouten;
- één consistente werkwijze voor de gebruiker;
- veilige toegang zonder accountwachtwoorden te delen;
- aansluiting op de bestaande hulpmiddelen en processen van de partner;
- controle van de gebruiker over de toegang tot zijn gegevens.
Parkour Design ondersteunt technologische integraties in twee richtingen. Parkour Design kan verbinding maken met de identiteitsprovider en de API van een partner, of een partner kan verbinding maken met de identiteits- en gegevensdiensten van Parkour Design. Deze richtingen worden apart ontworpen en goedgekeurd, ook als één product ze allebei nodig heeft.
Deze pagina beschrijft het onboardingproces. Het is geen selfservice voor het registreren van clients en geen volledige API-referentie. Neem contact op met Parkour Design voordat je op een productiedienst gaat bouwen.
Ga verder met de implementatiedocumenten:
- Authenticatie voor registratie, autorisatiecode, tokenvalidatie en rotatie van refresh tokens;
- Gegevensuitwisseling voor de huidige resources, schema’s, limieten en exports per partner;
- Testen en lancering voor uitvoerbare controles, acceptatiescenario’s en goedkeuring voor productie.
Kies de richting van de integratie
Parkour Design maakt verbinding met de partner
Gebruik deze richting als een gebruiker van Parkour Design een parcoursontwerp naar het systeem van een partner wil sturen of een bestemming wil kiezen die door die partner wordt beheerd.
- De ingelogde gebruiker start de verbinding in Parkour Design.
- De backend van Parkour Design maakt een kortlevende autorisatietransactie aan.
- De browser opent het autorisatie-endpoint van de partner.
- De partner stuurt een autorisatiecode terug naar de geregistreerde callback van Parkour Design.
- De backend van Parkour Design wisselt de code in en valideert die.
- Parkour Design bewaart het toegangstoken van de partner op de server, nooit in de opslag van de browser.
- Parkour Design roept namens die gebruiker de afgesproken API van de partner aan.
De partner levert zijn OpenID Connect- of OAuth-metadata, de registratie van de client, identiteitsclaims, het API-contract en een testomgeving.
De partner maakt verbinding met Parkour Design
Gebruik deze richting als een applicatie van een partner de gebruiker van Parkour Design toegang wil laten geven tot gegevens in Parkour Design.
- De partner stuurt de gebruiker door naar het autorisatie-endpoint van Parkour Design.
- Parkour Design authenticeert de gebruiker en vraagt om toestemming.
- Parkour Design stuurt een kortlevende autorisatiecode terug naar de geregistreerde callback van de partner.
- De backend van de partner wisselt de code in voor tokens.
- De partner valideert de teruggegeven identiteit en gebruikt het toegangstoken alleen voor de goedgekeurde resources van Parkour Design.
Parkour Design heeft nu een OIDC-provider met autorisatiecode en een resourcedienst die per gebruiker is afgebakend. Registratie van clients en productietoegang worden met Parkour Design afgestemd.
Samenwerking en omgevingen
Begin met een korte technische verkenning. Beide teams wijzen één technisch eigenaar en één operationeel aanspreekpunt aan.
Bereid een technische beschrijving voor met:
- de richting van de integratie en het verwachte resultaat voor de gebruiker;
- test- en productieomgevingen, met de exacte redirect-URI’s;
- de authenticatiemethode, vereiste identiteitsclaims en goedgekeurde rechten;
- de uitgewisselde gegevens, de gevraagde resources en de bron van waarheid;
- het verwachte volume, de limieten en de eisen aan betrouwbaarheid;
- de eigenaars voor techniek, beveiliging, ondersteuning en lancering.
Stuur nooit productiegeheimen in tickets, chatberichten, bronbestanden, schermafbeeldingen of openbare documentatie. Spreek een veilig kanaal voor inloggegevens en een rotatieprocedure af voordat er inloggegevens worden uitgegeven.
Een integratie starten
Stuur de technische beschrijving naar Parkour Design om de beoordeling te starten.
Registratie van clients, inloggegevens, scopes en productietoegang worden pas na een technische en beveiligingsbeoordeling verstrekt.