Web & Udvikling

PHP Passwordhashing: Argon2id, bcrypt og sikker migration

PHP Password Hashing: Argon2id, bcrypt and Secure Migration

Lær, hvordan du sikkert kan hash'e adgangskoder i PHP ved hjælp af Argon2id og bcrypt, vælger sikre parametre, verificerer adgangsoplysninger og migrerer eksisterende hashes uden at tvinge til passwordreset.

PHP-passwordhashing: Argon2id, bcrypt og sikker migration

Passwordopbevaring er en af de vigtigste sikkerhedsmæssige beslutninger i en webapplikation. Et databrud bør ikke umiddelbart afsløre brugernes adgangsoplysninger, men svag passwordhashing kan gøre det billigt for angribere at udnytte stjålne hashes.

PHP har indbyggede funktioner til hashing, verifikation og opgradering af adgangskoder. Udfordringen er at vælge den rigtige algoritme, konfigurere den til din infrastruktur og migrere eksisterende konti uden at forstyrre autentificeringsprocessen.

Til nye applikationer er Argon2id generelt det foretrukne valg, når din PHP-opbygning understøtter det. bcrypt forbliver en praktisk kompatibilitetsmulighed. Begge bør bruges gennem PHP's password API i stedet for gennem selvudviklet kryptografi.

Denne guide dækker implementering, parameterudvælgelse, migration af gamle systemer og almindelige fejl.

Hvorfor er SHA-256 ikke egnet til passwordopbevaring?

SHA-256 er designet til at være hurtig, hvilket gør den nyttig til integritetskontroller, men uegnet som den er alene til passwordopbevaring: En angriber med stjålne hashes kan teste mange passwordgæt hurtigt.

Dedikerede passwordhashing-algoritmer forbruger bevidst flere ressourcer. Argon2id kan kræve betydelig hukommelse såvel som behandlingstid, hvilket gør storstilet gætning dyrere.

Et sikkert opbevaringssystem kræver et unikt, tilfældigt salt, en konfigurerbar arbejdsfaktor og en måde at øge arbejdsfaktoren, når hardware forbedres. PHP's password_hash() genererer og gemmer den nødvendige saltinformation automatisk.

OWASP Password Storage Cheat Sheet anbefaler adaptiv passwordhashing i stedet for hurtige generelle hashfunktioner.

Argon2id vs bcrypt: hvad skal du vælge?

Egenskab Argon2id bcrypt
Hovedforsvar Hukommelses- og beregningsomkostning Beregningsomkostning
Hukommelseshård Ja Nej
Konfigurerbare parametre Hukommelse, iterationer, parallelitet Omkostningsfaktor
Passwordinputgrænse Ingen bcrypt-lignende 72-byte-grænse 72 bytes
Tilgængelighed i PHP Afhænger af opbygning Bredt tilgængelig
Bedste egnethed Foretrukket til ny passwordopbevaring Kompatibilitet og legacy-systemer

Argon2id er designet til at modstå angreb, der drager fordel af massivt parallelt hardware. bcrypt er stadig en legitim adaptiv passwordhashing-algoritme, men dens inputgrænse kræver forsigtighed: Den overvejer højst de første 72 bytes, ikke tegn.

Antag ikke, at PASSWORD_DEFAULT vælger Argon2id. PHP's password_hash-dokumentation dokumenterer i øjeblikket bcrypt som sin standardalgoritme. PHP 8.4 hævede bcrypt's standardomkostning fra 10 til 12, hvilket illustrerer, hvorfor afhængighed af implisitte parametre kan ændre applikationens ydeevne efter opgraderinger.

Trin 1: Kontroller Argon2id-understøttelse

Argon2id er ikke nødvendigvis tilgængelig på alle hostingmiljøer. Kontroller runtime, før du vælger den:

<?php
declare(strict_types=1);

if(in_array('argon2id', password_algos(), true)) {
    echo 'Argon2id is available';
} else {
    echo 'Argon2id is not available';
}

Tilgængeligheden afhænger af, hvordan PHP blev bygget. Antag ikke, at en opgradering af PHP-versionen automatisk aktiverer Argon2id.

Trin 2: Hashe en adgangskode med Argon2id

OWASP dokumenterer flere acceptable basiskonfigurationer. En bruger 19 MiB hukommelse, to iterationer og parallelitet på ét. PHP udtrykker memory_cost i KiB, så 19 MiB er 19 * 1024 KiB.

