Menú de la documentación
Según el socio Última actualización: 27 de julio de 2026

Pruebas y puesta en producción

Verifica OAuth, la identidad, el aislamiento entre usuarios, los contratos de recursos, la gestión de errores y la preparación para producción.

Prueba la integración completa en el entorno de pruebas de Parkour Design antes de que se emitan las credenciales de producción. Las comprobaciones automáticas demuestran el comportamiento del protocolo y del contrato; la aceptación manual demuestra el recorrido del usuario y la recuperación operativa.

Regla de lanzamiento: una llamada de retorno de autorización correcta no basta para la aceptación. El lanzamiento requiere validación de la identidad, aislamiento entre usuarios, rotación de tokens, pruebas del contrato de recursos, recuperación ante fallos y la aprobación de ambos equipos.

Requisitos previos de las pruebas

Parkour Design y el socio deben preparar:

  • un cliente de pruebas registrado y un secreto entregado de forma segura;
  • una URI de redirección de pruebas exacta;
  • el conjunto de scopes aprobado;
  • al menos dos usuarios de prueba de Parkour Design;
  • eventos y proyectos de cada usuario por separado;
  • una cuenta o un evento vacíos cuando proceda;
  • contactos técnicos y para incidencias;
  • los resultados esperados de cada caso de aceptación.

Usa el emisor de pruebas:

https://parkour-test.web.app

No reutilices en producción las credenciales, las URL de retorno, los tokens ni los datos de usuario de pruebas.

Comprobaciones previas

Descubrimiento

curl --fail-with-body \
  "https://parkour-test.web.app/.well-known/openid-configuration"

Comprueba que:

  • issuer es exactamente igual al emisor de pruebas configurado;
  • los endpoints de autorización, token, UserInfo y JWKS usan HTTPS;
  • están presentes code, authorization_code, refresh_token, RS256 y S256;
  • no aparece en el documento ningún secreto del cliente ni ningún valor privado del entorno.

Claves de firma

Obtén el jwks_uri del documento de descubrimiento y comprueba que cada clave utilizable tiene kid, kty, uso de firma y un algoritmo aprobado. Ante un kid desconocido, el cliente debe actualizar el JWKS una vez antes de rechazar el token.

Solicitud de recursos sin autenticar

curl --include "https://parkour-test.web.app/api/events"

Resultado esperado:

HTTP/2 401
Content-Type: application/json

{"error":"invalid_token"}

Pruebas automáticas de OAuth

Automatiza estos casos en el límite del sistema del socio. Usa datos de prueba controlados y simula solo el paso externo del navegador cuando una prueba completa con navegador no sea práctica.

Solicitud de autorización

  • incluye el client ID, la URI de redirección y los scopes aprobados exactos;
  • genera valores state, nonce y verificador PKCE únicos y de alta entropía;
  • envía code_challenge_method=S256;
  • no pone el secreto del cliente ni el verificador en la URL;
  • rechaza una URI de redirección no registrada o ligeramente distinta en una prueba negativa del entorno.

Llamada de retorno

  • acepta el state correcto una sola vez;
  • rechaza un state ausente, distinto, caducado o reutilizado;
  • gestiona access_denied sin intercambiar ningún código;
  • rechaza que falte el código en una llamada de retorno por lo demás correcta;
  • conserva solo una ruta de vuelta local validada;
  • no muestra al navegador diagnósticos del protocolo ni datos personales.

Intercambio del código

  • se autentica con client_secret_basic;
  • usa la misma URI de redirección que la solicitud de autorización;
  • envía el verificador PKCE original;
  • rechaza códigos caducados, reutilizados, de otro cliente o con un verificador incorrecto;
  • trata las respuestas de token como no almacenables en caché y las mantiene en el servidor.

Validación del token de identidad

Rechaza los tokens con:

  • una firma no válida;
  • una clave de firma desconocida después de actualizar el JWKS una vez;
  • un emisor incorrecto;
  • una audiencia incorrecta;
  • un algoritmo distinto de RS256;
  • un nonce ausente o incorrecto;
  • atributos de tiempo caducados o poco plausibles;
  • un sujeto ausente.

Comprueba que la vinculación de cuentas usa el par iss y sub, no solo el correo electrónico.

