Parkour Design kan anslutas till system för tävlingsadministration, plattformar som hanterar evenemang och klasser, dokumentflöden och andra verktyg som arrangörer och banbyggare använder. En integration kan överföra data och dokument säkert mellan system, utan att uppgifter behöver anges manuellt igen eller filer skickas utanför det vanliga arbetsflödet.
Med etablerade standarder som OAuth 2.0 och OpenID Connect blir implementeringen förutsägbar och säker, utan att en partner behöver bygga hela auktoriseringsmekanismen från början. Den slutliga omfattningen anpassas till partnerns system och den godkända användarresan.
Vill du först se arbetsflödet i produkten? Se Partnerskap för ridsportplattformar för det föreslagna publiceringsflödet och gränsen mellan nuvarande funktioner och partnerspecifikt arbete.
Fördelar med en integration
En väl utformad integration kan ge:
- snabbare överföring av banskisser och uppgifter om klasser;
- mindre manuell inmatning och färre onödiga fel;
- ett enhetligt arbetsflöde för användaren;
- säker åtkomst utan att dela lösenord till konton;
- kompatibilitet med partnerns befintliga verktyg och processer;
- användarens kontroll över åtkomsten till sina data.
Parkour Design stöder tekniska integrationer i två riktningar. Parkour Design kan ansluta till en partners identitetsleverantör och API, eller så kan en partner ansluta till Parkour Designs tjänster för identitet och data. Riktningarna utformas och godkänns separat, även när en produkt behöver båda.
Den här sidan beskriver introduktionsprocessen. Det är ingen registrering av klienter på egen hand och ingen fullständig API-referens. Kontakta Parkour Design innan du bygger mot en produktionstjänst.
Fortsätt med implementeringsdokumenten:
- Autentisering om registrering, auktoriseringskod, validering av token och rotation vid förnyelse;
- Datautbyte om nuvarande resurser, scheman, gränser och partnerspecifika exporter;
- Test och lansering om körbara kontroller, acceptansscenarier och godkännande för produktion.
Välj integrationens riktning
Parkour Design ansluter till partnern
Använd den här riktningen när en användare i Parkour Design behöver skicka en banskiss till ett partnersystem eller välja ett mål som partnern hanterar.
- Den inloggade användaren startar anslutningen i Parkour Design.
- Parkour Designs backend skapar en kortlivad auktoriseringstransaktion.
- Webbläsaren öppnar partnerns auktoriseringsslutpunkt.
- Partnern returnerar en auktoriseringskod till Parkour Designs registrerade callback.
- Parkour Designs backend byter ut och validerar koden.
- Parkour Design lagrar partnerns åtkomsttoken på servern, aldrig i webbläsarens lagring.
- Parkour Design anropar det överenskomna partner-API:et för användarens räkning.
Partnern tillhandahåller metadata för OpenID Connect eller OAuth, klientregistrering, identitetsanspråk, API-kontrakt och testmiljö.
Partnern ansluter till Parkour Design
Använd den här riktningen när ett partnerprogram behöver att användaren i Parkour Design ger åtkomst till data i Parkour Design.
- Partnern omdirigerar användaren till Parkour Designs auktoriseringsslutpunkt.
- Parkour Design autentiserar användaren och ber om samtycke.
- Parkour Design returnerar en kortlivad auktoriseringskod till partnerns registrerade callback.
- Partnerns backend byter koden mot token.
- Partnern validerar den returnerade identiteten och använder åtkomsttoken bara för de godkända resurserna i Parkour Design.
Parkour Design har för närvarande en OIDC-leverantör med auktoriseringskod och en resurstjänst som är begränsad till användaren. Klientregistrering och produktionsåtkomst samordnas med Parkour Design.
Samarbete och miljöer
Börja med en kort teknisk kartläggning. Båda teamen ska utse en teknisk ansvarig och en operativ kontaktperson.
Förbered en teknisk beskrivning som omfattar:
- integrationens riktning och förväntat resultat för användaren;
- test- och produktionsmiljöer, inklusive exakta omdirigerings-URI:er;
- autentiseringsmetod, nödvändiga identitetsanspråk och godkända behörigheter;
- data som utbyts, begärda resurser och vilken källa som gäller;
- förväntad volym, gränser och krav på tillförlitlighet;
- ansvariga för teknik, säkerhet, support och lansering.
Skicka aldrig produktionshemligheter i ärenden, chattmeddelanden, källfiler, skärmbilder eller offentlig dokumentation. Kom överens om en säker kanal för inloggningsuppgifter och en rutin för rotation innan uppgifterna utfärdas.
Starta en integration
Skicka den tekniska beskrivningen till Parkour Design för att starta granskningen.
Klientregistrering, inloggningsuppgifter, scope och produktionsåtkomst ges först efter en teknisk granskning och säkerhetsgranskning.