Documentacion de Cuantica

// Incluir la libreria una sola vez
require_once __DIR__ . '/cuantica.php';

// Verificar que se cargo correctamente
$info = cuantica_info();
echo 'Cuantica v' . $info['version'] . ' cargada correctamente';

require_once 'cuantica.php';

$datos = 'Informacion confidencial que quiero proteger';
$password = 'mi_contraseña_segura_2024';

// Cifrar con todas las capas disponibles
$resultado = cuantica_cifrar($datos, $password);

if ($resultado['ok']) {
    // $resultado['datos'] contiene el texto cifrado (base64)
    echo 'Cifrado exitoso';
    echo 'PQC activo: ' . ($resultado['pqc'] ? 'Si' : 'No');

    // Guardar el texto cifrado
    $cifrado = $resultado['datos'];
} else {
    echo 'Error: ' . $resultado['error'];
}

// Descifrar usando la misma contraseña
$resultado = cuantica_descifrar($cifrado, $password);

if ($resultado['ok']) {
    echo $resultado['datos'];
    // Salida: "Informacion confidencial que quiero proteger"
} else {
    echo 'Error al descifrar: ' . $resultado['error'];
}

require_once 'cuantica.php';

$origen   = '/ruta/a/documento.pdf';
$destino  = '/ruta/a/documento.pdf.enc';
$password = 'contraseña_para_archivos';

$resultado = cuantica_cifrar_archivo($origen, $destino, $password);

if ($resultado['ok']) {
    echo 'Archivo cifrado correctamente';
} else {
    echo 'Error: ' . $resultado['error'];
}

$origen   = '/ruta/a/documento.pdf.enc';
$destino  = '/ruta/a/documento_recuperado.pdf';
$password = 'contraseña_para_archivos';

$resultado = cuantica_descifrar_archivo($origen, $destino, $password);

if ($resultado['ok']) {
    echo 'Archivo descifrado correctamente';
}

require_once 'cuantica.php';

$clave_maestra = 'clave_secreta_para_bd';

// ── Guardar un campo cifrado ──
$email_original = 'usuario@ejemplo.com';
$email_cifrado  = cuantica_cifrar_campo($email_original, $clave_maestra);

if ($email_cifrado !== false) {
    $stmt = $pdo->prepare('INSERT INTO usuarios (nombre, email) VALUES (?, ?)');
    $stmt->execute(['Juan', $email_cifrado]);
}

// ── Leer y descifrar ──
$stmt = $pdo->prepare('SELECT email FROM usuarios WHERE id = ?');
$stmt->execute([1]);
$fila = $stmt->fetch();

$email_descifrado = cuantica_descifrar_campo($fila['email'], $clave_maestra);
// $email_descifrado === 'usuario@ejemplo.com'

curl -X POST https://tu-servidor.com/cuantica/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "accion": "cifrar",
    "datos": "Texto secreto a proteger",
    "password": "mi_contraseña_segura"
  }'

{
  "ok": true,
  "datos": "Q1VBTlRJQ0EuLi4gW2RhdG9zIGNpZnJhZG9zXQ==",
  "pqc": false
}

curl -X POST https://tu-servidor.com/cuantica/api.php \
  -H "Content-Type: application/json" \
  -d '{
    "accion": "descifrar",
    "datos": "Q1VBTlRJQ0EuLi4gW2RhdG9zIGNpZnJhZG9zXQ==",
    "password": "mi_contraseña_segura"
  }'

# Informacion completa del sistema
curl -X POST https://tu-servidor.com/cuantica/api.php \
  -H "Content-Type: application/json" \
  -d '{"accion": "info"}'

# Health check rapido
curl -X POST https://tu-servidor.com/cuantica/api.php \
  -H "Content-Type: application/json" \
  -d '{"accion": "health"}'

# Swagger UI interactivo (navegador)
GET /api.php?accion=docs

# Spec OpenAPI JSON (para herramientas)
GET /openapi.json

# Lista de rutas con parametros (JSON)
GET /api.php?accion=routes

php cuantica-cli.php encrypt archivo.pdf archivo.pdf.enc "mi_contraseña"

php cuantica-cli.php decrypt archivo.pdf.enc archivo_recuperado.pdf "mi_contraseña"

# Cifrar un texto
php cuantica-cli.php text encrypt "Mensaje secreto" "mi_contraseña"

# Descifrar un texto (pegar el output del cifrado)
php cuantica-cli.php text decrypt "Q1VBTlRJQ0EuLi4=" "mi_contraseña"

# Cifrar todos los archivos de una carpeta
php cuantica-cli.php batch encrypt /ruta/origen/ /ruta/destino/ "mi_contraseña"

# Descifrar un lote completo
php cuantica-cli.php batch decrypt /ruta/cifrados/ /ruta/recuperados/ "mi_contraseña"

# Generar una clave aleatoria criptograficamente segura
php cuantica-cli.php keygen

# Especificar longitud en bytes
php cuantica-cli.php keygen 64

php cuantica-cli.php info

// Forzar activacion de la capa post-cuantica
$opciones = ['pqc' => true];
$resultado = cuantica_cifrar($datos, $password, $opciones);

if ($resultado['pqc']) {
    echo 'Cifrado con proteccion post-cuantica ML-KEM-768';
}

// Desactivar la capa post-cuantica (usar solo las 5 capas clasicas)
$opciones = ['pqc' => false];
$resultado = cuantica_cifrar($datos, $password, $opciones);

// Sin opciones: Cuantica detecta automaticamente si el backend PQC esta disponible
$resultado = cuantica_cifrar($datos, $password);

// Comprobar si PQC se uso en la operacion
echo 'PQC: ' . ($resultado['pqc'] ? 'Activo' : 'No disponible');

// Verificar soporte PQC del servidor
$info = cuantica_info();
echo 'Backend PQC: ' . ($info['pqc_disponible'] ? 'Disponible' : 'No disponible');

require_once 'cuantica.php';

$info = cuantica_info();

// Mostrar toda la informacion del sistema
echo 'Version: '       . $info['version'];
echo 'PHP: '           . $info['php_version'];
echo 'OpenSSL: '       . ($info['openssl'] ? 'Si' : 'No');
echo 'Sodium: '        . ($info['sodium'] ? 'Si' : 'No');
echo 'PQC disponible: ' . ($info['pqc_disponible'] ? 'Si' : 'No');
echo 'Capas activas: ' . $info['capas'];

// Volcar toda la informacion para depuracion
print_r($info);

// Script de verificacion para despliegue
require_once 'cuantica.php';

$info = cuantica_info();
$errores = [];

if (!$info['openssl']) {
    $errores[] = 'Extension openssl no disponible';
}
if (!$info['sodium']) {
    $errores[] = 'Extension sodium no disponible (recomendada)';
}

if (empty($errores)) {
    echo '[OK] Cuantica lista para produccion con ' . $info['capas'] . ' capas';
} else {
    echo '[AVISO] Problemas detectados:' . PHP_EOL;
    foreach ($errores as $e) {
        echo '  - ' . $e . PHP_EOL;
    }
}