<?php
declare(strict_types=1);

$options = [
    'memory_cost' => 19 * 1024,
    'time_cost' => 2
];

$password = 'example-user-password';

$hash = password_hash(
    $password,
    PASSWORD_ARGON2ID,
    $options
);

Parallellitetsmuligheden threads understøttes med nogle Argon2-backends, herunder libargon2, men ikke alle PHP-opbygninger. Hvis den understøttes, matcher en værdi på ét denne basiskonfiguration; at udelade den er mere portabel. Benchmark din faktiske konfiguration.

Den resulterende koderede hash inkluderer algoritmeidentifikatoren, parametre og salt. Der er ingen grund til at gemme disse værdier i separate databasekolonner. En VARCHAR(255)-kolonne er et fornuftigt udgangspunkt for moderne passwordhashes, forudsat at den lagrer hele den koderede værdi.

Disse er basisparametre, ikke en universel produktionskonfiguration. Test latens og hukommelsesforbrug under realistisk samtidig autentifikations trafik.

Trin 3: Verificer adgangsoplysninger korrekt

Illustration of the article's main concept

Da hver passwordhash bruger et tilfældigt salt, vil det ikke fungere at generere en ny hash og sammenligne strenge. Brug password_verify():

<?php
declare(strict_types=1);

$submittedPassword = (string)($_POST['password'] ?? '');
$storedHash = (string)$user['password_hash'];

if(!password_verify($submittedPassword, $storedHash)) {
    // Reject authentication without disclosing account existence.
    return;
}

// The password is valid. Continue with secure session handling.

PHP-dokumentationen https://www.php.net/manual/en/function.password-verify.php angiver, at password_verify() er sikker mod timingangreb. Den læser algoritmen og arbejds parametrene fra den gemte hash.

Passwordverifikation erstatter ikke login-throttling, sikre sessioner, HTTPS, passende fejlhåndtering eller multifaktorautentificering.

Trin 4: Opgrader eksisterende passwordhashes under login

password_needs_rehash() registrerer, når en gemt hash bruger en forældet algoritme eller parametre. Dette muliggør gradvis migration uden at tvinge alle aktive brugere til at nulstille deres password.

<?php
declare(strict_types=1);

$options = [
    'memory_cost' => 19 * 1024,
    'time_cost' => 2
];

if(password_verify($submittedPassword, $storedHash)) {
    if(password_needs_rehash(
        $storedHash,
        PASSWORD_ARGON2ID,
        $options
    )) {
        $newHash = password_hash(
            $submittedPassword,
            PASSWORD_ARGON2ID,
            $options
        );

        // Persist with a prepared statement.
        // Prefer a conditional UPDATE to avoid overwriting
        // a newer hash from a concurrent request.
    }

    // Finish authentication and rotate the session identifier.
}

Rehash kun efter at have verificeret det indsendte password med succes. En betinget opdatering kan sikre, at den gemte hash stadig matcher den værdi, der netop blev verificeret. Opdater for eksempel passwordhash kun, hvor både bruger-ID og gammel hash matcher.

Se PHP password_needs_rehash() for API-detaljer.

Trin 5: Migrer gamle MD5 eller SHA-1 hashes

Ældre applikationer kan indeholde MD5, SHA-1 eller tilpassede passwordformater. Sådanne hashes kan ikke altid verificeres med password_verify().

En migration bør følge en kontrolleret sekvens:

  1. Identificer det gamle format ved hjælp af betroet metadata eller et entydigt, dokumenteret format.
  2. Verificer det indsendte password ved hjælp af den originale legacy-ordning kun for konti, der stadig kræver det.
  3. Efter vellykket verifikation skal du straks oprette en moderne hash ved hjælp af password_hash().
  4. Erstat den gemte legacy-hash ved hjælp af en sikker databaseopdatering.
  5. Træk legacy-verifikation tilbage, når migrationen er fuldført.

Gæt ikke algoritmen alene ud fra hashlængden, når flere formater er mulige. Forsøg ikke at dekryptere passwordhashes: Hashing er ikke kryptering.

For konti, der aldrig logger ind, overvej en password-resetpolitik i stedet for at bevare svage hashes i evigheder. Introducer ikke en usikker fallback-sti, der accepterer svage hashes for nye registrerede brugere.

Trin 6: Benchmark hashing på din infrastruktur

