# Guide d’installation et d’utilisation de Swily Link

Version 1.0 — 2 octobre 2026.

Ce guide concerne Swily Link sur ordinateur et le parcours de lecture de cartes de l’application web Swily. Il accompagne les recommandations de sécurité G8 et EL2 du dossier SESAM-Vitale. Il ne constitue ni une attestation d’homologation de chaque matériel ni une validation juridique des CGU.

## 1. Préparer le poste et le lecteur

Swily fournit le logiciel Swily Link ; le poste de travail et le réseau local sont sous la responsabilité de l’utilisateur ou du cabinet. L’ordinateur n’est pas fourni par Swily. Une éventuelle vente de lecteur relève des conditions de vente du matériel.

Utilisez un ordinateur sous Windows 64 bits (x64) ou macOS (Apple Silicon ou Intel), avec une version du système encore maintenue par son éditeur et à jour. Demandez au support de confirmer la compatibilité de votre version avant une installation sur un poste ancien. Les distributions actuellement prévues par Swily Link concernent Windows et macOS ; ce guide ne promet pas de distribution Linux.

Prévoyez une connexion Internet et un navigateur à jour pour accéder à https://web.swily.io. L’installation de Swily Link ne demande pas d’installer Node.js, Rust ou un outil de développement.

Le parcours sur ordinateur utilise un lecteur de cartes à puce PC/SC, reconnu par le système, pour les cartes Vitale et CPS/CPx. Branchez-le en USB et installez, si nécessaire, le pilote fourni par son fabricant. La présence de PC/SC ne suffit pas à garantir la qualification de chaque modèle : faites confirmer par Swily le modèle, le pilote et le système utilisés avant votre achat ou votre déploiement. Les lecteurs Bluetooth du parcours mobile ne sont pas couverts par cette procédure.

Fermez les autres logiciels qui peuvent réserver le lecteur. Si deux cartes sont nécessaires, vérifiez avec le support la configuration des emplacements de votre lecteur.

## 2. Sécuriser l’ordinateur avant l’installation

Appliquez les mises à jour de sécurité du système, du navigateur et des pilotes. Activez le verrouillage automatique de la session et verrouillez-la chaque fois que vous vous éloignez. Utilisez un compte nominatif avec les seuls droits nécessaires ; réservez les droits d’administration aux opérations qui les exigent.

Gardez le pare-feu actif et une protection antivirus ou antimalware maintenue et à jour. Installez uniquement des logiciels de source fiable. Sauvegardez les fichiers professionnels conservés localement et protégez l’accès aux sauvegardes. Activez le chiffrement du disque lorsqu’il est disponible et conservez le moyen de récupération dans un emplacement sécurisé.

Swily Link communique avec le navigateur sur cet ordinateur, à l’adresse de boucle locale 127.0.0.1, dans la plage de ports 3456 à 3465. N’ouvrez pas ces ports sur Internet ou sur le réseau du cabinet, ne créez pas de redirection de port sur le routeur et ne désactivez pas globalement le pare-feu pour faire fonctionner Link. Si un logiciel de sécurité bloque la liaison locale, demandez une règle limitée à Swily Link et à la boucle locale à votre administrateur ou au support.

## 3. Télécharger et installer Swily Link

Obtenez l’installeur adapté à votre ordinateur par le canal de téléchargement officiel indiqué par Swily ou par le support à contact@swily.io. N’utilisez pas de copie transmise par un tiers ou par un site inconnu.

Sur Windows, lancez l’installeur et suivez ses instructions. Sur macOS, ouvrez l’image disque et copiez Swily Link dans Applications si l’installeur le demande, puis lancez l’application. Vérifiez que le fichier correspond au système et à l’architecture de votre ordinateur.

Un avertissement de signature, d’éditeur inconnu, de certificat invalide ou de fichier suspect demande une vérification : arrêtez l’installation et contactez le support pour confirmer la provenance et l’intégrité du fichier. Ne désactivez pas SmartScreen, Gatekeeper ou l’antivirus et ne contournez pas un contrôle de confiance sur la seule foi de ce guide.

