---
title: Chiffrement / déchiffrement
slug: oip-next/v3/core/entity/chiffrement-dechiffrement
icon: {"lucideIcon":"📘"}
createdAt: 2025-10-13T13:36:06.000Z
---

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`.

```javascript
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 :

```javascript
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

```javascript
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
```
