PHP 비밀번호 해싱: Argon2id, bcrypt 및 안전한 마이그레이션
PHP에서 Argon2id와 bcrypt를 사용해 비밀번호를 안전하게 해싱하는 방법을 배우고, 안전한 매개변수를 선택하며, 자격 증명을 검증하고 기존 해시를 비밀번호 재설정 없이 마이그레이션하는 방법을 알아보세요.
비밀번호 저장은 웹 애플리케이션에서 가장 중요한 보안 결정 중 하나입니다. 데이터베이스 침해가 발생하더라도 즉시 사용자의 자격 증명이 드러나지 않아야 하지만, 약한 비밀번호 해싱은 탈취된 해시를 저렴하게 공격할 수 있게 만듭니다.
PHP에는 해싱, 검증 및 비밀번호 업그레이드를 위한 내장 함수가 포함되어 있습니다. 과제는 올바른 알고리즘을 선택하고, 인프라에 맞게 구성하며, 인증을 방해하지 않고 기존 계정을 마이그레이션하는 것입니다.
새로운 애플리케이션의 경우, PHP 빌드가 이를 지원할 때 Argon2id가 일반적으로 권장되는 선택입니다. bcrypt는 실용적인 호환성 옵션으로 남아 있습니다. 둘 다 직접 만든 암호화 방식이 아닌 PHP의 비밀번호 API를 통해 사용해야 합니다.
이 가이드는 구현, 매개변수 선택, 레거시 마이그레이션 및 일반적인 실수를 다룹니다.
SHA-256이 비밀번호 저장에 적합하지 않은 이유
SHA-256은 빠르게 동작하도록 설계되었습니다. 이는 무결성 검사에는 유용하지만, 비밀번호 저장에는 단독으로 부적합합니다: 탈취된 해시를 가진 공격자가 많은 비밀번호 추측을 빠르게 테스트할 수 있기 때문입니다.
전용 비밀번호 해싱 알고리즘은 의도적으로 더 많은 리소스를 소비합니다. Argon2id는 처리 시간뿐만 아니라 상당한 메모리를 요구할 수 있어, 대규모 추측을 더 비싸게 만듭니다.
안전한 저장 시스템에는 고유한 랜덤 솔트, 구성 가능한 작업 계수, 하드웨어 향상에 따라 작업 계수를 높일 수 있는 방법이 필요합니다. PHP의 password_hash()은 필요한 솔트 정보를 자동으로 생성하고 저장합니다.
OWASP 비밀번호 저장 치트 시트는 빠른 범용 해시 함수 대신 적응형 비밀번호 해싱을 권장합니다.
Argon2id vs bcrypt: 무엇을 선택해야 할까요?
| 기능 | Argon2id | bcrypt |
|---|---|---|
| 주요 방어 | 메모리 및 연산 비용 | 연산 비용 |
| 메모리 하드 | 예 | 아니오 |
| 구성 가능한 매개변수 | 메모리, 반복 횟수, 병렬성 | 비용 요소 |
| 비밀번호 입력 제한 | bcrypt 스타일의 72바이트 제한 없음 | 72바이트 |
| PHP에서의 가용성 | 빌드에 따라 다름 | 널리 사용 가능 |
| 최적 용도 | 새로운 비밀번호 저장에 권장 | 호환성 및 레거시 시스템 |
Argon2id는 대규모 병렬 하드웨어의 이점을 얻는 공격에 저항하도록 설계되었습니다. bcrypt는 여전히 합법적인 적응형 비밀번호 해싱 알고리즘이지만, 입력 제한에 주의가 필요합니다: 최대 첫 72 바이트만 고려하며, 문자가 아닙니다.
PASSWORD_DEFAULT이 Argon2id를 선택한다고 가정하지 마십시오. PHP password_hash 문서는 현재 기본 알고리즘으로 bcrypt를 문서화하고 있습니다. PHP 8.4에서 bcrypt의 기본 비용이 10에서 12로 상승했으며, 이는 암시적 매개변수에 의존하면 업그레이드 후 애플리케이션 성능이 변경될 수 있음을 보여줍니다.
1단계: Argon2id 지원 확인
Argon2id가 모든 호스팅 환경에서 반드시 사용 가능한 것은 아닙니다. 선택하기 전에 런타임에서 확인하세요:
<?php
declare(strict_types=1);
if(in_array('argon2id', password_algos(), true)) {
echo 'Argon2id is available';
} else {
echo 'Argon2id is not available';
}
가용성은 PHP가 어떻게 빌드되었는지에 따라 달라집니다. PHP 버전을 업그레이드한다고 해서 자동으로 Argon2id가 활성화된다고 가정하지 마세요.
2단계: Argon2id로 비밀번호 해싱하기
OWASP는 여러 허용 가능한 기준 구성을 문서화하고 있습니다. 하나는 19MiB 메모리, 2회 반복, 병렬성 1을 사용합니다. PHP는 memory_cost을 KiB 단위로 표현하므로, 19MiB는 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
);
병렬성 옵션 threads은 libargon2를 포함한 일부 Argon2 백엔드에서 지원되지만, 모든 PHP 빌드에서 지원되는 것은 아닙니다. 지원되는 경우 값 1이 이 기준과 일치하며, 생략하는 것이 더 이식성이 좋습니다. 실제 구성으로 벤치마크하세요.
결과 인코딩된 해시에는 알고리즘 식별자, 매개변수 및 솔트가 포함됩니다. 해당 값을 별도의 데이터베이스 컬럼에 저장할 필요가 없습니다. 전체 인코딩된 값을 저장하는 경우, VARCHAR(255) 컬럼이 최신 비밀번호 해시를 위한 합리적인 시작점입니다.
이는 기준 매개변수이며, 범용 프로덕션 구성이 아닙니다. 현실적인 동시 인증 트래픽 하에서 지연 시간과 메모리 사용량을 테스트하세요.
3단계: 자격 증명 올바르게 검증하기

