Chiffrement / déchiffrement
L'OIP chiffre automatiquement la valeur des propriétés configurées : les setters chiffrent la valeur à l'écriture et les getters la déchiffrent à la lecture.
Configuration
Propriétés à chiffrer
Les propriétés à chiffrer se déclarent dans la configuration OIP, sous la clé entities, par entité puis par propriété, avec l'option encryption.
export default {
entities: {
BankAccount: {
bankName: { encryption: { algorithm: 'aes-256' } },
bic: { encryption: { algorithm: 'aes-256' } }
},
CustomEntity: {
bar: { encryption: { algorithm: 'aes-256' } }
}
}
};Chargement
Ce fichier est passé à OIP.start en plus de la configuration principale :
await OIP.start('oip-config.config.mjs', 'data-protection.config.mjs');Utilisation
Une fois la configuration chargée :
- Écriture : la valeur stockée est la valeur chiffrée.
- Lecture : la valeur d'origine est restituée.
Cela fonctionne aussi pour les propriétés personnalisées et pour tous les types de valeur (chaîne, booléen, etc.).
Exemple
import { Entities } from '@fasstech/oip-core';
import { CustomProperties } from '@fasstech/oip-core/entities';
import { getBankAccountBankName, setBankAccountBankName } from '@fasstech/oip-core/entities/BankAccount';
let bankAccount = await Entities('BankAccount').create();
bankAccount = setBankAccountBankName('foo', bankAccount);
bankAccount.bankName; // valeur chiffrée, différente de 'foo'
getBankAccountBankName(bankAccount); // 'foo'
const { getCustom2Bar, setCustom2Bar } = CustomProperties;
let custom2 = await Entities('Custom2').create();
custom2 = setCustom2Bar(false, custom2);
custom2.bar; // valeur chiffrée, différente de false
getCustom2Bar(custom2); // false