Ir al contenido
↑↓ moverse↵ abriresc cerrar

Autorización

Secretos y qué va a los archivos

Qué campos de la autorización son secretos, dónde los guarda Luvin, qué se escribe en los archivos y en git, y dónde se enmascaran los valores.

3 min de lectura

Un secreto es un valor que no debe filtrarse: una contraseña, un token, una clave. Luvin deja los valores de los secretos fuera de los archivos de tu workspace, así que puedes poner el workspace en git.

Ejemplo: el mismo request, guardado de dos maneras

Sección titulada «Ejemplo: el mismo request, guardado de dos maneras»

Escribes abc123 en Token. El archivo del request no guarda el token:

requests/orders.request.yaml
auth:
type: bearer
prefix: Bearer

abc123 se guarda cifrado en tu equipo. Quien abra la colección tendrá que escribirlo de nuevo.

Un valor que contiene {{ cuenta como referencia y va al archivo tal como está escrito.

Tipo Campos secretos Van al archivo tal como los escribes
API Key Valor Nombre, Enviar en
Basic Auth Contraseña Usuario
Bearer Token Token Prefijo del header
OAuth 2.0 Client Secret, Contraseña URLs, Client ID, Usuario, Scope, Audience
OAuth 1.0 Consumer Secret, Access Token, Token Secret Consumer Key, Realm, Método de firma
Digest Auth, WSSE Auth, NTLM Auth Contraseña Usuario, Dominio, Estación de trabajo
AWS Sig v4 Secret Access Key, Session Token Access Key ID, Servicio, Región
Akamai EdgeGrid Client Token, Client Secret, Access Token Headers a firmar, Tamaño máximo del body

Los campos secretos van ocultos mientras escribes. Haz clic en el ojo (Mostrar / Ocultar) para verlos. Usa una variable para cualquier otro valor que no quieras en git, como un usuario o un Client ID.

Los valores que pegas en las Credenciales de un ambiente y las variables que marcas como secretos también quedan fuera de los archivos.

Versión Almacenamiento
App de escritorio Cifrados con el llavero del sistema operativo. Si no está disponible, la app no guarda los valores secretos: hay que escribirlos de nuevo.
Versión web Cifrados en el navegador de este dispositivo, con una clave que no se puede exportar.

Los secretos escritos tal cual se guardan por request, por colección (collection.yaml guarda el resto), por configuración de workflow (flow-auth.yaml guarda el resto) y por ambiente.

Archivo Contiene
requests/*.request.yaml El bloque auth, sin los campos secretos escritos tal cual.
collection.yaml El auth de la colección, sin secretos escritos tal cual.
flow-auth.yaml La autorización de los workflows, sin secretos escritos tal cual.
environments/*.yaml Los nombres de los secretos, nunca sus valores.

Los tokens de acceso y de refresco de OAuth 2.0 no se escriben en ningún lado: quedan en memoria mientras la colección está abierta.

  • Request enviado de un request muestra el header Authorization acortado, como Bearer eyJhbGci…x9Qw. Los valores secretos en la URL y en los headers aparecen como ••••.
  • Los resultados y reportes de los workflows muestran los secretos y credenciales del ambiente como ••••.
  • Dev Tools muestra los secretos enmascarados, y Copiar como cURL escribe <secret> donde tienes que poner el valor.
  • En la pestaña Headers, la fila Authorization que agrega Luvin se muestra como Bearer ••••••.