Web y desarrollo

Hashing de Contraseñas en PHP: Argon2id, bcrypt y Migración Segura

PHP Password Hashing: Argon2id, bcrypt and Secure Migration

Aprende cómo hashear contraseñas de forma segura en PHP usando Argon2id y bcrypt, elige parámetros seguros, verifica credenciales y migra hashes existentes sin forzar restablecimientos de contraseña.

Hash de contraseñas en PHP: Argon2id, bcrypt y migración segura

El almacenamiento de contraseñas es una de las decisiones de seguridad más importantes en una aplicación web. Una brecha en la base de datos no debería revelar inmediatamente las credenciales de los usuarios, pero un hash de contraseñas débil puede hacer que los hashes robados sean económicos de atacar.

PHP incluye funciones integradas para hashear, verificar y actualizar contraseñas. El desafío es seleccionar el algoritmo adecuado, configurarlo para tu infraestructura y migrar las cuentas existentes sin interrumpir la autenticación.

Para nuevas aplicaciones, Argon2id es generalmente la opción preferida cuando tu compilación de PHP lo soporta. bcrypt sigue siendo una opción práctica de compatibilidad. Ambos deben usarse a través de la API de contraseñas de PHP, en lugar de mediante criptografía casera.

Esta guía cubre la implementación, selección de parámetros, migración heredada y errores comunes.

Por qué SHA-256 no es adecuado para almacenamiento de contraseñas

SHA-256 está diseñado para ser rápido. Eso lo hace útil para comprobaciones de integridad pero inadecuado por sí solo para almacenamiento de contraseñas: un atacante con hashes robados puede probar muchas conjeturas de contraseña rápidamente.

Los algoritmos dedicados de hash de contraseñas consumen deliberadamente más recursos. Argon2id puede requerir memoria sustancial además de tiempo de procesamiento, haciendo que los intentos de adivinación a gran escala sean más costosos.

Un sistema de almacenamiento seguro necesita una sal única y aleatoria, un factor de trabajo configurable y una forma de aumentar el factor de trabajo a medida que mejora el hardware. password_hash() de PHP genera y almacena la información de sal necesaria automáticamente.

La Hoja de trucos de almacenamiento de contraseñas de OWASP recomienda hashing de contraseñas adaptativo en lugar de funciones de hash generales rápidas.

Argon2id vs bcrypt: ¿cuál elegir?

Característica Argon2id bcrypt
Defensa principal Costo de memoria y computación Costo de computación
Memory-hard Sí No
Parámetros configurables Memoria, iteraciones, paralelismo Factor de costo
Límite de entrada de contraseña Sin límite estilo bcrypt de 72 bytes 72 bytes
Disponibilidad en PHP Depende de la compilación Ampliamente disponible
Mejor caso de uso Preferido para nuevo almacenamiento de contraseñas Compatibilidad y sistemas heredados

Argon2id está diseñado para resistir ataques que se benefician de hardware masivamente paralelo. bcrypt sigue siendo un algoritmo legítimo de hash de contraseñas adaptativo, pero su límite de entrada requiere cuidado: considera como máximo los primeros 72 bytes, no caracteres.

No asumas que PASSWORD_DEFAULT selecciona Argon2id. La documentación de password_hash de PHP documenta actualmente bcrypt como su algoritmo predeterminado. PHP 8.4 elevó el costo predeterminado de bcrypt de 10 a 12, ilustrando por qué confiar en parámetros implícitos puede cambiar el rendimiento de la aplicación tras actualizaciones.

Paso 1: Verificar soporte de Argon2id

Argon2id no está necesariamente disponible en todos los entornos de hosting. Verifica el tiempo de ejecución antes de seleccionarlo:

<?php
declare(strict_types=1);

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

La disponibilidad depende de cómo se compiló PHP. No asumas que actualizar la versión de PHP habilita automáticamente Argon2id.

Paso 2: Hashear una contraseña con Argon2id

OWASP documenta varias configuraciones base aceptables. Una usa 19 MiB de memoria, dos iteraciones y paralelismo de uno. PHP expresa memory_cost en KiB, así que 19 MiB son 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
);

La opción de paralelismo threads es compatible con algunos backends de Argon2, incluyendo libargon2, pero no en todas las compilaciones de PHP. Si es compatible, un valor de uno coincide con esta base; omitirlo es más portable. Haz benchmark de tu configuración real.

El hash codificado resultante incluye el identificador del algoritmo, parámetros y sal. No hay necesidad de guardar esos valores en columnas separadas de la base de datos. Una columna VARCHAR(255) es un punto de partida razonable para hashes de contraseñas modernos, siempre que almacene el valor codificado completo.

Estos son parámetros base, no una configuración de producción universal. Prueba la latencia y el uso de memoria bajo tráfico de autenticación concurrente realista.

Paso 3: Verificar credenciales correctamente

Illustration of the article's main concept

Dado que cada hash de contraseña usa una sal aleatoria, generar un nuevo hash y comparar cadenas no funcionará. Usa 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.

La documentación de PHP especifica que password_verify() es seguro contra ataques de temporización. Lee el algoritmo y los parámetros de trabajo del hash almacenado.

La verificación de contraseñas no reemplaza la limitación de intentos de inicio de sesión, sesiones seguras, HTTPS, manejo apropiado de errores o autenticación multifactor.

Paso 4: Actualizar hashes de contraseñas existentes durante el inicio de sesión

