Parkour Design puede conectarse con sistemas de gestión de concursos, plataformas que gestionan eventos y pruebas, flujos documentales y otras herramientas que usan los organizadores y los jefes de pista. Una integración puede transferir datos y documentos entre sistemas de forma segura, sin volver a escribir la información a mano ni enviar archivos fuera del flujo de trabajo habitual.
Usar estándares consolidados como OAuth 2.0 y OpenID Connect hace que la implementación sea previsible y segura, sin que el socio tenga que construir desde cero todo el mecanismo de autorización. El alcance final se adapta al sistema del socio y al recorrido de usuario aprobado.
¿Quieres ver primero el flujo desde el punto de vista del producto? Consulta Recorridos de salto para plataformas ecuestres para ver el flujo de publicación propuesto y el límite entre las funciones actuales y el trabajo específico de cada socio.
Ventajas de una integración
Una integración bien diseñada puede aportar:
- una transferencia más rápida de los planos de recorrido y de los datos de las pruebas;
- menos introducción manual de datos y menos errores evitables;
- un flujo de trabajo coherente para el usuario;
- acceso seguro sin compartir las contraseñas de las cuentas;
- compatibilidad con las herramientas y los procesos que ya usa el socio;
- control del usuario sobre el acceso a sus datos.
Parkour Design admite integraciones tecnológicas en dos sentidos. Parkour Design puede conectarse al proveedor de identidad y a la API de un socio, o un socio puede conectarse a los servicios de identidad y de datos de Parkour Design. Estos dos sentidos se diseñan y se aprueban por separado, aunque un producto necesite ambos.
Esta página describe el proceso para empezar una integración. No es un registro de clientes de autoservicio ni una referencia completa de la API. Ponte en contacto con Parkour Design antes de desarrollar contra un servicio de producción.
Sigue con los documentos de implementación:
- Autenticación para el registro, el código de autorización, la validación de tokens y la rotación de los tokens de actualización;
- Intercambio de datos para los recursos actuales, los esquemas, los límites y las exportaciones específicas de cada socio;
- Pruebas y puesta en producción para las comprobaciones ejecutables, los escenarios de aceptación y la aprobación de la puesta en producción.
Elegir el sentido de la integración
Parkour Design se conecta al socio
Usa este sentido cuando un usuario de Parkour Design tiene que enviar un plano de recorrido a un sistema del socio o elegir un destino gestionado por ese socio.
- El usuario con sesión iniciada inicia la conexión en Parkour Design.
- El servidor de Parkour Design crea una transacción de autorización de corta duración.
- El navegador abre el endpoint de autorización del socio.
- El socio devuelve un código de autorización a la URL de retorno registrada de Parkour Design.
- El servidor de Parkour Design intercambia y valida el código.
- Parkour Design guarda el token de acceso del socio en el servidor, nunca en el almacenamiento del navegador.
- Parkour Design llama a la API acordada del socio en nombre de ese usuario.
El socio proporciona sus metadatos de OpenID Connect u OAuth, el registro del cliente, los atributos de identidad, el contrato de la API y un entorno de pruebas.
El socio se conecta a Parkour Design
Usa este sentido cuando una aplicación del socio necesita que el usuario de Parkour Design le dé acceso a sus datos de Parkour Design.
- El socio redirige al usuario al endpoint de autorización de Parkour Design.
- Parkour Design autentica al usuario y le pide su consentimiento.
- Parkour Design devuelve un código de autorización de corta duración a la URL de retorno registrada del socio.
- El servidor del socio intercambia el código por tokens.
- El socio valida la identidad devuelta y usa el token de acceso solo para los recursos de Parkour Design aprobados.
Parkour Design opera actualmente un proveedor OIDC con código de autorización y un servicio de recursos limitado al usuario. El registro de clientes y el acceso a producción se coordinan con Parkour Design.
Colaboración y entornos
Empieza con una breve fase técnica de análisis. Cada equipo designa a un responsable técnico y a un contacto operativo.
Prepara una nota técnica que cubra:
- el sentido de la integración y el resultado esperado para el usuario;
- los entornos de pruebas y de producción, con las URI de redirección exactas;
- el método de autenticación, los atributos de identidad necesarios y los permisos aprobados;
- los datos intercambiados, los recursos solicitados y la fuente de referencia;
- el volumen esperado, los límites y los requisitos de fiabilidad;
- los responsables técnicos, de seguridad, de soporte y del lanzamiento.
Nunca envíes secretos de producción en tickets, mensajes de chat, archivos de código, capturas de pantalla ni documentación pública. Acuerda con Parkour Design un canal seguro para las credenciales y un procedimiento de rotación antes de que se emitan.
Empezar una integración
Envía la nota técnica a Parkour Design para iniciar la revisión.
El registro de clientes, las credenciales, los scopes y el acceso a producción solo se proporcionan después de una revisión técnica y de seguridad.