Une fois lancé, Swily Link apparaît dans la barre de menus de macOS ou dans la zone de notification de Windows. L’absence de fenêtre principale est normale. Son menu permet de consulter l’état, de rechercher les mises à jour, de choisir le démarrage à l’ouverture de session et de quitter l’application.

L’option « Launch at Login » active ou désactive le démarrage avec la session. Le statut « Connected » indique que le composant local répond ; l’application web reste nécessaire pour vérifier l’appairage et tester les cartes.

## 4. Appairer cet ordinateur au compte Swily

1. Lancez Swily Link sur l’ordinateur où le lecteur est branché, puis connectez-vous à https://web.swily.io avec votre propre compte.
2. Ouvrez « Paramètres › Lecteur » et la carte « Swily Link ». Cliquez sur « Rafraîchir » si nécessaire.
3. Si une version trop ancienne est signalée, mettez Link à jour avant de poursuivre. Cliquez sur « Appairer cet ordinateur ».
4. Une fenêtre Swily Link s’ouvre sur cet ordinateur et affiche le code d’appairage. Vérifiez le poste indiqué, puis saisissez ce code dans la fenêtre d’appairage du navigateur et cliquez sur « Appairer ».
5. Vérifiez la confirmation et la présence de cet ordinateur dans les ordinateurs appairés. Chaque utilisateur doit appairer le poste à son propre compte.

Le code d’appairage n’est pas le code porteur de la CPS. Ne le communiquez pas à une personne qui vous sollicite et ne validez jamais un appairage que vous n’avez pas lancé. Si le code expire ou si une nouvelle fenêtre apparaît après plusieurs erreurs, utilisez uniquement le nouveau code affiché par Swily Link. Si aucun code n’apparaît, vérifiez que Link fonctionne sur ce poste et contactez le support si le problème persiste.

Si le navigateur demande l’autorisation d’accéder au réseau local, vérifiez que la demande provient de la page officielle Swily et du parcours que vous venez de lancer. Autorisez uniquement cette page de confiance ; n’autorisez pas un site inconnu. Si votre organisation bloque cette permission, demandez conseil à son administrateur.

## 5. Tester la lecture et utiliser les cartes

Dans « Paramètres › Lecteur », insérez une carte, puis cliquez sur « Lire la CPS » ou « Lire la Carte Vitale ». Cette lecture de test ne saisit aucun code porteur et n’enregistre pas le contenu de la carte. Un résultat de lecture ou une demande de code permet de distinguer une carte détectée d’un problème de lecteur.

Pour les opérations professionnelles, lancez la lecture ou la signature depuis le parcours Swily correspondant. Vérifiez le contexte de l’opération et ne saisissez le code porteur de votre CPS que lorsque vous avez vous-même demandé une opération qui le nécessite. Ne le donnez jamais au support. Ne multipliez pas les essais de code : un code faux peut bloquer la carte.

Gardez votre CPS/CPx sous votre contrôle. Retirez-la dès qu’elle n’est plus nécessaire et avant de quitter le poste ; ne prêtez ni la carte ni son code. Fermez ou verrouillez la session quand vous vous éloignez et déconnectez-vous de Swily sur un poste partagé.

Si Swily signale qu’un autre programme se fait passer pour Swily Link, qu’un certificat est refusé ou qu’une page est refusée, arrêtez l’opération. Ne saisissez pas de code et ne modifiez pas les certificats ou les paramètres de confiance pour poursuivre. Fermez les programmes inconnus, redémarrez le poste si nécessaire et contactez le support. Ne transmettez ni capture contenant une donnée de patient, ni code porteur, ni code d’appairage.

## 6. Maintenir le logiciel à jour

Swily Link recherche une version disponible peu après son lancement, puis environ toutes les quatre heures. Cette vérification périodique détecte la mise à jour ; elle ne l’installe pas automatiquement.

Pour lancer la recherche et l’installation, ouvrez le menu de Swily Link et cliquez sur « Check for Updates ». Terminez les opérations de carte en cours auparavant, retirez les cartes, puis relancez Swily Link si un redémarrage est nécessaire. Rafraîchissez ensuite la carte Swily Link dans le navigateur.

