Guide d’utilisation

Valable pour SSem TouchOTP 1.0.1

Les écrans de l’app sont en coréen et en anglais. Sur un Mac réglé dans une autre langue, ils s’affichent en anglais.

1. Installation

Achetez et installez SSem TouchOTP depuis le Mac App Store (obtenir l’app). L’App Store installe aussi les mises à jour pour vous.
Lancez-le depuis le dossier Applications ou Launchpad : une icône de cadenas apparaît dans la barre des menus, et non dans le Dock. Cliquez sur cette icône pour ouvrir le panneau.

Si vous utilisez la version DMG téléchargée auparavant sur ce site web, l’installation de la version App Store remplace l’app dans le dossier Applications. Votre coffre et vos comptes sont conservés tels quels.

Prérequis : macOS 14 ou version ultérieure, Touch ID (intégré, ou Magic Keyboard avec Touch ID relié à un Mac avec puce Apple), un mot de passe de session macOS et au moins une empreinte enregistrée.

2. Première configuration

Cliquez sur l’icône de la barre des menus, puis sur Create Vault with Touch ID.
Lorsque la fenêtre Touch ID apparaît, faites lire une fois votre empreinte : le coffre est créé et s’ouvre aussitôt.

Le coffre est le fichier chiffré qui contient les informations de vos comptes. Sa clé se trouve dans la Secure Enclave de ce Mac et ne peut être utilisée qu’avec les empreintes actuellement enregistrées. La fenêtre Touch ID ne propose pas de bouton de saisie du mot de passe : nous avons volontairement exclu toute ouverture par mot de passe.

3. Ajouter des comptes

Cliquez sur Add Account en bas du panneau : trois méthodes s’offrent à vous. Affichez d’abord le code QR ou la clé secrète dans les réglages de validation en deux étapes du service (par exemple GitHub ou Google).

QR Image

Coller : appuyez sur ⌃⇧⌘4 pour capturer la zone du code QR dans le presse-papiers, puis collez la capture dans l’onglet QR Image.
Fichier : dans le panneau, Choose File in Window… vous permet de choisir un fichier image dans une fenêtre séparée. Vous pouvez aussi faire glisser des fichiers image dans cette fenêtre.
Formats d’image pris en charge : PNG, JPEG, HEIC, TIFF, GIF et BMP. Les codes QR sont reconnus uniquement sur ce Mac, et les images ne sont pas conservées.

Vérifiez l’émetteur et le nom du compte dans l’aperçu, puis cliquez sur Add.

Une image QR contient la clé secrète. Après avoir ajouté le compte, supprimez le fichier de capture d’écran. Une image collée est effacée du presse-papiers de ce Mac juste après sa lecture, mais si vous utilisez une app d’historique du presse-papiers, supprimez-la aussi de cet historique.

Paste Address

Collez une adresse commençant par otpauth:// : un aperçu s’affiche, sans jamais montrer la clé secrète. Si l’adresse est encore dans le presse-papiers après l’ajout, elle en est effacée.

Manual

Saisissez l’émetteur, le nom du compte et la clé secrète (Base32). Si nécessaire, vous pouvez modifier le type (TOTP, basé sur le temps, ou HOTP, basé sur un compteur), l’algorithme (SHA-1, SHA-256, SHA-512), le nombre de chiffres (6 à 8) et la période (15 à 120 secondes). Le champ de la clé secrète est un champ sécurisé qui masque les caractères saisis.

4. Migrer depuis Google Authenticator

Dans Google Authenticator sur votre téléphone, ouvrez le menu › Transférer des comptes › Exporter des comptes, puis sélectionnez les comptes à transférer.
Récupérez sur votre Mac le code QR affiché à l’écran : par exemple, prenez-le en photo avec un autre appareil et envoyez la photo par AirDrop, ou envoyez une capture d’écran du téléphone vers votre Mac (selon le téléphone, les captures de cet écran peuvent être bloquées).
Dans SSem TouchOTP, collez l’image dans Add Account › QR Image, ou ajoutez-la en tant que fichier depuis la fenêtre.
Si vous avez beaucoup de comptes et que l’exportation comporte plusieurs codes QR, ajoutez-les tous. La progression s’affiche, par exemple « 1 and 2 of 3 ».

