Parkour Design może łączyć się z systemami obsługi zawodów, platformami zarządzającymi Wydarzeniami i Konkursami, obiegami dokumentów oraz innymi narzędziami używanymi przez organizatorów i projektantów parkurów. Integracja może bezpiecznie przekazywać dane i dokumenty między systemami bez ręcznego przepisywania informacji lub wysyłania plików poza zwykłym procesem pracy.
Wykorzystanie powszechnie stosowanych standardów, takich jak OAuth 2.0 i OpenID Connect, sprawia, że wdrożenie jest przewidywalne i bezpieczne, a partner nie musi budować całego mechanizmu autoryzacji od podstaw. Ostateczny zakres jest dopasowywany do systemu partnera i zatwierdzonej ścieżki użytkownika.
Korzyści z integracji
Dobrze zaprojektowana integracja może zapewnić:
- szybsze przekazywanie projektów parkurów i danych Konkursu;
- mniej ręcznego przepisywania danych i mniej możliwych do uniknięcia błędów;
- jeden spójny proces dla użytkownika;
- bezpieczny dostęp bez udostępniania haseł do kont;
- zgodność z istniejącymi narzędziami i procesami partnera;
- kontrolę użytkownika nad dostępem do jego danych.
Parkour Design obsługuje integracje technologiczne w dwóch kierunkach. Parkour Design może łączyć się z dostawcą tożsamości i API partnera albo partner może łączyć się z usługami tożsamości i danych Parkour Design. Kierunki te są projektowane i zatwierdzane oddzielnie, nawet jeśli jeden produkt wymaga obu.
Ta strona opisuje proces wdrażania integracji. Nie służy do samodzielnej rejestracji klienta ani nie stanowi kompletnej dokumentacji API. Przed rozpoczęciem prac z usługą produkcyjną skontaktuj się z Parkour Design.
Przejdź do dokumentów implementacyjnych:
- Uwierzytelnianie opisuje rejestrację, authorization code, weryfikację tokenów i rotację tokenów odświeżania;
- Wymiana danych opisuje obecne zasoby, schematy, limity i eksporty właściwe dla partnera;
- Testowanie i uruchomienie zawiera wykonywalne testy, scenariusze akceptacyjne i wymagania uruchomienia produkcyjnego.
Wybór kierunku integracji
Parkour Design łączy się z partnerem
Wybierz ten kierunek, gdy użytkownik Parkour Design ma przesłać projekt parkuru do systemu partnera lub wybrać miejsce docelowe zarządzane przez partnera.
- Zalogowany użytkownik rozpoczyna łączenie w Parkour Design.
- Backend Parkour Design tworzy krótkotrwałą transakcję autoryzacyjną.
- Przeglądarka otwiera endpoint autoryzacyjny partnera.
- Partner zwraca kod autoryzacyjny na zarejestrowany adres zwrotny Parkour Design.
- Backend Parkour Design wymienia i weryfikuje kod.
- Parkour Design przechowuje token dostępu partnera na serwerze, nigdy w pamięci przeglądarki.
- Parkour Design wywołuje uzgodnione API partnera w imieniu tego użytkownika.
Partner udostępnia metadane OpenID Connect lub OAuth, dane rejestracyjne klienta, atrybuty tożsamości, kontrakt API oraz środowisko testowe.
Partner łączy się z Parkour Design
Wybierz ten kierunek, gdy aplikacja partnera wymaga od użytkownika Parkour Design udzielenia dostępu do danych Parkour Design.
- Partner przekierowuje użytkownika do endpointu autoryzacyjnego Parkour Design.
- Parkour Design uwierzytelnia użytkownika i prosi go o zgodę.
- Parkour Design zwraca krótkotrwały kod autoryzacyjny na zarejestrowany adres zwrotny partnera.
- Backend partnera wymienia kod na tokeny.
- Partner weryfikuje zwróconą tożsamość i używa tokena dostępu wyłącznie do zatwierdzonych zasobów Parkour Design.
Parkour Design obecnie udostępnia dostawcę OIDC korzystającego z przepływu authorization code oraz usługę zasobów z dostępem ograniczonym do użytkownika. Rejestracja klienta i dostęp produkcyjny są koordynowane z Parkour Design.
Współpraca i środowiska
Rozpocznij od krótkiej analizy technicznej. Oba zespoły powinny wyznaczyć jedną osobę odpowiedzialną za kwestie inżynieryjne i jedną osobę do kontaktu w sprawach operacyjnych.
Przygotuj krótkie założenia techniczne obejmujące:
- kierunek integracji i oczekiwany rezultat dla użytkownika;
- środowiska testowe i produkcyjne, w tym dokładne adresy URI przekierowań;
- metodę uwierzytelniania, wymagane atrybuty tożsamości i zatwierdzone uprawnienia;
- wymieniane dane, żądane zasoby i źródło prawdy;
- przewidywany wolumen, limity i wymagania dotyczące niezawodności;
- osoby odpowiedzialne za kwestie techniczne, bezpieczeństwo, wsparcie i uruchomienie.
Nigdy nie przesyłaj sekretów produkcyjnych w zgłoszeniach, wiadomościach na czacie, plikach źródłowych, zrzutach ekranu ani publicznej dokumentacji. Przed wydaniem danych uwierzytelniających uzgodnij bezpieczny kanał ich przekazywania oraz procedurę rotacji.
Rozpoczęcie integracji
Prześlij założenia techniczne do Parkour Design, aby rozpocząć ocenę.
Rejestracja klienta, dane uwierzytelniające, zakresy uprawnień i dostęp produkcyjny są udostępniane dopiero po ocenie technicznej i ocenie bezpieczeństwa.