0%

🅰️ Impossible de charger la bibliothèque PKCS11

20/05/2026
Erreur / Code
Utilisateurs

🅰️

Impossible de charger la bibliothèque PKCS11

Cet article couvre les causes possibles de l'erreur de chargement de la bibliothèque PKCS11 et les solutions à appliquer selon le système d'exploitation concerné.

Comprendre l'erreur

Lorsque Air tente de communiquer avec un lecteur de carte CPS3, il charge une bibliothèque PKCS11 (un composant logiciel permettant la communication avec les cartes à puce). Si ce composant est absent ou incompatible avec le système, le message suivant apparaît :

exception.CoreException: Erreur lors de la construction de la bibliothèque PKCS11

Cette erreur peut survenir sur Windows 32 bits ou sur macOS.

exception.CoreException: Erreur lors de la construction de la bibliothèque PKCS11at factory.LibraryFactory.buildCPS3Library(LibraryFactory.java:36)at server.CPS3Server.getLibrary(CPS3Server.java:67)at command.cps3command.CPS3Command.getSlotsInfo(CPS3Command.java:104)at command.cps3command.CPS3Command.getSlots(CPS3Command.java:85)at command.syscommand.SYS_ReaderConfig.buildReadersListFromPortCommandAndCryptoLib(SYS_ReaderConfig.java:185)at command.syscommand.SYS_ReaderConfig.process(SYS_ReaderConfig.java:88)at command.Command.process(Command.java:35)at server.RunningHttpServerQuery.executeCommand(RunningHttpServerQuery.java:208)at server.RunningHttpServerQuery.run(RunningHttpServerQuery.java:100)at server.HttpServerQuery.run(HttpServerQuery.java:47)at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1149)at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:624)at java.lang.Thread.run(Thread.java:748)Caused by: fr.santesocial.assertion.common.AssertionException: Erreur lors de l'initialisation de la bibliothèque.at fr.santesocial.assertion.cps.Cps3Pkcs11.(Cps3Pkcs11.java:76)at fr.santesocial.assertion.cps.Cps3Pkcs11.getInstance(Cps3Pkcs11.java:97)at factory.LibraryFactory.buildCPS3Library(LibraryFactory.java:35)... 12 moreCaused by: java.io.IOException: dlopen(libcps3_pkcs11_osx.dylib, 1): image not foundat java.lang.ClassLoader$NativeLibrary.load(Native Method)at java.lang.ClassLoader.loadLibrary0(ClassLoader.java:1941)at java.lang.ClassLoader.loadLibrary(ClassLoader.java:1824)at java.lang.Runtime.loadLibrary0(Runtime.java:870)at java.lang.System.loadLibrary(System.java:1122)at iaik.pkcs.pkcs11.wrapper.PKCS11Implementation.connect(Native Method)at iaik.pkcs.pkcs11.wrapper.PKCS11Module.connectToPKCS11Module(PKCS11Module.java:141)at fr.santesocial.assertion.cps.Cps3Pkcs11.(Cps3Pkcs11.java:60)... 14 more

Vérifier l'environnement Java du poste

Avant d'intervenir, il est recommandé de vérifier que Java est correctement installé et accessible sur le poste client.

  1. Ouvrez un navigateur sur le poste concerné.

  2. Saisissez l'adresse suivante dans la barre d'URL : https://localhost:12127

  3. Vérifiez que la page s'affiche correctement — cela confirme que Java est installé et fonctionnel.

Pour plus d'informations sur Java, consultez la documentation dédiée disponible dans la base de connaissances interne.

Solution sur Windows 32 bits

Sur les postes Windows 32 bits, les fichiers DLL (Dynamic Link Library — bibliothèques système nécessaires au fonctionnement de certains composants) requis par la bibliothèque PKCS11 peuvent être absents. Il s'agit des fichiers cps3_csp_w32.dll et cps3_pkcs11_w32.dll.

Procédure de résolution

  1. Localisez les fichiers manquants sur un poste fonctionnel dans le dossier C:\Windows\SysWOW64.

  2. Copiez les fichiers cps3_csp_w32.dll et cps3_pkcs11_w32.dll.

  3. Collez ces fichiers dans le dossier C:\Windows du poste client (ou dans le chemin indiqué dans le message d'erreur, si différent).

Cas particulier : Crypto CCM non installé

L'erreur peut également être causée par l'absence de Crypto CCM (module cryptographique requis pour la lecture des cartes CPS3). Dans ce cas, vérifiez que Crypto CCM est bien installé sur le poste.

Solution sur macOS

Sur macOS, l'erreur est généralement liée à une incompatibilité entre la version de Java installée et Topaze Air. La solution consiste à désinstaller Java puis à réinstaller Topaze Air, qui embarque sa propre version de Java compatible.

Procédure de résolution

  1. Téléchargez l'outil de désinstallation Java à l'adresse suivante : https://www.java.com/fr/download/uninstalltool.jsp

  2. Exécutez l'outil et suivez les instructions pour désinstaller Java complètement.

  3. Réinstallez Air — cette opération réinstalle automatiquement la version de Java compatible.

Escalade vers le Niveau 2

Si l'erreur persiste après application de la procédure adaptée au système d'exploitation, contactez le support de Niveau 2 en préparant les informations suivantes :

  • Système d'exploitation du poste (Windows 32 bits, macOS, version exacte)

  • Capture d'écran ou texte complet du message d'erreur

  • Résultat de l'accès à https://localhost:12127 (Java accessible ou non)

  • Actions déjà réalisées et leur résultat

0%