4 min. de lectura (aproximado)

Tutorial de PHP y ssl/openssl

¿Qué es SSL/TLS y qué tiene que ver con PHP?

SSL, o Secure Sockets Layer, y su sucesor TLS, o Transport Layer Security, son los protocolos que cifran las comunicaciones HTTPS. PHP incluye la extensión OpenSSL, que permite:
  • Hacer conexiones HTTPS.
  • Trabajar con certificados.
  • Cifrar y descifrar datos.
  • Firmar y verificar firmas digitales.
  • Generar claves y certificados.

Comprobar que OpenSSL está disponible

if (extension_loaded('openssl')) {
    echo "OpenSSL está habilitado\n";
    echo "Versión: " . OPENSSL_VERSION_TEXT . "\n";
} else {
    die("La extensión OpenSSL no está habilitada");
}

Crear un certificado autofirmado con PHP

Es muy útil para entornos de desarrollo y proyectos autoalojados.

$dn = [
    "countryName"            => "ES",
    "stateOrProvinceName"    => "Madrid",
    "localityName"           => "Madrid",
    "organizationName"       => "Mi Empresa",
    "organizationalUnitName" => "Desarrollo",
    "commonName"             => "localhost",
    "emailAddress"           => "admin@localhost"
];

$config = [
    "digest_alg"       => "sha256",
    "private_key_bits" => 4096,
    "private_key_type" => OPENSSL_KEYTYPE_RSA,
];

// Generar clave privada
$privateKey = openssl_pkey_new($config);

// Generar CSR
$csr = openssl_csr_new($dn, $privateKey, $config);

// Firmar el certificado (autofirmado) - válido 825 días
$cert = openssl_csr_sign($csr, null, $privateKey, 825, $config);

// Exportar
openssl_pkey_export($privateKey, $privateKeyPem);
openssl_x509_export($cert, $certPem);

file_put_contents('private.key', $privateKeyPem);
file_put_contents('certificate.crt', $certPem);

echo "Certificado autofirmado creado correctamente\n";

Hacer peticiones HTTPS con PHP

Usando cURL (recomendado)

$ch = curl_init('https://api.ejemplo.com/datos');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => true,   // Verificar certificado del servidor
    CURLOPT_SSL_VERIFYHOST => 2,      // Verificar que el dominio coincida
    CURLOPT_TIMEOUT => 30,
]);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo "Error: " . curl_error($ch);
} else {
    echo $response;
}

curl_close($ch);

Usando file_get_contents

$context = stream_context_create([
    'ssl' => [
        'verify_peer' => true,
        'verify_peer_name' => true,
    ]
]);

$result = file_get_contents('https://api.ejemplo.com', false, $context);

Cifrar y descifrar datos

$data = "Información secreta";
$password = "mi_clave_super_segura";
$method = "AES-256-CBC";

// Generar IV
$iv = openssl_random_pseudo_bytes(openssl_cipher_iv_length($method));

// Cifrar
$encrypted = openssl_encrypt($data, $method, $password, 0, $iv);
$encrypted = base64_encode($iv . $encrypted); // Guardamos IV + datos

echo "Cifrado: " . $encrypted . "\n";

// Descifrar
$data = base64_decode($encrypted);
$ivLength = openssl_cipher_iv_length($method);
$iv = substr($data, 0, $ivLength);
$encrypted = substr($data, $ivLength);

$decrypted = openssl_decrypt($encrypted, $method, $password, 0, $iv);

echo "Descifrado: " . $decrypted . "\n";

Firmar y verificar datos (firmas digitales)

// Generar par de claves
$config = ["private_key_bits" => 2048, "private_key_type" => OPENSSL_KEYTYPE_RSA];
$privateKey = openssl_pkey_new($config);
$publicKeyDetails = openssl_pkey_get_details($privateKey);
$publicKey = $publicKeyDetails['key'];

$data = "Este mensaje debe ser auténtico";

// Firmar
openssl_sign($data, $signature, $privateKey, OPENSSL_ALGO_SHA256);
$signature = base64_encode($signature);

echo "Firma: " . $signature . "\n";

// Verificar
$verified = openssl_verify($data, base64_decode($signature), $publicKey, OPENSSL_ALGO_SHA256);

echo $verified === 1 ? "Firma válida\n" : "Firma NO válida\n";

Leer e inspeccionar un certificado

$certContent = file_get_contents('certificate.crt');
$cert = openssl_x509_parse($certContent);

echo "Dominio (CN): " . $cert['subject']['CN'] . "\n";
echo "Organización: " . $cert['subject']['O'] . "\n";
echo "Válido desde: " . date('Y-m-d', $cert['validFrom_time_t']) . "\n";
echo "Válido hasta: " . date('Y-m-d', $cert['validTo_time_t']) . "\n";

Buenas prácticas

  • Usar TLS 1.2 o superior - Seguridad
  • Nunca desactivar "CURLOPT_SSL_VERIFYPEER! en producción - Evita ataques MITM
  • Guardar claves privadas fuera del directorio público - Seguridad
  • Usar "openssl_random_pseudo_bytes()" para IVs y tokens - Aleatoriedad segura
  • Preferir "AES-256-GCM" cuando sea posible - Más seguro que CBC
  • En producción usar certificados de Let's Encrypt - Confianza pública
  • Certificados autofirmados solo para entornos internos o desarrollo - Limitaciones de confianza

Resumen de lo que puedes hacer con PHP y SSL

  • Crear y gestionar certificados, incluyendo autofirmados.
  • Realizar conexiones HTTPS seguras.
  • Cifrar y descifrar información sensible.
  • Firmar digitalmente datos y verificar firmas.
  • Implementar autenticación mutua, o mTLS.
  • Trabajar con claves públicas y privadas.
  • Mejorar la seguridad de aplicaciones Laravel o PHP nativas.