De rigtige omkostningsparametre afhænger af din hardware, det samtidige login-volume og latenskravene.

<?php
declare(strict_types=1);

$options = [
    'memory_cost' => 19 * 1024,
    'time_cost' => 2
];

$start = hrtime(true);

$hash = password_hash(
    'benchmark-password',
    PASSWORD_ARGON2ID,
    $options
);

$milliseconds = (hrtime(true) - $start) / 1_000_000;

echo round($milliseconds, 2) . ' ms';
Technical workflow illustration

Udfør kun dette i et kontrolleret miljø, ikke som en offentlig webendepunkt. Mål også verifikation, og gentag under repræsentativ belastning. En indstilling, der ser hurtig ud i isolation, kan opbruge RAM, når mange anmodninger ankommer samtidig.

OWASP anbefaler at balancere sikkerhed med driftkapacitet og generelt holde individuelle hashing-operationer under ét sekund.

Almindelige fejl ved passwordhashing

Tilføjelse af et fast salt manuelt. PHP genererer allerede sikre salte til sin password API. Et fast salt fjerner en vigtig beskyttelse.

Brug af rå MD5, SHA-1 eller SHA-256. Disse algoritmer er alt for hurtige til passwordopbevaring alene.

Ignorering af bcrypt's 72-byte-grænse. Multibyte UTF-8-tegn kan nå denne grænse hurtigere end brugere forventer.

Valg af ekstreme omkostningsindstillinger. Ekscessivt hukommelses- eller CPU-krav kan skabe en denial-of-service-risiko ved autentificeringsendepunkter.

Logning af indsendte adgangskoder. Undgå at eksponere adgangsoplysninger gennem fejlsøgningslogs, overvågningssystemer eller fejlrapporter.

Antagelse af, at passwordhashing løser autentificeringssikkerhed. Rate limiting, breach-response, sessionsikkerhed og multifaktorautentificering spiller stadig en rolle.

Skal du bruge en pepper?

En pepper er en yderligere delt hemmelighed, der opbevares uden for passworddatabasen. Til forskel fra et salt gemmes den ikke sammen med hver hash.

En korrekt designet pepper kan give defence in depth, hvis en angriber stjæler kun databasen. Men pepping introducerer nøglehåndterings- og rotationskompleksitet: At miste eller rotere en pepper kan kræve passwordresets.

Improvisér ikke ved at sammenflette en hardcodet hemmelighed til hvert password. Følg en dokumenteret strategi, gem hemmeligheder separat og planlæg rotation. OWASP diskuterer pre-hashing- og post-hashing-pepper-tilgange.

En praktisk passwordhashing-politik

Til en ny PHP-applikation foretræk Argon2id, når det er tilgængeligt, begynd med en OWASP-aligned konfiguration, benchmark den og gem den fuldstændige koderede hash. Hvor Argon2id ikke er tilgængelig, er bcrypt gennem PHP's password API et praktisk alternativ, hvis omkostning og inputgrænse er forstået.

Til en eksisterende applikation skal du fortsætte med at verificere understøttede legacy-hashes, mens du opgraderer dem efter vellykket autentificering. Undgå forstyrrende migrationer, når det originale password ikke er tilgængeligt.

Design til opgraderinger fra begyndelsen. Hardware og anbefalinger ændrer sig; dit autentificeringssystem bør være i stand til at vedtage bedre parametre og algoritmer uden at ændre hver brugers password med det samme.

Ofte stillede spørgsmål

Er Argon2id bedre end bcrypt?

Argon2id tilbyder konfigurerbar hukommelseshårdhed og er OWASP's foretrukne valg til nye passwordopbevaringsimplementeringer.

Bruger PHP Argon2id som standard?

Nej. PHP's PASSWORD_DEFAULT vælger i øjeblikket bcrypt. Brug PASSWORD_ARGON2ID eksplicit, når det understøttes.

Kan jeg migrere bcrypt-hashes uden passwordresets?

Ja. Verificer den eksisterende hash, og rehash det indsendte password efter et vellykket login.

Skal jeg gemme saltet separat?

Nej. PHP's password hashing API genererer saltet og gemmer den nødvendige information i den koderede hash.

Er SHA-256 sikker til passwords?

Ikke i sig selv. Brug en dedikeret adaptiv passwordhashing-algoritme i stedet for rå SHA-256.

Officielle referencer