En cas d’échec du téléchargement, de vérification de signature ou d’installation, contactez le support ; n’installez pas de paquet provenant d’une autre source et ne neutralisez pas les contrôles de sécurité. Maintenez aussi le système, le navigateur et l’antivirus à jour.

## 7. Protéger le réseau du cabinet, filaire ou Wi-Fi

L’utilisateur ou le cabinet organise la sécurité du réseau local, y compris les prises Ethernet, le routeur, les points d’accès et les connexions Wi-Fi. Contrôlez qui peut connecter un équipement, changez les mots de passe d’administration d’origine et appliquez les mises à jour des équipements réseau. Réservez l’administration aux personnes habilitées.

Séparez les usages professionnels des accès invités et des équipements non maîtrisés. Pour le Wi-Fi, utilisez WPA3 lorsqu’il est disponible ou WPA2 avec AES, avec un secret robuste ; écartez les réseaux ouverts, WEP et les configurations anciennes non maintenues. Désactivez les fonctions de connexion simplifiée inutiles comme WPS. Confiez la configuration d’un réseau d’entreprise à une personne compétente.

Évitez les Wi-Fi publics ou inconnus pour accéder aux données de santé ; privilégiez une connexion maîtrisée. Un réseau filaire exige lui aussi un contrôle des accès. Le chiffrement des échanges Swily ne remplace pas la protection du poste et du réseau local.

## 8. Accès distants et assistance

Swily Link n’offre pas d’accès distant de téléadministration à l’ordinateur. Toute connexion à l’équipement doit être à l’initiative de son utilisateur et toute connexion entrante doit être validée par celui-ci. N’installez pas un accès permanent sans surveillance pour dépanner Link.

Si vous demandez une assistance utilisant un autre outil de partage d’écran ou de prise de main, vérifiez l’identité de l’intervenant et l’objectif de la session, donnez un accord explicite avant l’accès entrant et un accord distinct avant toute prise de contrôle. Surveillez la session et interrompez-la quand elle est terminée. Retirez les cartes et masquez les informations de patients ; ne montrez ni ne saisissez de code porteur pendant une prise de contrôle.

## 9. Résoudre les incidents et retirer un poste

Si Link ne répond pas, lancez-le ou relancez-le, puis cliquez sur « Rafraîchir ». Si le lecteur est introuvable, vérifiez le branchement et le pilote. Si le lecteur est occupé, fermez l’autre logiciel qui l’utilise. Si l’appairage a été retiré, un nouvel appairage est nécessaire ; un poste bloqué par Swily demande l’intervention du support.

En cas de perte, de vol ou de compromission d’un ordinateur, retirez son appairage depuis la liste des ordinateurs appairés et avertissez immédiatement le support. Ne poursuivez pas les opérations sensibles sur un poste suspect. Pour une erreur du trousseau de clés (« Error - Keychain »), contactez le support avant toute suppression de clé : sa remise à zéro peut imposer un nouvel appairage.

Avant de céder, réaffecter ou désinstaller un poste, retirez son appairage, déconnectez les comptes et faites effacer de façon sécurisée les données professionnelles présentes localement. Le menu « Quit Swily Link » arrête l’application ; la désinstallation suit la procédure habituelle du système. Une désinstallation ne garantit pas à elle seule l’effacement des données du poste.

Support : contact@swily.io. Un incident de sécurité doit aussi être signalé à nicolas@swily.io, conformément à l’article 6.5 des CGU. Décrivez le système, les versions, le modèle de lecteur et le message d’erreur sans envoyer de données de santé ou de secrets.

## 10. Références

Les recommandations de protection du poste et d’assistance s’appuient sur la fiche CNIL « Sécuriser les postes de travail » : https://www.cnil.fr/fr/securite-securiser-les-postes-de-travail.

Pour la configuration du réseau sans fil, consultez le guide ANSSI « Sécurisation des réseaux Wi-Fi » : https://messervices.cyber.gouv.fr/guides/essentiels-wifi.

Les responsabilités du poste et du réseau et les conditions d’accès distant sont reprises dans le avenant de sécurité des CGU 1.1, dont la prise d’effet est prévue le 2 novembre 2026 sous réserve de la notification préalable dans les délais de l’article 21.