Parkour Design si può collegare a sistemi di gestione dei concorsi, piattaforme che gestiscono eventi e categorie, flussi documentali e altri strumenti usati da comitati organizzatori e direttori di campo. Un’integrazione può trasferire in sicurezza dati e documenti tra sistemi, senza reinserire a mano le informazioni o inviare file fuori dal normale flusso di lavoro.
Con standard consolidati come OAuth 2.0 e OpenID Connect l’implementazione è prevedibile e sicura, senza che il partner debba costruire da zero l’intero meccanismo di autorizzazione. L’ambito finale si adatta al sistema del partner e al percorso utente approvato.
Vuoi vedere prima il flusso di lavoro nel prodotto? Il flusso di pubblicazione proposto e il confine tra le funzioni attuali e il lavoro specifico per il partner sono descritti in Grafici dei percorsi per piattaforme equestri.
Vantaggi di un’integrazione
Un’integrazione ben progettata può offrire:
- un passaggio più rapido dei grafici dei percorsi e dei dati delle categorie;
- meno inserimenti manuali e meno errori evitabili;
- un flusso di lavoro uniforme per l’utente;
- un accesso sicuro senza condividere le password degli account;
- compatibilità con gli strumenti e i processi esistenti del partner;
- il controllo dell’utente sull’accesso ai propri dati.
Parkour Design supporta integrazioni tecniche in due direzioni. Parkour Design può collegarsi al provider di identità e all’API del partner, oppure il partner può collegarsi ai servizi di identità e dati di Parkour Design. Le direzioni si progettano e si approvano separatamente, anche quando un prodotto ha bisogno di entrambe.
Questa pagina descrive il processo di onboarding. Non è una registrazione self-service dei client né un riferimento completo dell’API. Contatta Parkour Design prima di sviluppare contro un servizio di produzione.
Prosegui con la documentazione di implementazione:
- Autenticazione: registrazione, codice di autorizzazione, verifica dei token e rotazione al rinnovo;
- Scambio di dati: risorse attuali, schemi, limiti ed esportazioni specifiche per il partner;
- Test e lancio: controlli eseguibili, scenari di accettazione e approvazione per la produzione.
Scegli la direzione dell’integrazione
Parkour Design si collega al partner
Usa questa direzione quando un utente in Parkour Design deve inviare un grafico del percorso a un sistema del partner o scegliere una destinazione gestita dal partner.
- L’utente autenticato avvia il collegamento in Parkour Design.
- Il backend di Parkour Design crea una transazione di autorizzazione di breve durata.
- Il browser apre l’endpoint di autorizzazione del partner.
- Il partner restituisce un codice di autorizzazione al callback registrato di Parkour Design.
- Il backend di Parkour Design scambia e verifica il codice.
- Parkour Design conserva il token di accesso del partner sul server, mai nella memoria del browser.
- Parkour Design chiama l’API concordata del partner per conto dell’utente.
Il partner fornisce i metadati OpenID Connect o OAuth, la registrazione del client, i claim di identità, il contratto API e l’ambiente di test.
Il partner si collega a Parkour Design
Usa questa direzione quando un’applicazione del partner ha bisogno che l’utente di Parkour Design conceda l’accesso ai dati in Parkour Design.
- Il partner reindirizza l’utente all’endpoint di autorizzazione di Parkour Design.
- Parkour Design autentica l’utente e chiede il consenso.
- Parkour Design restituisce un codice di autorizzazione di breve durata al callback registrato del partner.
- Il backend del partner scambia il codice con i token.
- Il partner verifica l’identità restituita e usa il token di accesso solo per le risorse approvate di Parkour Design.
Parkour Design gestisce attualmente un provider OIDC con codice di autorizzazione e un servizio di risorse limitato all’utente. Registrazione dei client e accesso alla produzione si coordinano con Parkour Design.
Collaborazione e ambienti
Inizia con una breve analisi tecnica. Entrambi i team indicano un responsabile tecnico e un referente operativo.
Prepara una descrizione tecnica che comprenda:
- direzione dell’integrazione e risultato atteso per l’utente;
- ambienti di test e di produzione, compresi gli URI di reindirizzamento esatti;
- metodo di autenticazione, claim di identità necessari e autorizzazioni approvate;
- dati scambiati, risorse richieste e quale fonte è autorevole;
- volume previsto, limiti e requisiti di affidabilità;
- responsabili di tecnica, sicurezza, assistenza e lancio.
Non inviare mai segreti di produzione in ticket, messaggi di chat, file sorgente, screenshot o documentazione pubblica. Prima del rilascio delle credenziali, concordate un canale sicuro e una procedura di rotazione.
Avviare un’integrazione
Per avviare la revisione, invia la descrizione tecnica a Parkour Design.
Registrazione del client, credenziali, scope e accesso alla produzione vengono concessi solo dopo una revisione tecnica e di sicurezza.