# Codificación, hashes y cifrado Funciones de `functions.dkh` para codificar en Base64, pasar datos en una URL, calcular MD5 y HMAC-SHA256, generar identificadores únicos y cifrar texto con una clave. | Función | Devuelve | Qué hace | |---|---|---| | `to.base64(cad)` | Cadena | Base64 de la cadena codificada en UTF-8 | | `from.base64(cad)` | Cadena | Decodifica Base64 a texto UTF-8 | | `to.b64(cad, codificación)` | Cadena | Base64 con la codificación de caracteres indicada | | `from.b64(cad, codificación)` | Cadena | Decodifica Base64 con la codificación indicada | | `encoding(nombre)` | Objeto `Encoding` de .NET | Para `file.rtexte`/`file.wtexte` y extensiones .NET (ver nombres abajo) | | `url_encode(cad)` | Cadena | Base64 UTF-8 "seguro para URL": cambia `=` por `\|`, `/` por `_` y `+` por `-` | | `url_dcode(cad)` | Cadena | Revierte `url_encode` | | `md5(cad)` | Cadena hexadecimal (32) | MD5 de la cadena tomada como bytes **ASCII** (los caracteres no ASCII cuentan como `?`) | | `md5e(cad, codificación)` | Cadena hexadecimal (32) | MD5 de la cadena con la codificación indicada | | `hmacsha256(mensaje, clave)` | Cadena hexadecimal (64) | HMAC-SHA256 de `mensaje` con `clave`, ambos en UTF-8 | | `uuid()` | Cadena (32) | Identificador único global sin guiones, en minúsculas (el formato de `sys_guid`) | | `encryp(cad, clave)` | Cadena Base64 | Cifra con AES (clave derivada con PBKDF2) | | `decryp(cad, clave)` | Cadena | Descifra lo producido por `encryp` con la misma clave | ## Nombres de codificación `encoding`, `to.b64`, `from.b64`, `md5e`, `file.rtexte` y `file.wtexte` aceptan estos nombres (sin distinguir mayúsculas): | Nombre | Codificación | |---|---| | `utf8` (o cualquier nombre no reconocido) | UTF-8 sin BOM | | `unicode` | UTF-16 little endian | | `ascii` | ASCII (los caracteres fuera de rango se vuelven `?`) | | `uft8bom` | UTF-8 **con** BOM | | `uft32` | UTF-32 | | `uft7` | UTF-7 | > Los nombres de UTF-32, UTF-7 y UTF-8 con BOM se escriben **`uft32`, `uft7` y `uft8bom`** (con las letras cambiadas), tal como están en el código desde 1.x. `utf32`, `utf7` y `utf8bom` no se reconocen y producen UTF-8 sin BOM, sin error. La documentación 1.x listaba `utf7` y `utf32`. ## Ejemplo ```dkl #include "dkli.dkh" #! program "codif" { #include "functions.dkh" do print(to.base64("Año 2026")) do print(from.base64("QcOxbyAyMDI2")) do print(to.b64("Año", "unicode")) do print(from.b64("QQDxAG8A", "unicode")) do print(to.b64("Año", "ascii")) do print(url_encode("folio=A-100&total=300")) do print(url_dcode("Zm9saW89QS0xMDAmdG90YWw9MzAw")) do print(md5("Secreta1")) do print(md5e("contraseña", "utf8")) do print(md5e("contraseña", "unicode")) do print(md5("contraseña")) do print(hmacsha256("mensaje", "MiClave#2026")) do print(length(uuid())) cifrado = encryp("dato sensible", "MiClave#2026") do print(cifrado) do print(decryp(cifrado, "MiClave#2026")) do print(decryp(cifrado, "otra")) exception { do print(last_error()) do clear_exceptions() } ref e = encoding("utf8") do print(_get(e, "WebName")) ref e2 = encoding("utf32") do print(_get(e2, "WebName")) } ``` ```text QcOxbyAyMDI2 Año 2026 QQDxAG8A Año QT9v Zm9saW89QS0xMDAmdG90YWw9MzAw folio=A-100&total=300 869e8d496f28f3a0dd08ac2c89cd5235 4c882dcb24bcb1bc225391a602feca7c 763a1e0ff0107650fdae7c36e6d1848d 766a59d574b8a92234c43eae7ab903a6 6b579a66f6360a0d9d6dbdf49408a03cf07cba9d7f34792fba342c0f07d0f219 32 C4I9vkgrxJKZs2hchEXfKbFKI43yezBYr6axVJOGogg= dato sensible {1} Error en 'decryp. (Padding is invalid and cannot be removed.Exception has been thrown by the target of an invocation.) [codif.dkl][Ln= 22] utf-8 utf-8 ``` Observe que `md5("contraseña")` y `md5e("contraseña", "utf8")` dan resultados distintos: `md5` trata la `ñ` como `?`. Para contraseñas con acentos use siempre la misma función al guardar y al comparar; `dbr.login` compara contra `md5` (ASCII) salvo que se active `dbr.setHashUnicode(@true)`, que usa UTF-16 (`md5e(…, "unicode")`). ## Cuándo usar cada una - **Enviar un parámetro con caracteres especiales en una URL de Devkron a Devkron**: `url_encode` / `url_dcode`. No es la codificación estándar de URL (`%20`): `url_dcode("a%20b")` falla. Para la codificación estándar use [url.dkh](/es/devkron/2.0/bibliotecas/estandar/url.md). - **Adjuntar un archivo en JSON**: Base64 con `to.base64` (texto) o leyendo los bytes con `file.rbytes` y una función de [hash.dkh](/es/devkron/2.0/bibliotecas/estandar/hash.md) o `System.Convert`. - **Firmar una petición a una API (webhooks)**: `hmacsha256`. - **Guardar un dato que solo su programa debe leer** (un token en un archivo de configuración): `encryp` / `decryp`. La clave debe estar fuera del código. - **Hashes de contraseñas nuevas, SHA-256, JWT**: use [hash.dkh](/es/devkron/2.0/bibliotecas/estandar/hash.md); MD5 se conserva por compatibilidad con `tuser`. ## Errores típicos | Mensaje | Causa | Solución | |---|---|---| | `Padding is invalid and cannot be removed.` | `decryp` con otra clave o con un texto alterado | Use la misma clave que en `encryp` | | `The input is not a valid Base-64 string…` | `from.base64`, `from.b64` o `url_dcode` con un texto que no es Base64 | Revise que el texto venga de la función correspondiente | | El archivo sale en UTF-8 aunque se pidió UTF-32 | Nombre `utf32` en lugar de `uft32` | Use los nombres de la tabla | [Regresar a functions.dkh](/es/devkron/2.0/bibliotecas/motor/functions/)