Aplicaciones y claves
Una aplicación de Echo representa a un consumidor o proveedor de tu espacio de trabajo. No es una persona iniciando sesión en Maestro. Sus claves eck_ permiten que las automatizaciones usen APIs concretas de Echo sin reutilizar la sesión de un usuario.
Registra la aplicación
Abre Aplicaciones en Maestro, crea la aplicación y añade sus vínculos con contratos. Elige Consumes para una operación que llama o Provides para una que ofrece, y selecciona la versión acordada. Crear o modificar aplicaciones, vínculos y claves requiere Echo Pro o Pro AI y el permiso Echo/ManageHosting del grupo MockServers. Con un plan de pago, el administrador de la organización recibe este permiso por defecto y puede concedérselo a otro rol. Echo Pro AI aparece como próximo y todavía no se puede contratar.
En el Free, el enlace de Aplicaciones no aparece en el menú, pero puedes abrir la dirección anterior directamente para listar aplicaciones y claves y revocar una clave expuesta. Esas tres acciones requieren solo Echo/MockServers; no permiten crear ni renovar credenciales.
Concede los permisos necesarios
| Scope | Permite | No permite |
|---|---|---|
ReadBoundContracts |
Leer contratos consumidos vinculados a esta aplicación y sus cambios de compatibilidad | Publicar versiones o leer todos los contratos del espacio de trabajo |
PublishOwnedContracts |
Publicar versiones de contratos existentes con vínculo Provides para esta aplicación |
Crear contratos, asumir su propiedad o publicar contratos de otra aplicación |
ServeMocks |
Obtener reglas de mocks activos compartidos por los equipos del espacio de trabajo | Obtener mocks personales, gestionar alojamiento o autorizar la publicación de contratos |
ServeMocks no se limita a los vínculos con contratos de esta aplicación. Lee reglas de mocks compartidos en el espacio de trabajo y no exige que los mocks estén publicados en el servicio público, pero obtener esas reglas requiere una suscripción Echo Pro o Pro AI en vigor. Con Free, una clave ya emitida puede seguir leyendo contratos con ReadBoundContracts, mientras que la petición de reglas recibe 403. Usa claves distintas para el CI del consumidor y la publicación del proveedor.
Emite y guarda una clave
- Abre las claves de la aplicación, crea una y selecciona solo los scopes necesarios.
- Describe su finalidad y elige una caducidad.
- Copia el secreto completo inmediatamente. Solo se muestra una vez; las listas posteriores muestran el prefijo y los metadatos.
- Guárdalo en los secretos del CI, en el entorno o en un almacén seguro. Nunca lo incluyas en commits, código de navegador, capturas de pantalla o URLs.
Los ejemplos de paquetes usan variables de entorno. Los paquetes envían la clave a la API, no a la URL del mock publicado en el servicio público. El identificador público de ese mock es un mecanismo de acceso distinto.
Sustituye y revoca
Con Echo Pro o Pro AI, para sustituir una credencial, crea otra, actualiza el proceso consumidor, verifícalo y revoca la clave anterior. Revoca las claves perdidas o expuestas desde la lista de claves de la aplicación; genera otra en vez de intentar recuperar el secreto. Si pierdes el plan de pago, abre Aplicaciones en Maestro directamente: todavía puedes listar y revocar claves con Echo/MockServers, aunque no emitir ni renovar otra hasta recuperar el plan.
La revocación impide futuros accesos autenticados a la API. No borra las reglas que Mock.Client o Mock.Server ya tienen en caché: si una actualización falla, conservan la última instantánea. Para detener el uso de mocks inmediatamente, desactiva la interceptación o para el proceso y gestiona su caché explícitamente.
Para desactivar una URL de mock publicada o sustituir su identificador, usa el panel de alojamiento público de mocks. Revocar una clave eck_ no desactiva esa URL.