ismx-nexo-node-app 0.4.194 → 0.4.197

package/dist/js/business/utils/CryptoUtils.js

@@ -87,6 +87,30 @@ class CryptoUtils {
             return decrypted.toString('utf8');
         });
     }
+    /**
+     * Genera un desafío (challenge) aleatorio y seguro.
+     * Se recomienda un tamaño de 32 bytes para asegurar suficiente entropía.
+     */
+    static challenge() {
+        return (0, node_crypto_1.randomBytes)(32).toString('hex');
+    }
+    /**
+     * Verifica si el desafío firmado criptográficamente coincide con la clave generadora.
+     * @param challenge El desafío original que el servidor generó.
+     * @param signature La firma generada por el dispositivo (usualmente en base64 o hex).
+     * @param key La clave pública que guardamos en setupBiometry() para este dispositivo.
+     * @param format
+     */
+    static verify(challenge, signature, key, format = 'base64') {
+        try {
+            const verifier = (0, node_crypto_1.createVerify)('sha256');
+            verifier.update(challenge);
+            return verifier.verify(key, signature, format);
+        }
+        catch (error) {
+            return false;
+        }
+    }
     static sha256Sign(merchantKey, orderId, encodedOrder) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a;

package/dist/types/business/utils/CryptoUtils.d.ts

@@ -1,4 +1,4 @@
-import { KeyLike, RsaPrivateKey } from "crypto";
+import { BinaryToTextEncoding, KeyLike, RsaPrivateKey } from "crypto";
 export default abstract class CryptoUtils {
     private static crypto;
     private static zeroPad;
@@ -8,5 +8,18 @@ export default abstract class CryptoUtils {
     static asymEncrypt(value: string, publicKey: RsaPrivateKey | KeyLike): Promise<string>;
     /** Asymmetric decryption (RSA) */
     static asymDecrypt(hash: string, privateKey: RsaPrivateKey | KeyLike): Promise<string>;
+    /**
+     * Genera un desafío (challenge) aleatorio y seguro.
+     * Se recomienda un tamaño de 32 bytes para asegurar suficiente entropía.
+     */
+    static challenge(): string;
+    /**
+     * Verifica si el desafío firmado criptográficamente coincide con la clave generadora.
+     * @param challenge El desafío original que el servidor generó.
+     * @param signature La firma generada por el dispositivo (usualmente en base64 o hex).
+     * @param key La clave pública que guardamos en setupBiometry() para este dispositivo.
+     * @param format
+     */
+    static verify(challenge: string, signature: string, key: string, format?: BinaryToTextEncoding): boolean;
     private static sha256Sign;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ismx-nexo-node-app",
-  "version": "0.4.194",
+  "version": "0.4.197",
   "description": "",
   "scripts": {
     "build": "rm -rf ./dist && npx tsc",

package/src/main/node/business/utils/CryptoUtils.ts

@@ -1,5 +1,5 @@
-import {privateDecrypt, publicEncrypt} from "node:crypto";
-import {KeyLike, RsaPrivateKey} from "crypto";
+import {createVerify, privateDecrypt, publicEncrypt, randomBytes} from "node:crypto";
+import {BinaryToTextEncoding, KeyLike, RsaPrivateKey} from "crypto";
 
 export default abstract class CryptoUtils {
 
@@ -62,6 +62,31 @@ export default abstract class CryptoUtils {
 		return decrypted.toString('utf8');
 	}
 
+	/**
+	 * Genera un desafío (challenge) aleatorio y seguro.
+	 * Se recomienda un tamaño de 32 bytes para asegurar suficiente entropía.
+	 */
+	static challenge() {
+		return randomBytes(32).toString('hex');
+	}
+
+	/**
+	 * Verifica si el desafío firmado criptográficamente coincide con la clave generadora.
+	 * @param challenge El desafío original que el servidor generó.
+	 * @param signature La firma generada por el dispositivo (usualmente en base64 o hex).
+	 * @param key La clave pública que guardamos en setupBiometry() para este dispositivo.
+	 * @param format
+	 */
+	static verify(challenge: string, signature: string, key: string, format: BinaryToTextEncoding = 'base64'): boolean
+	{
+		try {
+			const verifier = createVerify('sha256');
+			verifier.update(challenge);
+			return verifier.verify(key, signature, format);
+
+		} catch (error) { return false; }
+	}
+
 	private static async sha256Sign(merchantKey: string, orderId: string, encodedOrder: string) {
 		let crypto = this.crypto ?? (await import("crypto")).default;
 		const orderKeyBuf = await CryptoUtils.symEncrypt(merchantKey, orderId);