Parkour Design lze propojit se systémy pro organizaci závodů, platformami, které spravují akce a soutěže, dokumentovými toky a dalšími nástroji, které používají pořadatelé a stavitelé parkurů. Integrace může bezpečně přenášet data a dokumenty mezi systémy, aniž by bylo nutné údaje znovu ručně zadávat nebo posílat soubory mimo běžný pracovní postup.
Díky zavedeným standardům, jako jsou OAuth 2.0 a OpenID Connect, je implementace předvídatelná a bezpečná, aniž by partner musel celý autorizační mechanismus stavět od začátku. Konečný rozsah se přizpůsobí systému partnera a schválené uživatelské cestě.
Chcete nejdřív vidět pracovní postup v produktu? Navrhovaný tok zveřejnění a hranici mezi současnými funkcemi a prací specifickou pro partnera popisuje stránka Plány parkuru pro jezdecké platformy.
Přínosy integrace
Dobře navržená integrace může přinést:
- rychlejší předávání plánů parkuru a údajů o soutěžích;
- méně ručního zadávání a méně zbytečných chyb;
- jednotný pracovní postup pro uživatele;
- bezpečný přístup bez sdílení hesel k účtům;
- kompatibilitu se stávajícími nástroji a procesy partnera;
- kontrolu uživatele nad přístupem k jeho datům.
Parkour Design podporuje technické integrace ve dvou směrech. Parkour Design se může připojit k poskytovateli identity a API partnera, nebo se partner může připojit ke službám identity a dat Parkour Design. Směry se navrhují a schvalují zvlášť, i když produkt potřebuje oba.
Tato stránka popisuje proces zavádění. Nejde o samoobslužnou registraci klientů ani o úplnou referenci API. Než začnete stavět proti produkční službě, kontaktujte Parkour Design.
Pokračujte implementační dokumentací:
- Autentizace – registrace, autorizační kód, ověření tokenu a rotace při obnovení;
- Výměna dat – současné zdroje, schémata, limity a exporty specifické pro partnera;
- Testování a spuštění – spustitelné kontroly, akceptační scénáře a schválení pro produkci.
Zvolte směr integrace
Parkour Design se připojuje k partnerovi
Tento směr použijte, když uživatel v Parkour Design potřebuje poslat plán parkuru do systému partnera nebo zvolit cíl, který partner spravuje.
- Přihlášený uživatel zahájí připojení v Parkour Design.
- Backend Parkour Design vytvoří krátkodobou autorizační transakci.
- Prohlížeč otevře autorizační endpoint partnera.
- Partner vrátí autorizační kód na registrovaný callback Parkour Design.
- Backend Parkour Design kód vymění a ověří.
- Parkour Design uloží přístupový token partnera na serveru, nikdy v úložišti prohlížeče.
- Parkour Design volá dohodnuté API partnera jménem uživatele.
Partner poskytne metadata OpenID Connect nebo OAuth, registraci klienta, nároky identity, kontrakt API a testovací prostředí.
Partner se připojuje k Parkour Design
Tento směr použijte, když aplikace partnera potřebuje, aby uživatel Parkour Design udělil přístup k datům v Parkour Design.
- Partner přesměruje uživatele na autorizační endpoint Parkour Design.
- Parkour Design uživatele ověří a požádá o souhlas.
- Parkour Design vrátí krátkodobý autorizační kód na registrovaný callback partnera.
- Backend partnera vymění kód za tokeny.
- Partner ověří vrácenou identitu a přístupový token použije jen pro schválené zdroje Parkour Design.
Parkour Design v současnosti provozuje poskytovatele OIDC s autorizačním kódem a službu zdrojů omezenou na uživatele. Registrace klientů a produkční přístup se koordinují s Parkour Design.
Spolupráce a prostředí
Začněte krátkým technickým zmapováním. Oba týmy určí technického vedoucího a provozní kontaktní osobu.
Připravte technický popis, který zahrnuje:
- směr integrace a očekávaný výsledek pro uživatele;
- testovací a produkční prostředí, včetně přesných URI přesměrování;
- metodu autentizace, potřebné nároky identity a schválená oprávnění;
- vyměňovaná data, požadované zdroje a to, který zdroj je směrodatný;
- očekávaný objem, limity a požadavky na spolehlivost;
- odpovědné osoby za techniku, bezpečnost, podporu a spuštění.
Nikdy neposílejte produkční tajné klíče v tiketech, chatových zprávách, zdrojových souborech, snímcích obrazovky ani veřejné dokumentaci. Před vydáním přihlašovacích údajů se dohodněte na zabezpečeném kanálu a postupu rotace.
Zahájení integrace
Kontrolu zahájíte odesláním technického popisu na Parkour Design.
Registrace klienta, přihlašovací údaje, scope a produkční přístup se udělují až po technické a bezpečnostní kontrole.