Rotación del token de actualización

  • un token de actualización válido devuelve un nuevo token de acceso y un token de actualización que sustituye al anterior;
  • el nuevo token se guarda de forma atómica;
  • las actualizaciones se serializan por cada usuario y sesión del cliente;
  • se rechaza la reutilización del token de actualización antiguo;
  • se rechaza un token emitido para otro cliente;
  • un token caducado exige un nuevo flujo de autorización;
  • un tiempo de espera agotado o una respuesta de actualización perdida, con resultado desconocido, borra el estado local de los tokens e inicia un nuevo flujo de autorización en lugar de reintentar con el token antiguo;
  • los intentos de actualización simultáneos no pueden competir con el mismo token;
  • la desconexión local borra el token de actualización activo y los datos de la sesión.

Parkour Design no tiene actualmente un endpoint público de revocación. Las pruebas no deben presentar el borrado local como una revocación en el servidor.

Pruebas automáticas de recursos

Autenticación y aislamiento

  • sin token se devuelve 401 invalid_token;
  • un token caducado o mal formado devuelve 401 invalid_token;
  • se rechaza un token de identidad usado como token portador de la API;
  • el usuario A solo ve los eventos y proyectos del usuario A;
  • el usuario B no puede obtener un evento del usuario A copiando su ID;
  • los eventos inaccesibles y los inexistentes devuelven ambos 404 not_found.

Contrato del esquema

Valida cada respuesta con un esquema de referencia propio del socio:

  • están presentes las propiedades obligatorias;
  • las propiedades que admiten nulo aceptan null;
  • las fechas se interpretan como valores ISO 8601;
  • las propiedades adicionales desconocidas no rompen el cliente;
  • las colecciones vacías devuelven un array items vacío;
  • los identificadores se tratan como cadenas opacas;
  • el texto admite Unicode y se muestra de forma segura.

No deduzcas un plano de recorrido completo a partir del esquema de resumen.

Límites y fallos

  • el cliente gestiona la lista de eventos más grande aprobada;
  • el límite actual de 500 proyectos en el detalle figura en la evaluación de riesgos del lanzamiento;
  • las respuestas 401, 404, 405, 429 y 5xx siguen la política de reintentos acordada;
  • los tiempos de espera agotados no provocan reintentos ilimitados;
  • un JSON mal formado falla de forma segura y registra un diagnóstico depurado;
  • repetir solicitudes GET idempotentes no modifica el estado del socio.

Pruebas de las exportaciones de Parkour Design al socio

Cuando Parkour Design envía datos a un socio, añade pruebas de contrato bilaterales para:

  • el listado de destinos y la validación de identificadores;
  • el envío solo del archivo;
  • el envío solo de los datos estructurados;
  • el envío correcto de todas las partes;
  • cada combinación posible de éxito parcial;
  • datos estructurados mal formados;
  • archivos vacíos y demasiado grandes;
  • las respuestas 401, 403, 404, 409, 413, 429 y 5xx del socio;
  • el tiempo de espera de conexión y el de respuesta;
  • los envíos duplicados y el comportamiento de idempotencia;
  • la desconexión, la reconexión y la caducidad de los tokens.

Aceptación manual

Haz lo siguiente en un navegador real contra el entorno de pruebas alojado.

EscenarioResultado esperado
Cuenta correctaEl consentimiento se completa y solo se devuelven los recursos de ese usuario
Consentimiento denegadoEl socio muestra un estado de cancelación recuperable y no guarda ningún token
Cuenta de Parkour Design equivocadaEl socio muestra la identidad con la que se ha iniciado sesión y permite volver a empezar de forma segura
Sesión existente en el socio con otra cuentaEl cambio de cuenta se comporta según las instrucciones de soporte aprobadas
Volver atrás y recargarNo se acepta dos veces ningún código de autorización ni valor de state
Doble clic en conectarSolo una transacción del navegador sigue siendo válida
Pestañas simultáneasUna llamada de retorno no puede asociarse a la transacción local equivocada
Llamada de retorno caducadaEl usuario puede volver a empezar sin un estado de conexión obsoleto
Token de acceso caducadoEl socio actualiza una vez o vuelve a pedir la autorización
Caída del socio o de Parkour DesignEl usuario recibe un mensaje recuperable sin diagnósticos sensibles
Desconectar y volver a conectarSe borran los tokens locales y se puede establecer una identidad nueva

