¿Necesito editar algo antes de usarlo?

No. Cada URL del documento está escrita como el token {{mock.url}}, que se expande a la dirección https://quickmock.dev/m/<slug> de este mismo mock en cada petición, así que el documento es coherente consigo mismo desde el momento en que lo creas. Solo tienes que editarlo si quieres que los endpoints apunten a otro sitio.

¿Por qué el emisor tiene que coincidir exactamente?

Los clientes comparan el issuer de este documento con la claim iss de los tokens que reciben y rechazan cualquier discrepancia. Basta una barra final para romperlo, lo que convierte esto en algo útil de probar a propósito.

¿Puedo completar un flujo de inicio de sesión real contra él?

No. El documento anuncia endpoints, pero nada los implementa. Combínalo con la plantilla de token OAuth2 para el paso del token y con la plantilla JWKS para el descubrimiento de claves y cubrirás una parte mayor del flujo.

Simular un documento de descubrimiento OpenID Connect

Un mock GET en /.well-known/openid-configuration con issuer, authorization_endpoint, token_endpoint, y jwks_uri.

Los clientes de OpenID Connect arrancan descargando un documento de discovery desde /.well-known/openid-configuration y leyendo de él los endpoints. Esta plantilla sirve ese documento, así que puedes probar el paso de discovery — y cómo lo gestiona tu cliente — sin levantar un proveedor de identidad.

Sustituye a un endpoint de API de terceros.

Payload de respuesta

{"issuer":"{{mock.url}}","authorization_endpoint":"{{mock.url}}/authorize","token_endpoint":"{{mock.url}}/token","jwks_uri":"{{mock.url}}/.well-known/jwks.json","response_types_supported":["code"],"subject_types_supported":["public"],"id_token_signing_alg_values_supported":["RS256"]}

Campos que vale la pena conocer

Campo	Lo que significa
issuer	La URL del emisor que los clientes comparan con la claim iss de un token; debe coincidir exactamente con la URL base.
authorization_endpoint	Hacia donde envía un cliente al usuario para iniciar sesión.
token_endpoint	Donde un cliente intercambia un código por tokens.
jwks_uri	Donde un cliente recupera las claves públicas: encaja con la plantilla jwks-endpoint.

Crear el mock

curl -X POST https://quickmock.dev/api/mocks \
  -H 'Content-Type: application/json' \
  -d '{
  "method": "GET",
  "response_status": 200,
  "content_type": "application/json",
  "path_suffix": ".well-known/openid-configuration",
  "response_body": "{\"issuer\":\"{{mock.url}}\",\"authorization_endpoint\":\"{{mock.url}}/authorize\",\"token_endpoint\":\"{{mock.url}}/token\",\"jwks_uri\":\"{{mock.url}}/.well-known/jwks.json\",\"response_types_supported\":[\"code\"],\"subject_types_supported\":[\"public\"],\"id_token_signing_alg_values_supported\":[\"RS256\"]}"
}'

Llamarlo

curl https://quickmock.dev/m/<slug>/.well-known/openid-configuration

Lo que obtienes

GET /m/<slug>/.well-known/openid-configuration -> 200 an OIDC discovery document
every advertised endpoint resolves to this mock via the {{mock.url}} token

En qué se diferencia de la realidad

Cada URL de este documento se construye con el token {{mock.url}}, de modo que resuelve a la dirección del propio mock en cada petición; pero nada de lo que hay detrás de esos endpoints está implementado, así que un cliente puede completar el discovery y ningún paso más. Editar el cuerpo de la respuesta requiere el token de administrador del banner de creación; en /guide/manage-mocks-from-any-device se explica cómo funciona.

Fuentes

Preguntas frecuentes

¿Necesito editar algo antes de usarlo?: No. Cada URL del documento está escrita como el token {{mock.url}}, que se expande a la dirección https://quickmock.dev/m/<slug> de este mismo mock en cada petición, así que el documento es coherente consigo mismo desde el momento en que lo creas. Solo tienes que editarlo si quieres que los endpoints apunten a otro sitio.
¿Por qué el emisor tiene que coincidir exactamente?: Los clientes comparan el issuer de este documento con la claim iss de los tokens que reciben y rechazan cualquier discrepancia. Basta una barra final para romperlo, lo que convierte esto en algo útil de probar a propósito.
¿Puedo completar un flujo de inicio de sesión real contra él?: No. El documento anuncia endpoints, pero nada los implementa. Combínalo con la plantilla de token OAuth2 para el paso del token y con la plantilla JWKS para el descubrimiento de claves y cubrirás una parte mayor del flujo.

¿Listo para usarlo?

Ábrelo en el generador de mocks para ajustarlo primero

Combina bien con esta guía: Simular un endpoint de API REST

Plantillas relacionadas

← Todas las plantillas

Última actualización: 2026-10-17