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.
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:
auth: type: bearer prefix: Bearerabc123 se guarda cifrado en tu equipo. Quien abra la colección tendrá que escribirlo de nuevo.
Escribes {{token}} en Token. El archivo guarda el nombre:
auth: type: bearer token: "{{token}}" prefix: BearerCada persona completa token en su propio ambiente. Se comparte la configuración, no el valor.
Un valor que contiene {{ cuenta como referencia y va al archivo tal como está escrito.
Qué campos son secretos
Sección titulada «Qué campos son secretos»| 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.
Dónde se guardan los valores
Sección titulada «Dónde se guardan los valores»| 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.
Qué va a los archivos y a git
Sección titulada «Qué va a los archivos y a git»| 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.
Dónde se enmascaran los valores
Sección titulada «Dónde se enmascaran los valores»- Request enviado de un request muestra el header
Authorizationacortado, comoBearer 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
Authorizationque agrega Luvin se muestra comoBearer ••••••.