각 비밀번호 해시가 랜덤 솔트를 사용하므로, 새 해시를 생성하고 문자열을 비교하는 방식은 작동하지 않습니다. 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 문서에 따르면 password_verify()은 타이밍 공격에 안전합니다. 저장된 해시에서 알고리즘과 작업 매개변수를 읽습니다.
비밀번호 검증은 로그인 스로틀링, 안전한 세션, HTTPS, 적절한 오류 처리 또는 다중 인증을 대체하지 않습니다.
4단계: 로그인 중 기존 비밀번호 해시 업그레이드
password_needs_rehash()은 저장된 해시가 구식 알고리즘이나 매개변수를 사용하는지 감지합니다. 이를 통해 모든 활성 사용자에게 비밀번호 재설정을 강제하지 않고 점진적 마이그레이션이 가능합니다.
<?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.
}
제출된 비밀번호를 성공적으로 검증한 후에만 재해싱하세요. 조건부 업데이트로 저장된 해시가 방금 검증된 값과 여전히 일치하는지 확인할 수 있습니다. 예를 들어, 사용자 ID와 기존 해시가 모두 일치하는 경우에만 비밀번호 해시를 업데이트하세요.
자세한 내용은 PHP password_needs_rehash()를 참조하세요.
5단계: 레거시 MD5 또는 SHA-1 해시 마이그레이션
오래된 애플리케이션에는 MD5, SHA-1 또는 사용자 지정 비밀번호 형식이 포함될 수 있습니다. 이러한 해시는 password_verify()로 항상 검증할 수 있는 것은 아닙니다.
마이그레이션은 통제된 순서를 따라야 합니다:
- 신뢰할 수 있는 메타데이터나 명확하고 문서화된 형식을 사용하여 레거시 형식 식별.
- 여전히 필요로 하는 계정에 대해서만 원래 레거시 방식을 사용하여 제출된 비밀번호 검증.
- 검증 성공 후,
password_hash()을 사용하여 즉시 최신 해시 생성. - 안전한 데이터베이스 업데이트로 저장된 레거시 해시 교체.
- 마이그레이션 완료 시 레거시 검증 중단.
여러 형식이 가능한 경우 해시 길이만으로 알고리즘을 추측하지 마세요. 비밀번호 해시를 복호화하려고 시도하지 마세요: 해싱은 암호화가 아닙니다.
절대 로그인하지 않는 계정의 경우, 약한 해시를 무기한 유지하는 대신 비밀번호 재설정 정책을 고려하세요. 새로 등록된 사용자에게 약한 해시를 허용하는 안전하지 않은 대체 경로를 도입하지 마세요.
6단계: 인프라에서 해싱 벤치마크하기
적절한 비용 매개변수는 하드웨어, 동시 로그인 양 및 지연 시간 요구 사항에 따라 달라집니다.
<?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';

