"password authentication failed for user" nozīmē, ka klients sasniedza PostgreSQL, kāds pg_hba.conf noteikums atbilda un pieprasīja paroli, un pārbaude neizdevās. Dokumentācija to apraksta tieši tā: serveris ir gatavs ar jums runāt, bet tikai pēc tam, kad būsiet izturējis pg_hba.conf norādīto autentifikācijas metodi (autentifikācijas problēmas). Ziņojums ir apzināti neskaidrs. Iemesls ir servera žurnālā.
psql: error: connection to server at "db1" (10.0.0.5), port 5432 failed:
FATAL: password authentication failed for user "app"
Vispirms izlasiet servera žurnālu
Dokumentācijas padoms ir īss un vērts sekot: servera žurnālā var būt vairāk informācijas par autentifikācijas kļūdu, nekā tiek paziņots klientam. Klients nekad neredz iemeslu; žurnālā ir DETAIL rinda, un pašreizējās versijās arī atbilstošā pg_hba.conf rinda:
FATAL: password authentication failed for user "app"
DETAIL: Password does not match for user "app".
Connection matched file "/etc/postgresql/18/main/pg_hba.conf" line 98: "host all all 10.0.0.0/8 scram-sha-256"
Šie teksti nāk no PostgreSQL pirmkoda (crypt.c, auth.c), un katrs norāda uz citu risinājumu:
Password does not match for user "app".Parole tiešām ir nepareiza, vai klients sūta citu paroli, nekā jūs domājat (skatiet sadaļu par klientu zemāk).Role "app" does not exist.Šādas lomas nav. Paroļu metodēm serveris tik un tā izspēlē autentifikāciju, lai klients nevarētu uzzināt, vai lietotājs eksistē; tāpēc jūs redzat "password authentication failed", nevis "role does not exist".User "app" has no password assigned.Loma eksistē, bet tai nav paroles; bieži tā ir loma, kas izveidotapeervai sertifikātu pieteikšanās vajadzībām.User "app" has an expired password.Lomai irVALID UNTILdatums pagātnē.User "app" has a password that cannot be used with MD5 authentication.Jaucējvērtības formāta problēma, par to sadaļā par MD5 un SCRAM.
Svarīga ir arī rinda Connection matched. pg_hba.conf lieto pirmo ierakstu, kas atbilst savienojuma tipam, adresei, datubāzei un lietotājam, un nākamie netiek mēģināti: ja šī ieraksta autentifikācija neizdodas, vēlākie ieraksti netiek ņemti vērā (pg_hba.conf). Ja atbilstošā rinda nav tā, ko gaidījāt, jālabo noteikumu secība, nevis parole. Ja noteikuma nav vispār, kļūda ir cita, par to rakstā no pg_hba.conf entry for host.
Pārbaudiet lomu
SELECT rolname, rolcanlogin, rolvaliduntil,
left(rolpassword, 14) AS hash_type -- needs superuser
FROM pg_authid
WHERE rolname = 'app';
-- which pg_hba.conf line will match, and did the file load cleanly?
SELECT line_number, type, database, user_name, address, auth_method, error
FROM pg_hba_file_rules;
rolcanlogin jābūt true, rolvaliduntil jābūt tukšam vai nākotnē, un rolpassword sākums parāda jaucējvērtības tipu: SCRAM-SHA-256$ vai md5. pg_hba_file_rules rāda noteikumus tā, kā tie ielādēti, un aizpilda kolonnu error rindām ar problēmām; atcerieties, ka pg_hba.conf izmaiņas stājas spēkā tikai pēc pārlādes (pg_ctl reload, SELECT pg_reload_conf() vai SIGHUP), izņemot Windows (pg_hba.conf).
Jaunu paroli labāk iestatiet ar \password psql, nevis rakstot ALTER ROLE ... PASSWORD '...': psql paprasa paroli, to šifrē un nosūta kā ALTER ROLE komandu, tāpēc jaunā parole atklātā tekstā neparādās komandu vēsturē vai servera žurnālā (psql).
-- in psql: prompts for the password and sends it encrypted,
-- so it does not appear in cleartext in history or server logs
\password app
-- expired password
ALTER ROLE app VALID UNTIL 'infinity';
-- role exists but cannot log in
ALTER ROLE app LOGIN;
MD5 un SCRAM
Kopš PostgreSQL 14 password_encryption noklusējums ir scram-sha-256 (savienojuma iestatījumi). Mijiedarbība ar pg_hba.conf ir asimetriska:
pg_hba.confrinda armd5un parole, kas saglabāta kā SCRAM, darbojas: serveris automātiski izvēlas SCRAM (paroļu autentifikācija). Klienta bibliotēkai jāatbalsta SCRAM, ko ļoti veci draiveri neatbalsta.- Rinda ar
scram-sha-256un parole, kas joprojām saglabāta kā MD5, neizdodas. Tā ir klasiskā kļūda pēc jaunināšanas, kadpg_hba.confpārslēgts uzscram-sha-256, bet vecās MD5 jaucējvērtības atnāca līdzi no vecā klastera.
Dokumentētā pāreja: pārliecinieties, ka visas klientu bibliotēkas atbalsta SCRAM, iestatiet password_encryption = 'scram-sha-256', lieciet katram lietotājam iestatīt jaunu paroli, pēc tam nomainiet pg_hba.conf uz scram-sha-256. MD5 ir novecojis; kopš PostgreSQL 18 CREATE ROLE un ALTER ROLE brīdina, kad tiek iestatīta MD5 parole, un to vada md5_password_warnings (PostgreSQL 18 laidiena piezīmes).
Vai klients sūta to paroli, ko jūs domājat?
Mūsu pieredzē, kad žurnālā ir "Password does not match", parole parasti ir pareiza, bet klients sūta ko citu:
- .pgpass. Formāts ir
hostname:port:database:username:password, uzvar pirmā atbilstošā rinda, un:vai\vērtībā jāaizsargā ar\. Unix sistēmās fails tiek ignorēts, ja grupai vai citiem ir jebkāda piekļuve (.pgpass). Novecojusi rinda ar aizstājējzīmēm virs pareizās ir biežs pārsteigums. - Savienojuma URI. Rakstzīmes ar īpašu nozīmi URI (
@,:,/,%un citas) jākodē ar procentu kodējumu (libpq savienojuma virknes). Parole ar@postgresql://adresē ir biežs iemesls situācijai "psql strādā, lietotnē ne". - Vide un noslēpumi. Jaunas rindas simbols noslēpuma faila beigās, vecs
PGPASSWORDčaulas profilā vai konfigurācija, kas nav pārlādēta. - Docker. Oficiālais attēls piemēro
POSTGRES_PASSWORDtikai tad, ja konteiners startē ar tukšu datu direktoriju; esoša datubāze netiek aiztikta (postgres Docker attēls). Mainot mainīgo konteineram ar pastāvīgu sējumu, parole nemainās.
Labojiet pareizajā pusē. Ja žurnāls saka, ka loma neeksistē vai parolei beidzies termiņš, lietotnes konfigurācijas maiņa neko nedos. Ja tas saka, ka parole neatbilst, un jūs to tikko atiestatījāt, pirms atkārtotas atiestatīšanas paskatieties, ko klients sūta.
PgBouncer pa vidu
Aiz PgBouncer ir divas pieteikšanās: klients pie PgBouncer un PgBouncer pie PostgreSQL. Kļūda var nākt no jebkuras, tāpēc pārbaudiet abus žurnālus. PgBouncer lietotājus lasa no auth_file (atklāts teksts, MD5 vai SCRAM noslēpumi) vai meklē ar auth_query. Pie PostgreSQL ar saglabātu SCRAM noslēpumu tas var pieteikties tikai tad, ja arī klients lieto SCRAM, datubāzes ierakstā nav norādīts fiksēts lietotājs un noslēpums ir identisks servera noslēpumam, ar to pašu sāli un iterācijām, nevis tikai to pašu paroli (PgBouncer konfigurācija). Pēc paroles maiņas serverī auth_file ar veco noslēpumu salauž katru jaunu servera savienojumu. Pūla iestatīšana ir aprakstīta rakstā PgBouncer savienojumu pūls PostgreSQL.
Kas mainās ar daudzām lietotnēm un lielām sistēmām
Klēpjdatorā viena nepareiza parole ir viena kļūda. Sistēmā ar desmitiem servisu un simtiem podu:
- Paroļu rotācija. Lomas paroles maiņa salauž katru klientu, kas maiņas brīdī joprojām lieto veco. Mūsu pieredzē drošs paņēmiens ir divas pieteikšanās lomas katrai lietotnei, kas ir vienas grupas lomas dalībnieces ar privilēģijām: rotējiet vienu, kamēr klienti lieto otru, tad pārslēdziet.
- Termiņš kā avārija.
VALID UNTILdatums, kas iestatīts pirms gadiem vai drošības politikas dēļ, beidzas visiem klientiem vienlaikus. Uzraugietrolvaliduntillietotņu lomām. - Atkārtojumu vētras. Simtiem instanču, kas ciklā bez pauzes atkārto neizdevušos pieteikšanos, pārpludina servera žurnālu un tērē CPU SCRAM aprēķiniem. Iterāciju skaits tiek fiksēts paroles iestatīšanas brīdī (
scram_iterations, noklusējums 4096), un dokumentācija norāda, ka vairāk iterāciju padara autentifikāciju lēnāku. Savienojumu atkārtojumos lietojiet pieaugošu pauzi. - Lielas versijas jaunināšana un migrācijas. MD5 jaucējvērtību pārnešana uz klasteri, kura
pg_hba.confprasascram-sha-256, bloķē katru lomu, kas nav atiestatījusi paroli. Pirms pārslēgšanas pārbaudietrolpasswordprefiksus visām pieteikšanās lomām. - Uzraudzība. Pēkšņs autentifikācijas kļūdu pieaugums žurnālā ir vai nu salauzta izvietošana, vai kāds, kas min paroles. Abos gadījumos vajag brīdinājumu.
Galvenās atziņas
- Klienta kļūda vienmēr ir tā pati; īsto cēloni pasaka
DETAILrinda servera žurnālā. - Pārbaudiet
rolcanlogin,rolvaliduntilun jaucējvērtības tipupg_authid, kā arī atbilstošopg_hba.confrindu. md5pg_hba.confpieņem SCRAM paroles;scram-sha-256nepieņem MD5 jaucējvērtības.- Meklējiet nepareizas paroles
.pgpass, nekodētos URI, novecojušos noslēpumos un Docker sējumos. - Aiz PgBouncer pārbaudiet abus posmus un turiet SCRAM noslēpumus sinhronus.
- Rotējiet paroles ar divām lomām, uzraugiet termiņus un atkārtojiet pieteikšanos ar pauzēm.