password_needs_rehash() detecta cuando un hash almacenado usa un algoritmo o parámetros obsoletos. Esto permite migración gradual sin forzar a cada usuario activo a restablecer su contraseña.

<?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.
}

Solo rehashea después de verificar exitosamente la contraseña enviada. Una actualización condicional puede asegurar que el hash almacenado aún coincida con el valor que acaba de verificarse. Por ejemplo, actualiza el hash de contraseña solo donde tanto el ID de usuario como el hash antiguo coincidan.

Consulta PHP password_needs_rehash() para detalles de la API.

Paso 5: Migrar hashes heredados MD5 o SHA-1

Aplicaciones más antiguas pueden contener formatos de contraseñas MD5, SHA-1 o personalizados. Tales hashes no siempre pueden verificarse con password_verify().

Una migración debe seguir una secuencia controlada:

  1. Identifica el formato heredado usando metadatos confiables o un formato documentado e inequívoco.
  2. Verifica la contraseña enviada usando el esquema heredado original solo para cuentas que aún lo requieran.
  3. Tras verificación exitosa, crea inmediatamente un hash moderno usando password_hash().
  4. Reemplaza el hash heredado almacenado usando una actualización segura de base de datos.
  5. Retira la verificación heredada cuando la migración esté completa.

No adivines el algoritmo solo por la longitud del hash cuando múltiples formatos son posibles. No intentes descifrar hashes de contraseñas: el hashing no es cifrado.

Para cuentas que nunca inician sesión, considera una política de restablecimiento de contraseña en lugar de retener hashes débiles indefinidamente. No introduzcas una ruta de respaldo insegura que acepte hashes débiles para usuarios recién registrados.

Paso 6: Hacer benchmark del hashing en tu infraestructura

Los parámetros de costo correctos dependen de tu hardware, volumen de inicios de sesión concurrentes y requisitos de latencia.

<?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

Ejecuta esto solo en un entorno controlado, no como un endpoint web público. Mide la verificación también, y repite bajo carga representativa. Una configuración que parece rápida en aislamiento puede agotar la RAM cuando muchas solicitudes llegan juntas.

OWASP recomienda equilibrar seguridad con capacidad operativa y mantener generalmente las operaciones de hashing individuales por debajo de un segundo.

Errores comunes en hashing de contraseñas

Agregar una sal fija manualmente. PHP ya genera sales seguras para su API de contraseñas. Una sal fija elimina una protección importante.

Usar MD5, SHA-1 o SHA-256 en bruto. Estos algoritmos son demasiado rápidos para almacenamiento de contraseñas por sí solos.

Ignorar el límite de 72 bytes de bcrypt. Caracteres UTF-8 de múltiples bytes pueden alcanzar este límite antes de lo que los usuarios esperan.

Elegir configuraciones de costo extremas. Demandas excesivas de memoria o CPU pueden crear riesgo de denegación de servicio en endpoints de autenticación.

Registrar contraseñas enviadas. Evita exponer credenciales a través de logs de depuración, sistemas de monitoreo o reportes de error.

Asumir que el hashing de contraseñas resuelve la seguridad de autenticación. Limitación de tasa, respuesta a brechas, seguridad de sesión y autenticación multifactor siguen importando.

¿Deberías usar un pepper?

Un pepper es un secreto compartido adicional mantenido fuera de la base de datos de contraseñas. A diferencia de una sal, no se almacena junto a cada hash.

Un pepper bien diseñado puede proporcionar defensa en profundidad si un atacante roba solo la base de datos. Pero el peppering introduce complejidad de gestión y rotación de claves: perder o rotar un pepper puede requerir restablecimientos de contraseña.

No improvises concatenando un secreto hardcodeado a cada contraseña. Sigue una estrategia documentada, almacena secretos por separado y planifica la rotación. OWASP discute enfoques de pepper pre-hashing y post-hashing.

Una política práctica de hashing de contraseñas

Para una nueva aplicación PHP, prefiere Argon2id cuando esté disponible, comienza con una configuración alineada a OWASP, haz benchmark y almacena el hash codificado completo. Donde Argon2id no esté disponible, bcrypt a través de la API de contraseñas de PHP es una alternativa práctica si se entienden su costo y límite de entrada.

Para una aplicación existente, sigue verificando hashes heredados compatibles mientras los actualizas tras autenticación exitosa. Evita migraciones disruptivas cuando la contraseña original no está disponible.

Diseña para actualizaciones desde el principio. El hardware y las recomendaciones cambian; tu sistema de autenticación debería poder adoptar mejores parámetros y algoritmos sin cambiar la contraseña de cada usuario de una vez.

Preguntas frecuentes

¿Es Argon2id mejor que bcrypt?

Argon2id ofrece dureza de memoria configurable y es la opción preferida de OWASP para nuevas implementaciones de almacenamiento de contraseñas.

¿PHP usa Argon2id por defecto?

No. PASSWORD_DEFAULT de PHP actualmente selecciona bcrypt. Usa PASSWORD_ARGON2ID explícitamente cuando sea compatible.

¿Puedo migrar hashes bcrypt sin restablecer contraseñas?

Sí. Verifica el hash existente, luego rehashea la contraseña enviada tras un inicio de sesión exitoso.

¿Debo almacenar la sal por separado?

No. La API de hashing de contraseñas de PHP genera la sal y almacena la información requerida en el hash codificado.

¿Es SHA-256 seguro para contraseñas?

No por sí solo. Usa un algoritmo dedicado de hashing de contraseñas adaptativo en lugar de SHA-256 en bruto.

Referencias oficiales