Une fois le transfert terminé, supprimez les photos des codes QR restées sur votre téléphone et sur votre Mac. Les comptes restent dans Google Authenticator : à vous de décider si vous continuez à les utiliser sur votre téléphone.

5. Utiliser les codes

Cliquez sur la ligne d’un compte pour copier son code. Le code copié est effacé automatiquement au bout de 30 secondes, et marqué pour ne pas passer sur vos autres appareils (Presse-papiers universel) ni dans les apps d’historique du presse-papiers.
Le cercle à droite indique le nombre de secondes avant le changement de code. Il devient orange à 10 secondes ou moins, et rouge à 5 secondes ou moins.
Pour un compte basé sur un compteur (HOTP), cliquer sur la ligne alors qu’aucun code n’est encore affiché, ou cliquer sur le bouton ↻ ou sur Generate and Copy Next Code dans le menu du clic droit, génère un nouveau code et augmente le compteur de 1. Cliquer à nouveau sur un code déjà affiché copie simplement le même code, sans modifier le compteur. La fermeture du panneau masque de nouveau le code : le clic suivant en génère donc un nouveau. N’effectuez ces actions que lorsque vous en avez besoin.
Un clic droit sur un compte propose Copy Code et Delete…. Un compte supprimé ne peut pas être récupéré.

6. Verrouillage

Le coffre se verrouille automatiquement en l’absence de toute action pendant le délai choisi (1 minute par défaut).
Il se verrouille immédiatement lors du verrouillage de l’écran, de l’économiseur d’écran, de la suspension d’activité ou d’un changement d’utilisateur.
Vous pouvez le verrouiller à tout moment avec le bouton cadenas en haut du panneau ou avec Settings › Lock Now.
Si vous ouvrez le panneau alors que le coffre est verrouillé, la fenêtre Touch ID apparaît. Si vous l’avez annulée, cliquez sur Unlock with Touch ID.
Le verrouillage supprime aussi les importations QR qui n’ont pas encore été ajoutées et efface le code copié dans le presse-papiers.

7. Sauvegarde et restauration

Si vous ajoutez ou supprimez une empreinte, le coffre ne pourra plus être ouvert. Créez une nouvelle sauvegarde chaque fois que vous ajoutez des comptes. Si vos comptes ont changé depuis la dernière sauvegarde, un rappel apparaît au-dessus de la liste.

Créer une sauvegarde

Cliquez sur Settings › Export or Import Backup…. L’écran de sauvegarde s’ouvre dans une fenêtre séparée.
Nous vous recommandons Generate Random Passphrase. Cliquez sur la phrase secrète générée pour la copier (elle est effacée automatiquement au bout de 30 secondes), et notez-la sur papier ou dans un gestionnaire de mots de passe. Si vous la choisissez vous-même, elle doit comporter au moins 12 caractères, et les phrases trop simples (caractères répétés ou qui se suivent, par exemple) sont refusées.
Saisissez la même phrase secrète dans le champ de confirmation, cliquez sur Confirm with Fingerprint and Export…, puis choisissez l’emplacement d’enregistrement.

Le fichier de sauvegarde (.touchotp) est chiffré avec AES-GCM, à l’aide d’une clé dérivée de votre phrase secrète (PBKDF2-SHA256, 600 000 itérations). Conservez-en aussi une copie en lieu sûr en dehors de ce Mac, par exemple sur un disque externe ou une clé USB.

Importer une sauvegarde

