Connexion du téléphone — Guide

Ce que vous pouvez faire depuis le téléphone

Un téléphone connecté au PC permet de :

consulter la liste des projets et des sessions du PC connecté ;
voir les terminaux de l'application et y saisir du texte ;
lire les conversations Switcher, envoyer des messages et répondre aux demandes d'approbation ;
ouvrir une nouvelle session, reprendre une session précédente, renommer ou archiver une session ;
modifier les paramètres d'outil, de connexion et de modèle de chaque projet ;
consulter les statistiques d'utilisation de plusieurs PC.

La création de plusieurs comptes pour un outil et le lancement de la connexion à ces comptes ne sont possibles que sur le PC.

Choisir l'application mobile

Application	État	Où l'obtenir
Application web (PWA)	Disponible	`https://app.switchboard.twentyoz.kr`
Application Android	Disponible (APK)	Onglet Android de la page de téléchargement
Application iPhone	En préparation	Utilisez l'application web en attendant sa sortie

Application web

Ouvrez https://app.switchboard.twentyoz.kr dans le navigateur du téléphone. Elle s'utilise immédiatement, sans installation. L'option Ajouter à l'écran d'accueil du menu du navigateur permet de la placer comme une application.

Application Android

Sur la page de téléchargement, choisissez l'onglet Android et téléchargez Agent-Switchboard-Android-<version>.apk.
Ouvrez le fichier téléchargé pour l'installer. Si le navigateur ou l'application de fichiers demande l'autorisation d'installer, acceptez.

Si vous aviez installé un APK signé avec une autre signature, le nouvel APK ne peut pas s'installer par-dessus. Dans ce cas, désinstallez l'ancienne application, installez le nouvel APK, puis refaites la connexion au PC et la connexion Google.

Activer la connexion du téléphone sur le PC

La connexion du téléphone est désactivée par défaut.

Sur le PC, ouvrez 「환경 설정 › 휴대폰」 (Préférences › Téléphone).
Activez 「휴대폰 연결 켜기」 (Activer la connexion du téléphone).

Une fois l'option activée, le PC établit uniquement une connexion sortante vers le serveur relais. Aucun port n'est ouvert sur le PC. Si le PC ne peut pas utiliser le stockage sécurisé du système d'exploitation, la connexion du téléphone ne peut pas être activée.

Méthode 1 : QR code

Cette méthode ne nécessite pas de compte Google.

Sur le PC, dans Préférences › Téléphone › 「새 휴대폰 연결」 (Connecter un nouveau téléphone), cliquez sur 「연결 QR 만들기」 (Créer un QR code de connexion). Le QR code ne peut être créé qu'une fois la connexion au serveur relais établie.
Dans l'application mobile, sous 「PC 연결」 (Connexion au PC), touchez 「QR 코드 스캔」 (Scanner le QR code) et scannez le QR code affiché sur le PC. Si l'appareil photo n'est pas disponible, cliquez sur 「주소 복사」 (Copier l'adresse) sur le PC et utilisez 「연결 링크 붙여넣기」 (Coller le lien de connexion) sur le téléphone.
Un code à 6 chiffres s'affiche sur le téléphone. Vérifiez qu'il est identique à celui de la fenêtre d'approbation du PC, puis approuvez.

Un QR code n'est valable que 5 minutes et ne peut servir qu'une seule fois. S'il a expiré ou a déjà été utilisé, créez-en un nouveau.

Méthode 2 : compte Google

Si le PC et le téléphone sont connectés au même compte Google, vous pouvez les relier sans QR code.

Sur le PC, connectez-vous avec Google depuis le menu du compte en bas à gauche ou depuis 「내 컴퓨터」 (Mes ordinateurs) dans le rail. L'état est aussi visible dans Préférences › Téléphone, sous 「Google 계정 · PC 목록 동기화」 (Compte Google · synchronisation de la liste des PC).
Dans l'application mobile, connectez-vous avec le même compte Google.
La liste des PC de ce compte s'affiche sur le téléphone, y compris les PC éteints. Touchez le PC à connecter : la connexion s'établit sans QR code.

Accepter ou non les connexions sans approbation

