Parkour Design kan forbindes med systemer til stævneadministration, platforme, der håndterer stævner og klasser, dokumentflows og andre værktøjer, som arrangører og banedesignere bruger. En integration kan overføre data og dokumenter sikkert mellem systemer, uden at oplysninger skal indtastes manuelt igen, eller filer sendes uden for den normale arbejdsgang.
Med etablerede standarder som OAuth 2.0 og OpenID Connect bliver implementeringen forudsigelig og sikker, uden at en partner skal bygge hele autorisationsmekanismen fra bunden. Det endelige omfang tilpasses partnerens system og den godkendte brugerrejse.
Vil du først se arbejdsgangen i produktet? Se Integrationer til rideplatforme for det foreslåede publiceringsflow og grænsen mellem nuværende funktioner og partnerspecifikt arbejde.
Fordele ved en integration
En veludformet integration kan give:
- hurtigere overførsel af baneskitser og oplysninger om klasser;
- mindre manuel indtastning og færre unødvendige fejl;
- en ensartet arbejdsgang for brugeren;
- sikker adgang uden at dele adgangskoder til konti;
- kompatibilitet med partnerens eksisterende værktøjer og processer;
- brugerens kontrol over adgangen til sine data.
Parkour Design understøtter tekniske integrationer i to retninger. Parkour Design kan forbinde sig med en partners identitetsudbyder og API, eller en partner kan forbinde sig med Parkour Designs tjenester til identitet og data. Retningerne udformes og godkendes separat, også når et produkt har brug for begge.
Denne side beskriver onboardingprocessen. Det er ikke en selvbetjent registrering af klienter og ikke en fuldstændig API-reference. Kontakt Parkour Design, før du bygger mod en produktionstjeneste.
Fortsæt med implementeringsdokumenterne:
- Autentificering om registrering, autorisationskode, validering af tokens og rotation ved fornyelse;
- Dataudveksling om nuværende ressourcer, skemaer, grænser og partnerspecifikke eksporter;
- Test og lancering om kørbare kontroller, acceptscenarier og godkendelse til produktion.
Vælg integrationens retning
Parkour Design forbinder sig med partneren
Brug denne retning, når en bruger i Parkour Design skal sende en baneskitse til et partnersystem eller vælge en modtager, som partneren håndterer.
- Den indloggede bruger starter forbindelsen i Parkour Design.
- Parkour Designs backend opretter en kortlivet autorisationstransaktion.
- Browseren åbner partnerens autorisations-endpoint.
- Partneren returnerer en autorisationskode til Parkour Designs registrerede callback.
- Parkour Designs backend udveksler og validerer koden.
- Parkour Design gemmer partnerens adgangstoken på serveren, aldrig i browserens lager.
- Parkour Design kalder det aftalte partner-API på brugerens vegne.
Partneren leverer metadata for OpenID Connect eller OAuth, klientregistrering, identitetsclaims, API-kontrakt og testmiljø.
Partneren forbinder sig med Parkour Design
Brug denne retning, når et partnerprogram har brug for, at brugeren i Parkour Design giver adgang til data i Parkour Design.
- Partneren omdirigerer brugeren til Parkour Designs autorisations-endpoint.
- Parkour Design autentificerer brugeren og beder om samtykke.
- Parkour Design returnerer en kortlivet autorisationskode til partnerens registrerede callback.
- Partnerens backend udveksler koden til tokens.
- Partneren validerer den returnerede identitet og bruger kun adgangstokenet til de godkendte ressourcer i Parkour Design.
Parkour Design har i øjeblikket en OIDC-udbyder med autorisationskode og en ressourcetjeneste, der er begrænset til brugeren. Klientregistrering og produktionsadgang koordineres med Parkour Design.
Samarbejde og miljøer
Begynd med en kort teknisk afklaring. Begge teams skal udpege en teknisk ansvarlig og en operationel kontaktperson.
Forbered en teknisk beskrivelse, der omfatter:
- integrationens retning og det forventede resultat for brugeren;
- test- og produktionsmiljøer, inklusive præcise redirect-URI’er;
- autentificeringsmetode, nødvendige identitetsclaims og godkendte tilladelser;
- data, der udveksles, ønskede ressourcer, og hvilken kilde der er gældende;
- forventet volumen, grænser og krav til pålidelighed;
- ansvarlige for teknik, sikkerhed, support og lancering.
Send aldrig produktionshemmeligheder i sager, chatbeskeder, kildefiler, skærmbilleder eller offentlig dokumentation. Aftal en sikker kanal til loginoplysninger og en procedure for rotation, før oplysningerne udstedes.
Start en integration
Send den tekniske beskrivelse til Parkour Design for at starte gennemgangen.
Klientregistrering, loginoplysninger, scopes og produktionsadgang gives først efter en teknisk gennemgang og sikkerhedsgennemgang.