SecretsUsedInArgOrEnv: Do not use ARG or ENV instructions for sensitive data (ENV "DB_PASSWORD") (line 3)
Ai pus o parolă sau un token în ENV/ARG, iar valoarea rămâne salvată în imagine, vizibilă cu docker inspect și docker history. Scoate-o din Dockerfile și dă-o la rulare (docker run -e, --env-file, secretele Compose) sau, la build, cu --secret.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
SecretsUsedInArgOrEnv e o verificare BuildKit care caută în numele variabilelor din ARG și ENV cuvinte ca PASSWORD, SECRET, TOKEN sau KEY. Mesajul arată instrucțiunea (ENV "DB_PASSWORD") și linia.
De ce contează: tot ce pui în ENV intră în configurația imaginii. Oricine are imaginea vede parola cu docker inspect (în Config.Env) sau cu docker history, inclusiv după ce o urci într-un registry. ARG nu rămâne în Env, dar valoarea apare în istoricul straturilor care l-au folosit.
Build-ul nu cade, e un avertisment. Reparația e să separi imaginea (aceeași peste tot) de configurație (diferită pe fiecare mediu): parola o primește containerul la pornire, nu imaginea la build.
De ce apare: cauzele frecvente
1Parola în ENV
FROM node:20-alpine
ENV DB_PASSWORD=parola123
CMD ["node", "server.js"]FROM node:20-alpine
CMD ["node", "server.js"]
# la rulare:
# docker run -e DB_PASSWORD=parola123 api:1.0Valoarea ajunge doar în containerul pornit, nu în imaginea care circulă.
2Token de build în ARG
ARG NPM_TOKEN
RUN echo "//registry.npmjs.org/:_authToken=$NPM_TOKEN" > .npmrc && npm ciRUN --mount=type=secret,id=npmrc,target=/root/.npmrc npm ci
# docker build --secret id=npmrc,src=$HOME/.npmrc .Secretul montat cu --mount=type=secret există doar în acel RUN și nu intră în niciun strat.
3Parola în compose.yaml, în clar
environment:
DB_PASSWORD: parola123env_file: .env
# .env, trecut în .gitignore:
# DB_PASSWORD=parola123Fișierul .env rămâne pe calculator și nu ajunge în Git.
Repară eroarea, direct în pagină
În ~/api, Dockerfile-ul are ENV DB_PASSWORD=parola123, iar build-ul afișează SecretsUsedInArgOrEnv. Scoate parola din imagine, reconstruiește api:1.0 și pornește containerul api cu parola dată la rulare (DB_PASSWORD=parola123). Containerul trebuie să afișeze Conectat la baza.
Indiciu
Șterge linia ENV, reconstruiește, apoi docker run --name api -e DB_PASSWORD=parola123 api:1.0.
Reparația
FROM node:20-alpine
WORKDIR /app
CMD ["node", "-e", "console.log(process.env.DB_PASSWORD ? 'Conectat la baza' : 'Lipseste parola')"]docker build -t api:1.0 .
docker run --name api -e DB_PASSWORD=parola123 api:1.0Conectat la bazaDe ce merge
Cu ENV, parola era scrisă în configurația imaginii și o vedea oricine avea api:1.0. Fără linia ENV, imaginea nu mai conține nicio parolă. Containerul o primește la pornire prin -e, deci process.env.DB_PASSWORD există și aplicația afișează Conectat la baza. Aceeași imagine poate rula acum cu alte parole pe alte medii.
Alte forme ale mesajului
SecretsUsedInArgOrEnv: Do not use ARG or ENV instructions for sensitive data (ARG "API_TOKEN") (line 2)SecretsUsedInArgOrEnv: Do not use ARG or ENV instructions for sensitive data (ENV "AWS_SECRET_ACCESS_KEY") (line 6)
Cum o eviți pe viitor
Nu scrie niciodată valori secrete în Dockerfile. Pentru rulare, folosește -e/--env-file sau secretele din Compose; pentru build (tokenuri de npm, pip, git), RUN --mount=type=secret. Verifică imaginile înainte de push cu docker inspect -f '{{json .Config.Env}}' imagine și docker history --no-trunc imagine. Dacă un secret a ajuns deja într-o imagine publicată, schimbă-l: ștergerea imaginii nu e suficientă.
Întrebări frecvente
Și -e nu e vizibil în docker inspect?
Ba da, pentru cine are acces la daemon-ul acelui server. Dar nu mai circulă odată cu imaginea în registry. Pentru protecție mai bună, folosește secretele Compose sau ale platformei (Kubernetes, AWS).
Avertismentul apare și pentru DB_PASSWORD_FILE?
Poate apărea, pentru că verificarea se uită la nume. Acolo valoarea e doar o cale de fișier, deci nu e o problemă reală.
Erori înrudite
WARNING! Using --password via the CLI is insecure. Use --password-stdin. E un avertisment, nu o eroare: login-ul poate reuși, dar parola dată cu -p rămâne în istoricul shell-ului și în jurnalele CI. Trimite-o prin intrarea standard: cat token.txt | docker login -u andrei --password-stdin (sau echo "$TOKEN" | ... în pipeline). WARN[0000] The "DB_PAROLA" variable is not set. Defaulting to a blank string. compose.yaml folosește ${DB_PAROLA}, dar variabila nu există nici în shell, nici în fișierul .env de lângă compose.yaml, așa că Compose pune un șir gol. Adaugă DB_PAROLA=valoare în .env (în folderul proiectului) sau exportă variabila înainte de docker compose up. UndefinedVar: Usage of undefined variable '$VERSIUNE' (line 3) Build-ul folosește o variabilă care nu e declarată în etapa curentă, deci primește un text gol. Cel mai des, ARG e declarat înainte de FROM: redeclară-l după FROM (ARG VERSIUNE), ca valoarea să ajungă în etapă. Învață Docker de la zero, cu exerciții la fiecare lecție
Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
