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:
issueres 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,RS256yS256; - 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,noncey 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
statecorrecto una sola vez; - rechaza un
stateausente, distinto, caducado o reutilizado; - gestiona
access_deniedsin 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
itemsvací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,429y5xxsiguen 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
GETidempotentes 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,429y5xxdel 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.
| Escenario | Resultado esperado |
|---|---|
| Cuenta correcta | El consentimiento se completa y solo se devuelven los recursos de ese usuario |
| Consentimiento denegado | El socio muestra un estado de cancelación recuperable y no guarda ningún token |
| Cuenta de Parkour Design equivocada | El 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 cuenta | El cambio de cuenta se comporta según las instrucciones de soporte aprobadas |
| Volver atrás y recargar | No se acepta dos veces ningún código de autorización ni valor de state |
| Doble clic en conectar | Solo una transacción del navegador sigue siendo válida |
| Pestañas simultáneas | Una llamada de retorno no puede asociarse a la transacción local equivocada |
| Llamada de retorno caducada | El usuario puede volver a empezar sin un estado de conexión obsoleto |
| Token de acceso caducado | El socio actualiza una vez o vuelve a pedir la autorización |
| Caída del socio o de Parkour Design | El usuario recibe un mensaje recuperable sin diagnósticos sensibles |
| Desconectar y volver a conectar | Se 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:
- autoriza una cuenta interna aprobada;
- valida el token de identidad y obtén UserInfo;
- pide la lista de eventos;
- pide los resúmenes de proyectos de un evento conocido;
- comprueba el aislamiento entre usuarios y los campos esperados;
- actualiza una vez y guarda el token que sustituye al anterior;
- desconecta y borra las credenciales guardadas en local;
- revisa los registros y las alertas depurados;
- 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.