Hachage cryptographique en TypeScript

Les fonctions de hachage cryptographique transforment une entrée arbitraire en une empreinte déterministe de taille fixe. SHA-256 constitue un bon choix par défaut pour les sommes de contrôle et la vérification d’intégrité.

Démarrage rapide#

L’exemple suivant utilise l’API standard de TypeScript ou une bibliothèque couramment utilisée pour cette tâche.

Exemple#

1async function sha256(text: string): Promise<string> {2  const bytes = new TextEncoder().encode(text);3  const digest = await crypto.subtle.digest("SHA-256", bytes);4  return Array.from(new Uint8Array(digest))5    .map((b) => b.toString().padStart(, "0"))6    .join("");7}89console.log(await sha256("ToolPorta"));

Opérations courantes#

Ce second exemple couvre une opération fréquente en production ou une manière plus sûre de traiter des entrées réelles.

Variante courante#

1import { createHash } from "node:crypto";23function sha256Node(text: string): string {4  return createHash("sha256").update(text, "utf8").digest("hex");5}

Points importants#

Hachez des octets avec un encodage explicite. Pour les mots de passe, utilisez un algorithme dédié comme Argon2id, bcrypt ou PBKDF2 plutôt qu’un SHA brut.

Bonnes pratiques#

1. Considérez toute entrée externe comme non fiable et gérez explicitement les erreurs d’analyse ou de validation.
2. Rendez explicites l’encodage, les unités, les formats et les conventions propres aux bibliothèques aux frontières du système.
3. Ajoutez des tests couvrant l’entrée vide, le texte Unicode, les entrées invalides et des données représentatives de la production.

Références#

• RFC 6234: SHA Algorithms
• TypeScript Handbook