ADR-0019 — Migration IBAN openssl_* → libsodium
| Statut | Proposé |
|---|---|
| Date | 2026-01-01 |
| Auteurs | Julien Jorry |
Contexte
Le chiffrement actuel des IBAN utilise encore openssl_encrypt via la commande app:migrate-iban-encryption. Cohérent historiquement, mais en désaccord avec ADR-0003 (libsodium pour toute crypto financière).
Décision
Migrer vers sodium_crypto_secretbox avec rotation de clé maître. Conserver la clé legacy pour déchiffrer les IBAN historiques. Procédure de re-chiffrement en batch.
Conséquences positives
- Alignement avec ADR-0003.
- Rotation de clé maître possible.
- API misuse-resistant.
Conséquences négatives
- Migration en batch sur tous les IBAN existants.
- Double déchiffrement (legacy + nouveau) pendant la transition.
Alternatives examinées
- Statu quo openssl — rejeté à terme.
- Migration big bang sans phase de transition — rejeté, trop risqué.
Références
- ADR-0003
src/Command/MigrateIbanEncryptionCommand.php