endi-payment 1.3.0b1

Activation du module

L’api publique est configurable dans enDI au travers du fichier de configuration .ini.

Assurez-vous que la librairie endi_payment est bien dans les endi.includes

endi.includes = ...
                   ...
                   endi_payment

Configurez le service endi.interfaces.IPaymentRecordService

endi.interfaces.IPaymentRecordService = endi_payment.public.PaymentService

Configurez les journaux de ‘endi_payment’. Voir la documentation sur le module python logging pour le détail : https://docs.python.org/2/library/logging.html ainsi que les exemples dans le fichier development.ini.sample.

Configurez le service de journalisation endi_payment.interfaces.IPaymentRecordHistoryService à utiliser.

endi_payment propose deux services de journalisation

HistoryLogService : Service par défaut, prévu pour le mode développement, se content de journaliser les actions sans détails.

HistoryDBService : Journalise les actions effectuées dans une base de données spécifiques (pas forcément sur le même serveur mysql)

HistoryDBService

Pour activer la journalisation détaillée dans une base de données spécifiques ajouter la ligne suivante dans la section [app:endi] du fichier .ini

endi_payment.interfaces.IPaymentRecordHistoryService = endi_payment.history.endi_payment.history.HistoryDBService

Créer une nouvelle base de données, vous pouvez utiliser l’utilitaire ./tools/add_payment_database.sh fournit dans le repository endi.

cd endi/
./tools/add_payment_database.sh
# Suivez les instructions

Puis saisissez les informations de connexion de la nouvelle base de données dans la section [app:endi] du fichier .ini

endi_payment_db.url = mysql://endi_payment:endi_payment@localhost/endi_payment?charset=utf8

Archivage

Afin de certifier l’historique des actions sur les encaissements, endi_payment permet l’utilisation d’un service d’archivage.

Version locale, ajouter la ligne suivante à la configuration .ini du service endi dans la section [app:endi]

endi_payment.interfaces.IPaymentArchiveService=endi_payment.archive.FileArchiveService
endi_payment_archive_storage_path=<chemin sur disque pour le stockage des journaux>

La version locale fournie une solution acceptable de certification des journaux d’encaissement.

Afin d’obtenir une solution plus endurcie, on préfèrera l’utilisation d’un service distant avec un tiers certifié.

Une configuration complète contient donc les informations suivantes

endi.includes =
            ....
            endi_payment

# Accès à la bdd de traitement des paiements
endi_payment_db.url = mysql://endi_payment:endi_payment@localhost/endi_payment?charset=utf8

# Le service qui sera utilisé depuis endi pour agir sur les encaissements
endi.interfaces.IPaymentRecordService = endi_payment.public.PaymentService

# Le service qui sera utilisé par endi_payment pour stocker l'historique des actions d'encaissement
endi_payment.interfaces.IPaymentRecordHistoryService = endi_payment.history.HistoryDBService

# Le service en charge de la génération d'une archive avec un peu de certification d'intégrité des journaux
endi_payment.interfaces.IPaymentArchiveService = endi_payment.archive.FileArchiveService

# Le chemin utilisé par le service d'archivage pour le stockage sur disque
endi_payment_archive_storage_path = /var/endi/files/treasury/payment_storage

Consultation des journaux

Si le service HistoryDBService est utilisé, endi_payment ajoute automatiquement une entrée dans le menu Comptabilité d’enDI permettant la consultation du journal des modifications apportées aux encaissements.

Validation locale d’archive

Pour chaque action d’encaissement dans enDI, une entrée est ajoutée dans l’historique d’encaissement.

Cette entrée :

• contient un hash de l’entrée précédente de l’historique.

• est ajoutée à un journal mensuel des modifications

• est associée à une entrée de “scellement” dans la table endi_payment_archive_seal. La clé de scellement correspond à la somme sha1 du fichier journal.

En l’absence d’un tiers de confiance, cette méthode rend compliquée la réécriture de l’historique et fournie une garantie assez élevée d’intégrité des données.