Entornos y variables
Parametriza tus llamadas con variables interpolables y protege contraseñas mediante almacenes seguros nativos.
Variables interpolables {{...}}
Las variables te permiten parametrizar tus peticiones para alternar fácilmente entre servidores de desarrollo, homologación y producción sin duplicar operaciones.
Puedes usar variables con la sintaxis de dobles llaves {{miVariable}} en:
- La URL base y las rutas de operaciones (ej.
{{baseUrl}}/api/v1/recursos). - Los parámetros de query string.
- Los valores de las cabeceras HTTP.
- El cuerpo de la petición (JSON, XML o texto).
Variables secretas y seguridad nativa
En el diálogo Ver › Entornos…, puedes marcar cualquier variable con la casilla Secreta. Estas variables reciben un tratamiento especial para garantizar que nunca se filtren:
- Nunca van a Git: El archivo JSON del entorno solo almacena el nombre de la variable y la propiedad
"secret": true. El valor nunca se guarda en disco dentro del workspace. - Almacén seguro del sistema: El valor se guarda en el almacén de credenciales del sistema operativo:
- macOS: Llavero de contraseñas de Apple (Keychain).
- Windows: Administrador de credenciales de Windows (Credential Manager).
- Linux: Secret Service vía libsecret (GNOME Keyring o KWallet).
- Entornos de CI/CD: Si ejecutas pruebas automatizadas en máquinas sin servidor gráfico ni llavero de usuario, CispalMocks lee los secretos de variables de entorno del sistema con el prefijo
CISPAL_SECRET_<NOMBRE>.