Ce réglage se trouve dans Préférences › Téléphone › 「대시보드·세션 접근 권한」 (Autorisations d'accès au tableau de bord et aux sessions).

「같은 계정 휴대폰·웹 자동 허용」 (Autoriser automatiquement les téléphones et le web du même compte) : si l'option est activée, un nouveau téléphone authentifié avec le même compte Google se connecte sans vérification du code. Si elle est désactivée, la première connexion doit être approuvée sur le PC.
「같은 계정 다른 PC 자동 허용」 (Autoriser automatiquement les autres PC du même compte) : détermine si la fenêtre d'approbation est ignorée lorsqu'un autre PC du même compte ouvre ce PC depuis Mes ordinateurs dans le rail. Un PC connecté peut saisir du texte dans les terminaux de ce PC. N'activez cette option que si vous n'utilisez que des PC que vous gérez vous-même.

Même avec l'autorisation automatique activée, la fenêtre d'approbation du PC (vérification du code) s'affiche dans les cas suivants :

un appareil que vous avez déconnecté ou déconnecté du compte depuis ce PC tente de revenir ;
plus de 3 appareils différents tentent de s'enregistrer automatiquement en moins d'une heure.

Lorsqu'un nouvel appareil du compte se connecte, vous en êtes informé par une notification sur le PC et dans le journal d'activité.

Le PC vérifie lui-même la connexion

Le serveur de comptes ne conserve que la liste des PC et n'autorise pas les connexions. La preuve de connexion Google envoyée par le téléphone est vérifiée directement par le PC. Ainsi, même si la liste du serveur de comptes était falsifiée, l'accès aux terminaux du PC ne serait pas cédé.

Recevoir des notifications

L'application Android peut recevoir des notifications pour les approbations en attente, les tâches terminées et les erreurs. Après avoir activé les notifications dans l'application mobile, activez ou désactivez pour chaque appareil 「작업 완료 알림」 (Notification de fin de tâche) dans Préférences › Téléphone › 「연결한 휴대폰」 (Téléphones connectés) sur le PC. Les notifications de demande d'approbation, de connexion d'un nouvel appareil et d'erreur sont toujours envoyées.

Le contenu des notifications est chiffré par le PC avec une clé propre à chaque appareil, créée par le téléphone. Le serveur relais et les services de notifications push d'Apple et de Google ne voient que le jeton push et des données chiffrées. Si le téléphone ne parvient pas à déchiffrer une notification, un texte fixe indiquant qu'il y a quelque chose à vérifier s'affiche. Aucune notification n'est envoyée aux appareils connectés qui ont l'application ouverte.

Ce que le serveur relais peut voir

Les échanges entre le téléphone et le PC sont chiffrés de bout en bout. Le serveur relais ne transmet que des données chiffrées.

Ce que le serveur ne peut pas voir

Les saisies et sorties des terminaux
Le contenu des conversations Switcher
Le secret d'appairage et les clés de session
Les clés API et les jetons OAuth
L'adresse e-mail et le jeton Google (reçus lors de la vérification de la connexion, mais non stockés)

Ce que le serveur traite

L'adresse IP de connexion (prévention des abus et journal de connexion)
L'identifiant de salon du PC (valeur dérivée de la clé publique du PC), la taille et l'horodatage des données chiffrées
En cas d'utilisation d'un compte Google : l'identifiant du compte, la clé publique, le nom et la dernière connexion du PC, l'id, le nom et la plateforme de l'appareil mobile, ainsi qu'un hachage de session
Si la synchronisation de l'utilisation est activée : les lots d'utilisation mensuelle chiffrés

Méthode de chiffrement

Le secret à usage unique contenu dans le QR code se trouve dans le fragment de l'adresse et n'est pas envoyé au serveur.
À chaque connexion, les deux côtés créent une nouvelle clé de session. Si le serveur relais s'interpose, les clés ne correspondent pas et la connexion échoue.
Le serveur relais ne stocke ni n'accumule les messages.

Pour le détail des traitements, consultez la politique de confidentialité.

Gérer les appareils connectés

Dans Préférences › Téléphone › Téléphones connectés, vous pouvez pour chaque appareil :

「이름 바꾸기」 (Renommer) : le nom ne change que dans la liste de ce PC ;
「연결 끊기」 (Déconnecter) : l'appareil est déconnecté de ce PC uniquement. Pour revenir, il doit se reconnecter par QR code ou passer par la fenêtre d'approbation de ce PC ;
「로그아웃」 (Se déconnecter du compte, pour les appareils connectés via un compte Google) : le téléphone est déconnecté du compte et de tous les PC de ce compte ;
「모두 끊기」 (Tout déconnecter) : tous les téléphones connectés à ce PC sont déconnectés.

Si vous recréez l'identité du bureau, tous les téléphones connectés sont déconnectés et l'empreinte du bureau change. Vous êtes également déconnecté du compte Google.

Cumuler l'utilisation de plusieurs PC

Si vous activez 「여러 PC 사용량 합쳐 보기」 (Cumuler l'utilisation de plusieurs PC) dans Préférences › Téléphone, les nombres de jetons par date, outil, modèle et projet sont chiffrés avec une clé connue uniquement des appareils du compte, puis conservés sur le serveur de comptes. Le contenu des conversations n'est pas envoyé. Le cumul s'affiche dans les statistiques du téléphone et sous 「모든 PC」 (Tous les PC) dans la vue d'ensemble du PC.

Les données conservées restent jusqu'à leur suppression. Supprimez-les avec 「서버에서 이 PC 기록 지우기」 (Supprimer du serveur les données de ce PC) ou 「계정 사용량 기록 모두 지우기」 (Supprimer toutes les données d'utilisation du compte).

Serveur relais auto-hébergé

Au départ, l'application utilise le serveur relais officiel et l'adresse officielle de l'application mobile. Dans Préférences › Téléphone › 「주소」 (Adresses), vous pouvez les remplacer par votre propre serveur relais (adresse wss://) et votre propre application mobile (adresse https://). Enregistrer un champ vide rétablit l'adresse officielle. N'indiquez comme adresse d'application mobile qu'une source de confiance : l'application servie à cette adresse pourra saisir du texte dans les terminaux de ce PC.

Si la connexion échoue, consultez Dépannage.