Repite el flujo principal en todos los idiomas de interfaz admitidos. Los valores del protocolo no cambian, mientras que los mensajes para el usuario se traducen.

Pruebas para la revisión de seguridad

Proporciona a los revisores:

  • un diagrama de flujo de datos con el navegador, los dos servidores, el proveedor de identidad, las API y el almacenamiento de tokens;
  • las listas de URI de redirección y orígenes permitidos;
  • los scopes solicitados y su correspondencia con los recursos;
  • la configuración de cifrado y conservación de los tokens;
  • la configuración de validación del token de identidad;
  • ejemplos depurados de registros y alertas;
  • los resultados del análisis de dependencias y de secretos;
  • los resultados de las pruebas automáticas;
  • el registro completo de la aceptación manual;
  • los procedimientos de rotación de credenciales y de incidencias.

No adjuntes nunca como prueba códigos, tokens, secretos del cliente, claves privadas, respuestas de UserInfo sin procesar ni datos de clientes reales.

Observabilidad

Registra información suficiente para diagnosticar fallos sin registrar credenciales ni datos personales:

  • un ID de correlación generado por el socio;
  • el entorno y el sentido de la integración;
  • el nombre de la operación;
  • la categoría del endpoint remoto, no los parámetros de consulta;
  • el estado HTTP y un código de error OAuth seguro;
  • la duración y el número de reintentos;
  • un recuento depurado de recursos cuando sea útil para la operación.

No registres códigos de autorización, tokens de acceso, tokens de actualización, tokens de identidad, secretos del cliente, state, nonce, verificador PKCE, URL de redirección completas, direcciones de correo electrónico ni contenidos de planos de recorrido.

Las alertas deben distinguir los fallos de autenticación, los fallos de autorización, las caídas del socio, la latencia, los errores de esquema y la limitación de frecuencia sostenida.

Preparación para producción

Antes de emitir las credenciales de producción, ambos equipos deben aprobar:

  • el emisor y la URI de redirección de producción exactos;
  • la autenticación del cliente y el responsable de las credenciales;
  • los scopes y los recursos accesibles;
  • el volumen esperado y los límites actuales de la API;
  • el comportamiento de privacidad, conservación, desvinculación y eliminación;
  • las reglas de tiempos de espera, reintentos, idempotencia y éxito parcial;
  • la supervisión y la escalada de incidencias;
  • las instrucciones de soporte para los usuarios;
  • el procedimiento de marcha atrás o de desactivación de la integración;
  • el periodo y el responsable de la prueba de humo en producción.

Usa credenciales de cliente distintas para pruebas y producción. Entrégalas por el canal de secretos aprobado y comprueba la rotación antes del lanzamiento.

Prueba de humo en producción

Limita al máximo la primera prueba en producción:

  1. autoriza una cuenta interna aprobada;
  2. valida el token de identidad y obtén UserInfo;
  3. pide la lista de eventos;
  4. pide los resúmenes de proyectos de un evento conocido;
  5. comprueba el aislamiento entre usuarios y los campos esperados;
  6. actualiza una vez y guarda el token que sustituye al anterior;
  7. desconecta y borra las credenciales guardadas en local;
  8. revisa los registros y las alertas depurados;
  9. registra el resultado y decide si se habilita un acceso más amplio.

No pruebes en producción comportamientos destructivos ni de gran volumen, salvo que formen parte explícita del procedimiento de lanzamiento aprobado.

Registro de aceptación

Para cada escenario, registra:

  • el entorno y la versión de la compilación;
  • el responsable de la prueba y la fecha;
  • la identidad anonimizada de los datos de prueba;
  • el resultado esperado;
  • el resultado obtenido;
  • dónde están las pruebas;
  • el defecto o la limitación aceptada;
  • el responsable de la aprobación.

Una limitación no documentada no es una limitación aceptada. Añade los problemas de contrato o de seguridad sin resolver a la decisión de lanzamiento antes de habilitar el acceso a producción.