Installation du client de certificat personnel
Le client de certificat personnel (PCC) peut être installé sur Windows ou macOS.
Les sections suivantes fournissent des instructions d'installation distinctes pour ces systèmes d'exploitation :
Installation du PCC sur Windows
Sur les systèmes d'exploitation Microsoft Windows, le PCC est installé via une application mise en œuvre sous forme de fichier MSI.
Les sections suivantes sont importantes si vous souhaitez installer le PCC sous Windows :
- Deux éditions - Grand public et Entreprise
- Installation des deux éditions sur la même machine
- Installation manuelle de l'Édition d'entreprise
Deux éditions - Grand public et Entreprise
Les téléchargements de cette section sont destinés aux clients SaaS uniquement. Comme les clients sur site utilisent leurs propres serveurs, ils doivent demander à notre équipe de soutien de leur envoyer des installateurs CPP personnalisés pour leurs environnements.
Le CCP a été mis à jour vers la version 2.1.0 dans les environnements de production le 21 octobre 2023.
OneSpan Sign propose deux éditions alternatives pour les systèmes d'exploitation Windows :
-
Consumer Edition — Pour télécharger et installer ce fichier MSI, cliquez sur Fichier MSI pour le PCC 2.1 Édition grand public.
-
Corporate Edition — Pour télécharger et installer ce fichier MSI, cliquez sur Fichier MSI pour le PCC 2.1 Édition entreprise.
Les binaires installés par ces deux éditions sont identiques.
Toutefois, le tableau suivant décrit plusieurs façons dont les deux éditions diffèrent.
| Édition grand public | Édition entreprise | |
|---|---|---|
| Distribution | Vos signataires seront invités à télécharger et à installer la dernière version du CCP. Si le CCP n'est pas sur la machine de l'utilisateur final, ou s'il utilise une ancienne version, une page Web apparaîtra suggérant que l'utilisateur final télécharge la version minimale requise par le serveur. | Votre administrateur est responsable de l'installation du CPP sur les machines de l'utilisateur final, via les programmes d'installation MSI fournis. La méthode recommandée pour ce faire est de passer par MS Group Policies. |
| Droits d'accès requis pour les utilisateurs | Tout utilisateur peut installer le CPP. | Seul un membre du groupe Administrateurs locaux ou Administrateurs de domaine peut installer le CPP. |
| Disponibilité | L'installation n'est disponible que pour le compte utilisateur employé pour l'installer. Si plusieurs personnes utilisent la même machine, chaque personne doit installer le CPP. | L'installation est disponible pour tous les comptes utilisateurs. |
| Mises à jour | Si la page Web détecte que la version de la copie locale du CPP est inférieure à celle disponible sur le serveur, elle suggère à l'utilisateur final de télécharger la nouvelle version et de mettre à jour la copie locale. | Le client est responsable de la mise à jour des machines locales. La méthode recommandée pour ce faire est de recourir aux stratégies de groupe de MS. |
| Emplacement des binaires | Les fichiers binaires se trouvent dans le répertoire suivant : %LOCALAPPDATA%\OneSpan\OneSpan Personal Certificate Client\ |
Les fichiers binaires se trouvent dans le répertoire suivant :
%ProgramFiles(x86)%\OneSpan\OneSpan Personal Certificate Client\ |
| Démarrage | Le CPP démarre automatiquement lors de la connexion via le paramètre de registre suivant : HKCU\SOFTWARE\Microsoft\Windows\CurrentVersion\Run\eSLCertSign | Le CPP démarre automatiquement lors de la connexion via le paramètre de registre suivant : HKLM\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Run\eSLCertSign |
Installation des deux éditions sur la même machine
Le PCC n'est pas conçu pour que ses deux éditions de Windows soient installées sur la même machine.
Si vous essayez d'installer l'Consumer Edition sur une Corporate Edition existante, alors : (1) le programme d'installation affiche un message indiquant que l'Corporate Edition est déjà installée; (2) le programme d'installation se termine.
Si vous installez l'Corporate Edition sur une Consumer Edition existante, le système utilisera ultérieurement l'Corporate Edition. Dans cette situation, il est préférable de désinstaller le Consumer Edition.
Une Consumer Edition ne peut être désinstallée que par l'utilisateur qui l'a installée. Par exemple, si un administrateur installe l'Corporate Edition sur une machine qui possède une Consumer Edition qui a été installée par un autre utilisateur, seul cet utilisateur peut désinstaller l'Consumer Edition.
Installation manuelle de l'Édition d'entreprise
La manière recommandée d'installer l'Corporate Edition est via les stratégies de groupe MS.
Cependant, il est également possible d'installer manuellement l'Corporate Edition en suivant la procédure suivante.
Pour installer le Corporate Edition manuellement :
- Copiez le fichier d'installation « onespanpersonalcertificateclientcorporate-x.x.x.msi » sur votre machine locale (p. ex., dans c:\temp).
-
Lancez l'invite de commande en mode élevé, c'est-à-dire en cliquant avec le bouton droit de la souris sur l'icône de l'invite de commande et en sélectionnant Exécuter en tant qu'administrateur.
Le programme d'installation doit être exécuté avec des privilèges élevés.
-
Allez dans le répertoire dans lequel le fichier MSI de l'étape 1 a été copié (par exemple, tapez cd c:\temp).
-
Exécutez la commande suivante :
msiexec /i onespanpersonalcertificateclientcorporate-x.x.x.msi
Installation du PCC sur macOS
En raison des exigences FIPS, les éditions macOS du Client de certificat personnel ne sont actuellement pas prises en charge pour les activités de signature dans un environnement FedRAMP.
Sur les systèmes d'exploitation macOS, le programme d'installation du client de certificat personnel (PCC) est distribué sous forme de fichier *.pkg.
Les sections suivantes sont importantes si vous souhaitez installer le PCC sur macOS :
Une édition
Le PCC a deux éditions pour Windows, mais une seule édition pour macOS.
L'édition macOS est installée via un fichier *.pkg. Pour télécharger ce fichier, cliquez ici.
Le CCP 2.0.1 a été mis à jour vers la version 2.1 dans les environnements de production le 21 octobre 2023. Si vous avez encore besoin d'une ancienne version du CCP, vous pouvez la télécharger en cliquant ici.
Le tableau suivant décrit certains attributs de l'édition macOS.
| Attribut | Description |
|---|---|
| Distribution |
Si le CPP n'est pas sur la machine de l'utilisateur final, ou s'il n'y est que dans une version inférieure à celle requise par le serveur, la page Web suggère automatiquement à l'utilisateur final de télécharger la version requise. |
| Droits d'accès requis pour les utilisateurs |
N'importe quel utilisateur, à l'exception de l'utilisateur de niveau racine peut installer le PCC. |
| Disponibilité |
L'installation n'est disponible que pour le compte utilisateur employé pour l'installer. Si plusieurs personnes utilisent la même machine, chaque personne doit installer le CPP. |
| Mises à jour |
Si la page Web détecte que la version de la copie locale du CPP est inférieure à celle disponible sur le serveur, elle suggère à l'utilisateur final de télécharger la nouvelle version et de mettre à jour la copie locale. |
| Emplacement des fichiers binaires |
Le paquet d'applications se trouve dans le répertoire suivant : ~/Applications/OneSpan |
|
Démarrage |
Le PCC démarre automatiquement lors de la connexion via l'agent de lancement avec le plist fichier suivant : ~/Library/LaunchAgents/com.onespan.Personal-Certificate-Client.launchd.plist |
|
Préférences |
Le fichier de paramètres PCC plist se trouve à l'emplacement suivant : ~/Library/Preferences/com.onespan.Personal-Certificate-Client.plist |
L'édition de PCC pour Mac n'a pas de nom officiel. Cependant, les messages du journal l'appellent l'Édition standard. Les messages de journal utilisent également ce nom pour l'Édition grand public de PCC pour Windows.
Installation de l'interface graphique
La manière recommandée d'installer le PCC sur macOS est via une interface utilisateur graphique.
Pour installer le PCC sur macOS via une interface utilisateur graphique :
- Copiez le fichier d'installation «OneSpanPersonalCertificateClient-x.x.x.pkg » dans un répertoire approprié sur votre machine locale (p. ex. : ~/Downloads).
-
Double-cliquez sur ce fichier d'installation. Un installateur démarre et un assistant apparaît.
-
Interagissez avec la séquence de boîtes de dialogue de l'assistant jusqu'à ce que vous ayez terminé l'installation.
Installation par la ligne de commande
Bien que nous recommandions d'installer le PCC sur macOS via une interface utilisateur graphique, vous pouvez utiliser la procédure suivante pour effectuer l'installation via une interface de ligne de commande.
N'utilisez pas « sudo » pour cette installation par la ligne de commande.
Pour installer le PCC sur macOS via une interface de ligne de commande :
- Copiez le fichier d'installation «OneSpanPersonalCertificateClient-x.x.x.pkg » dans un répertoire approprié sur votre machine locale (p. ex. : ~/Downloads).
-
Accédez à une interface de ligne de commande en exécutant le programme Terminal (il se trouve dans le sous-dossier Utilitaires de votre répertoire Applications).
-
Accédez au répertoire où vous avez copié le fichier d'installation à l'étape 1 (p. ex. ~/Downloads).
-
Exécutez la commande suivante :
installer -pkg ./OneSpanPersonalCertificateClient-x.x.x.pkg -target CurrentUserHomeDirectory
Dépannage
Les problèmes suivants peuvent survenir lors de l'installation du PCC sur macOS :
Bouton Continuer désactivé
Ce problème est un bug connu dans les versions 11.x.x (Big Sur) et antérieures de macOS.
Problème
Si l'option Installer uniquement pour moi est sélectionnée, le bouton Continuer est désactivé sur l'écran Sélectionner une destination.
Solution
Sélectionnez à nouveau manuellement Installer uniquement pour moi.
Demande d'informations d'identification de l'administrateur
Problème
Pendant l'installation, une invite inattendue vous demande de fournir les informations d'identification de l'administrateur.
Solution
Effectuez l'une des actions suivantes :
-
Comme demandé, fournissez les informations d'identification de l'administrateur.
-
Si vous ne pouvez pas accéder aux informations d'identification de l'administrateur ou si vous ne souhaitez pas les fournir, annulez l'invite et redémarrez le programme d'installation. Pendant le processus de nouvelle installation, si l'écran Sélectionner une destination n'apparaît pas, dans l'écran Type d'installation, cliquez sur le bouton Modifier l'emplacement d'installation.