Dans le même écran de sauvegarde, choisissez le fichier avec Choose Backup File…, puis saisissez la phrase secrète.
Cliquez sur Import : les comptes de la sauvegarde sont ajoutés au coffre actuel. Les comptes déjà présents (même clé secrète) sont ignorés, et les réglages et compteurs des comptes existants ne sont pas modifiés.

Si vous oubliez la phrase secrète, il n’existe aucun moyen d’ouvrir la sauvegarde. Nous ne pouvons pas non plus la récupérer.

8. Après un changement d’empreintes

Lorsque vous ajoutez ou supprimez une empreinte, macOS invalide la clé de sécurité et l’app affiche l’écran « The vault can’t be opened ». Rassurez-vous : cet écran ne supprime rien.

Cliquez une fois sur Try Again pour vérifier. Si vous avez bien modifié vos empreintes, l’ouverture continuera d’échouer.
Cliquez sur Reset…. L’ancien fichier du coffre n’est pas supprimé : il est conservé à côté.
Créez un nouveau coffre avec Create Vault with Touch ID.
Importez votre fichier de sauvegarde depuis Settings › Export or Import Backup….

Si l’écran affiche « The vault file is missing or unreadable, but the security key is fine », le problème ne vient pas des empreintes. Remettez le fichier en place et cliquez sur Try Again, ou choisissez Start an Empty Vault with the Same Key….

Si l’avertissement « An older copy of the vault file was opened » apparaît après le déverrouillage, c’est que le fichier du coffre a été remplacé par une ancienne copie (par exemple lors d’une restauration Time Machine). Si vous ne l’avez pas fait vous-même, quelqu’un a peut-être remplacé le fichier : vérifiez la liste des comptes. Si tout est en ordre, cliquez sur Keep This State.

9. Passer à un nouveau Mac

Le fichier du coffre est lié à la Secure Enclave du Mac qui l’a créé : même copié, il ne s’ouvre pas sur un autre Mac. Créez une sauvegarde sur l’ancien Mac, installez l’app sur le nouveau Mac et créez-y un coffre, puis importez la sauvegarde.

10. Réglages de l’app

Language : choisissez Use System Setting, 한국어 ou English. Après la modification, cliquez sur Restart Now pour l’appliquer (l’app redémarre verrouillée).
Auto-Lock : choisissez le délai au bout duquel l’app se verrouille en l’absence d’action (30 secondes, 1, 2 ou 5 minutes).
Screen Capture : activez Hide from Screenshots, Recording and Screen Sharing pour que les fenêtres de l’app n’apparaissent pas dans les captures (désactivé par défaut). Tant que ce Mac est contrôlé à distance par partage d’écran, le panneau est lui aussi invisible.
Backup : indique si une sauvegarde à jour existe et ouvre l’écran de sauvegarde.

Une seule instance de SSem TouchOTP peut s’exécuter à la fois. Si l’app est déjà ouverte et que vous en ouvrez une autre copie depuis un autre emplacement, celle-ci affiche un message puis se ferme. Cela évite que deux copies ouvertes en même temps écrasent le même coffre.

11. Mises à jour

Les mises à jour sont gérées par le Mac App Store. L’app elle-même ne se connecte pas à Internet et ne recherche donc pas d’elle-même les nouvelles versions. Votre coffre et vos comptes sont conservés lors des mises à jour.

12. Désinstallation

Si nécessaire, créez d’abord une sauvegarde.
Quittez l’app, puis déplacez SSem TouchOTP du dossier Applications vers la Corbeille.
Pour effacer aussi les données des comptes, appuyez sur ⌘⇧G dans le Finder et supprimez le dossier ~/Library/Containers/com.levelupsoft.touchotp.

La clé de la Secure Enclave et la clé du coffre scellée (avec son numéro de génération) restent dans le trousseau de ce Mac. Sans le fichier du coffre, elles ne permettent pas à elles seules de récupérer les informations des comptes. Si vous réinstallez l’app et créez un nouveau coffre, l’app vous demande si vous souhaitez remplacer ces éléments.

Pour toute autre question, consultez la page Assistance.