Incidentu reaģēšana

PostgreSQL "password authentication failed for user": kā atrast īsto cēloni

Klients vienmēr saņem vienu un to pašu vienas rindas kļūdu, vai parole ir nepareiza, loma neeksistē, parolei beidzies termiņš vai jaucējvērtība ir nepareizā formātā. Īstais iemesls ir servera žurnālā, divas rindas zemāk.

· 13 min lasīšanai · AG Data komanda

"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:

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:

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:

  1. .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.
  2. 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".
  3. 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.
  4. Docker. Oficiālais attēls piemēro POSTGRES_PASSWORD tikai 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:

Galvenās atziņas

PostgreSQL Kļūdas Autentifikācija Drošība
Sadarbība ar mums

Lietotnes nevar pieslēgties datubāzei?

Mēs noskaidrojam, kāpēc pieteikšanās neizdodas, pārejam no MD5 uz SCRAM bez dīkstāves, iestatām PgBouncer autentifikāciju un plānojam paroļu rotāciju, kas neaptur jūsu lietotnes.

Sazināties Vairāk no emuāra