Criptare și hash-uri

Funcțiile de criptare și hash construiesc ceea ce așteaptă un dispozitiv cu o interfață locală criptată sau semnată: criptare AES, hash-uri MD5 și SHA, semnături HMAC și octeți aleatori siguri. Ele doar construiesc valori, așa că funcționează în orice script. Toate necesită Core 2026.1 pe TapHome Next, build 40991 sau mai nou (încă nu este în versiunea oficială). Base64, textul hexazecimal și sumele de control CRC se află în Codificări de octeți și sume de control.

Primesc date de octeți: o collection<uint8>, un blob sau un șir. Un șir se folosește ca octeți ISO-8859-1. Spre deosebire de TOBYTES fără codificare, care transformă celelalte caractere în ?, un caracter din afara ISO-8859-1 este aici o eroare — pentru UTF-8 transmiteți TOBYTES(text, "utf-8"). Rezultatul este o collection<uint8>.

HASH, HMAC#

HASH calculează hash-ul datelor de octeți, HMAC un hash cu cheie (o semnătură) al acestora.

1
2

HASH(data, algorithm)
HMAC(key, data, algorithm)

Returnează — collection<uint8> de 16, 20, 32 sau 64 de octeți.

Observații — HMAC primește întâi cheia, în aceeași ordine ca hmac.new(key, msg, digest) din Python.

Exemplu

TOHEX(HASH("abc", "MD5"));
# Result: "900150983cd24fb0d6963f7d28e17f72"
TOHEX(HMAC("Jefe", "what do ya want for nothing?", "SHA256"));
# Result: "5bdcc146bf60754e6a042426089575c75a003f089d2739839dec58b964ec3843"

Erori — HASH Unknown algorithm. Valid values are ‘MD5’, ‘SHA1’, ‘SHA256’, ‘SHA512’; HASH - data contains characters outside ISO-8859-1, convert the text with TOBYTES(text, “utf-8”); HASH - data must be a uint8 collection, a blob or a string. Mesajele funcției HMAC încep cu propriul ei nume și numesc argumentul.

Disponibilitate — Core 2026.1 pe TapHome Next, build 40991 sau mai nou (încă nu este în versiunea oficială).

AESENCRYPT, AESDECRYPT#

AESENCRYPT criptează date de octeți cu AES, AESDECRYPT le decriptează.

1
2

AESENCRYPT(data, key, mode [, iv])
AESDECRYPT(data, key, mode [, iv])

Returnează — collection<uint8>.

Observații — Doar /PKCS7 poate observa o cheie greșită, și nici aceasta întotdeauna; cu /ZEROS și /NONE o cheie greșită returnează octeți greșiți fără eroare. Un iv greșit în CBC strică doar primii 16 octeți și nu este raportat niciodată.

Exemplu

VAR key := BYTECOLLECTION("2b7e151628aed2a6abf7158809cf4f3c");
VAR iv := BYTECOLLECTION("000102030405060708090a0b0c0d0e0f");
VAR secret := AESENCRYPT("Hello World", key, "CBC", iv);
TOSTRING(AESDECRYPT(secret, key, "CBC", iv));
# Result: "Hello World"

Erori — AESDECRYPT - decryption failed, check the key, the iv and the padding (completarea /PKCS7 nu se potrivește: o cheie greșită sau date care nu au fost criptate cu PKCS7); AESENCRYPT - key must be 16, 24 or 32 bytes long (AES-128, AES-192, AES-256), it is N; AESENCRYPT - CBC mode needs a 16-byte iv, it is N; AESENCRYPT - ECB mode does not use an iv, leave the argument out; AESENCRYPT Unknown mode. Valid values are ‘ECB’, ‘CBC’, optionally followed by ‘/PKCS7’ (or ‘/PKCS5’), ‘/ZEROS’ or ‘/NONE’; AESENCRYPT - with padding NONE the data length must be a multiple of 16 bytes, it is N; AESDECRYPT - encrypted data length must be a multiple of 16 bytes, it is N. Fiecare funcție își scrie propriul nume în mesaj.

Disponibilitate — Core 2026.1 pe TapHome Next, build 40991 sau mai nou (încă nu este în versiunea oficială).

RANDBYTES#

RANDBYTES returnează octeți aleatori siguri din punct de vedere criptografic — pentru un iv al modului CBC, un nonce sau o cheie de sesiune.

1

RANDBYTES(count)

Returnează — collection<uint8> de count octeți, între 1 și 2048; același lucru ca secrets.token_bytes(n) sau os.urandom(n) din Python.

Observații

• RAND și RANDINT nu sunt sigure și nu trebuie folosite pentru o cheie, un iv sau un nonce.
• O variabilă colecție atribuită altei variabile este aceeași colecție, așa că faceți o COPY înainte de a adăuga cu APPEND — altfel crește și iv.

Exemplu — un iv nou în fața datelor criptate, așa cum îl trimit multe protocoale

VAR key := FROMHEX("2b7e151628aed2a6abf7158809cf4f3c");
VAR iv := RANDBYTES(16);
VAR body := COPY(iv);
APPEND(body, AESENCRYPT("Hello World", key, "CBC", iv));
TOSTRING(AESDECRYPT(COPY(body, 16), key, "CBC", COPY(body, 0, 16)));
# Result: "Hello World"

Erori — RANDBYTES: count must be between 1 and 2048.

Disponibilitate — Core 2026.1 pe TapHome Next, build 40991 sau mai nou (încă nu este în versiunea oficială).

Exemplu — gateway Bosch / Buderus KM200#

Interfața HTTP a unui gateway Bosch / Buderus KM200, folosit și de IVT Rego 2000, așa cum o descriu proiectele comunității (producătorul nu o publică). Corpul răspunsului este Base64 din date AES-256-ECB completate cu zerouri, iar cheia este formată din două hash-uri MD5:

VAR salt := BYTECOLLECTION("00112233445566778899aabbccddeeff00112233445566778899aabbccddeeff");  # 32-byte vendor salt
VAR k1 := TOBYTES(REPLACE("xxxx-xxxx-xxxx-xxxx", "-", ""));    # gateway password
APPEND(k1, salt);
VAR k2 := COPY(salt);
APPEND(k2, TOBYTES("my private password"));
VAR key := HASH(k1, "MD5");
APPEND(key, HASH(k2, "MD5"));                                  # 32 bytes = AES-256

VAR r := SENDHTTPREQUEST("/system/healthStatus", "GET", "", "User-Agent: TeleHeater/2.2.3");
# value = a module variable that keeps the result
IF r.IsSuccess
    value := PARSEJSON(TOSTRING(AESDECRYPT(FROMBASE64(r.Content), key, "ECB/ZEROS"), "utf-8"), "value");
ELSE
    ADDERROR(r.StatusCode + " (" + r.ReasonPhrase + ")");
END

Consultați și — Funcții Packet parser, Codificări de octeți și sume de control, Text și colecții.