이는 제어된 환경에서만 실행하고, 공개 웹 엔드포인트에서는 실행하지 마세요. 검증도 측정하고, 대표적인 부하 하에서 반복하세요. 격리 상태에서 빠르게 보이는 설정이 많은 요청이 함께 도착하면 RAM을 고갈시킬 수 있습니다.
OWASP는 보안과 운영 용량의 균형을 맞추고, 일반적으로 개별 해싱 연산을 1초 미만으로 유지할 것을 권장합니다.
일반적인 비밀번호 해싱 실수
고정 솔트를 수동으로 추가. PHP의 비밀번호 API는 이미 안전한 솔트를 생성합니다. 고정 솔트는 중요한 보호 기능을 제거합니다.
원시 MD5, SHA-1 또는 SHA-256 사용. 이 알고리즘들은 단독으로 비밀번호 저장에 비해 훨씬 너무 빠릅니다.
bcrypt의 72바이트 제한 무시. 멀티바이트 UTF-8 문자는 사용자가 예상하는 것보다 더 빨리 이 제한에 도달할 수 있습니다.
극단적인 비용 설정 선택. 과도한 메모리 또는 CPU 요구는 인증 엔드포인트에서 서비스 거부 위험을 초래할 수 있습니다.
제출된 비밀번호 로깅. 디버깅 로그, 모니터링 시스템 또는 오류 보고서를 통해 자격 증명이 노출되지 않도록 하세요.
비밀번호 해싱이 인증 보안을 해결한다고 가정. 속도 제한, 침해 대응, 세션 보안 및 다중 인증은 여전히 중요합니다.
페퍼(pepper)를 사용해야 할까요?
페퍼는 비밀번호 데이터베이스 외부에 보관되는 추가 공유 비밀입니다. 솔트와 달리 각 해시와 함께 저장되지 않습니다.
적절히 설계된 페퍼는 공격자가 데이터베이스만 탈취한 경우 심층 방어를 제공할 수 있습니다. 하지만 페퍼링은 키 관리와 순환 복잡성을 도입합니다: 페퍼를 분실하거나 순환하면 비밀번호 재설정이 필요할 수 있습니다.
모든 비밀번호에 하드코딩된 비밀을 연결하는 방식으로 즉흥적으로 구현하지 마세요. 문서화된 전략을 따르고, 비밀을 별도로 저장하며, 순환을 계획하세요. OWASP는 사전 해싱과 사후 해싱 페퍼 접근 방식을 논의합니다.
실용적인 비밀번호 해싱 정책
새로운 PHP 애플리케이션의 경우, 사용 가능한 경우 Argon2id를 선호하고, OWASP 기준 구성으로 시작하여 벤치마크하고, 전체 인코딩된 해시를 저장하세요. Argon2id를 사용할 수 없는 경우, PHP의 비밀번호 API를 통한 bcrypt가 비용과 입력 제한을 이해한다면 실용적인 대안입니다.
기존 애플리케이션의 경우, 지원되는 레거시 해시를 계속 검증하면서 성공적인 인증 후 업그레이드하세요. 원래 비밀번호를 사용할 수 없을 때 파괴적인 마이그레이션을 피하세요.
처음부터 업그레이드를 위해 설계하세요. 하드웨어와 권장 사항은 변합니다; 인증 시스템은 모든 사용자의 비밀번호를 한 번에 변경하지 않고도 더 나은 매개변수와 알고리즘을 채택할 수 있어야 합니다.
자주 묻는 질문
Argon2id가 bcrypt보다 나은가요?
Argon2id는 구성 가능한 메모리 하드니스를 제공하며, 새로운 비밀번호 저장 구현에 대한 OWASP의 권장 선택입니다.
PHP는 기본적으로 Argon2id를 사용하나요?
아니요. PHP의 PASSWORD_DEFAULT은 현재 bcrypt를 선택합니다. 지원되는 경우 PASSWORD_ARGON2ID을 명시적으로 사용하세요.
비밀번호 재설정 없이 bcrypt 해시를 마이그레이션할 수 있나요?
네. 기존 해시를 검증한 후, 성공적인 로그인 후 제출된 비밀번호를 재해싱하세요.
솔트를 별도로 저장해야 하나요?
아니요. PHP의 비밀번호 해싱 API는 솔트를 생성하고 필요한 정보를 인코딩된 해시에 저장합니다.
SHA-256이 비밀번호에 안전한가요?
단독으로는 안전하지 않습니다. 원시 SHA-256 대신 전용 적응형 비밀번호 해싱 알고리즘을 사용하세요.