Amitiés Hypergrid : confirmations, FriendsStore et migrations
Deux avatars, deux grilles administrées séparément · La deuxième invitation au retour : fonctionnement normal
Deux avatars, deux grilles administrées séparément
Alice possède un compte sur la grille A et Bob sur la grille B. Lorsqu'Alice visite B et demande Bob en ami, cette relation implique les services d'amitié des deux mondes d'origine. Si Alice et Bob se rencontrent sur une troisième grille C, cette grille de rencontre ne détient pas non plus leurs comptes d'origine.
La deuxième invitation au retour : fonctionnement normal
Pendant la visite, la demande peut être acceptée et transmise au service de la grille d'origine, mais une relation en attente peut y être enregistrée. Au retour, Firestorm peut afficher « Please confirm this friendship you made while you were on another HG grid ». Cette confirmation supplémentaire est prévue par HGFriendsModule et HGFriendsService. Ce n'est pas automatiquement une double invitation ou une panne.
Chaque grille conserve sa propre relation dans FriendsStore
Dans une installation Grid utilisant ROBUST/MySQL, le service Friends stocke ses données dans la table FriendsStore de la base qui lui est attribuée. Sur A se trouvent les références nécessaires au compte d'Alice ; sur B celles du compte de Bob. Ce ne sont ni une seule base SQL mondiale ni des tables automatiquement synchronisées par réplication. Une requête SQL sur A n'écrit rien sur B.
Structure réelle : PrincipalID, Friend, Flags, TheirFlags
Dans MySQLFriendsData.cs, PrincipalID identifie une extrémité, Friend l'autre et Flags encode les droits de cette direction. Le service calcule TheirFlags en recherchant une ligne réciproque ; ce n'est pas une colonne indépendante que l'on doit recopier. Friend peut contenir un identifiant universel complet lorsqu'il représente un étranger. Les valeurs d'attente et de permissions ne se manipulent pas comme des étiquettes arbitraires.
UUI et jeton de vérification
Le module HGFriendsModule construit des identifiants universels décrivant l'avatar étranger et associe un petit secret à certaines relations. HGFriendsService utilise ce secret pour vérifier, entre autres, des notifications de présence et des suppressions à distance. Le secret n'est pas décoratif et ne doit jamais être communiqué dans une capture de base SQL ou un rapport public.
Exemple : Alice change d'avatar et récupère son inventaire
Alice crée Alice2 sur la grille A. Elle utilise le même nom ou une apparence identique et restaure, si les droits le permettent, son inventaire. Mais Alice2 possède un nouvel UUID. Les amis locaux et étrangers ont établi leur relation avec l'ancienne Alice, pas avec Alice2. Transférer des objets n'a jamais transféré cette identité.
Pourquoi copier les lignes SQL peut tromper
L'administrateur de A copie toutes les lignes FriendsStore associées à l'ancienne Alice vers Alice2. Certaines entrées peuvent alors s'afficher dans le viewer, ce qui donne l'illusion d'une réussite. Mais chez Bob, sur B, la relation pointe encore vers l'UUID, l'UUI et les données de l'ancienne Alice. La base B ne connaît pas Alice2 comme amie autorisée de Bob et n'a pas confirmé sa nouvelle identité.
Conséquences : présence, droits et suppression incohérents
Les notifications en ligne/hors ligne peuvent être rejetées parce que les identifiants ou le secret ne correspondent pas à la relation mémorisée sur B. Des permissions peuvent sembler incorrectes, la suppression réciproque peut échouer et des relations orphelines subsister. Il ne suffit pas de changer PrincipalID ou Friend dans un seul ROBUST pour refaire la négociation entre grilles.
Pourquoi les amis locaux sont un cas différent
Entre deux résidents de A, l'administrateur contrôle en principe les données des deux extrémités. Une migration locale peut donc être étudiée avec sauvegardes, références réciproques et tests, sans garantie qu'un UPDATE simpliste soit sûr. Entre A et B, l'administrateur de A n'a normalement ni accès ni autorité sur la base de B, encore moins sur celles de dizaines d'autres grilles.
Notifications intergrilles et contrôles d'amitié
HGStatusNotifier regroupe les amis étrangers selon leur service distant et envoie des demandes de notification. HGFriendsService vérifie que l'ami étranger correspond à une relation locale enregistrée et contrôle son secret. Le code comporte également une limite connue dans la recherche initiale du statut des amis étrangers : un affichage hors ligne n'est pas toujours une preuve de déconnexion.
La suppression d'amitié est elle aussi coordonnée
HGFriendsModule peut contacter un service étranger pour retirer la relation et vérifier certaines données, notamment le secret. Si une grille a modifié la relation à la main, cette suppression peut ne plus se répercuter proprement. Il faut donc éviter de créer ou d'effacer des liens étrangers avec de simples requêtes SQL.
La solution raisonnable après création d'un nouvel avatar
Conservez une sauvegarde, distinguez amis locaux et Hypergrid, et informez le résident avant toute migration. Pour les amis étrangers, le fonctionnement fiable et prévu consiste à envoyer de nouvelles invitations depuis le nouvel avatar et à terminer les confirmations, y compris au retour sur la grille d'origine. Une migration automatique sûre demanderait un protocole de coopération et de nouvelle validation par chaque grille concernée, pas un copier-coller SQL.
Lire les données sans les modifier
La consultation de FriendsStore et des journaux est utile pour diagnostiquer un blocage. Commencez par identifier la bonne base Friends du service ROBUST, vérifiez les liens réciproques et l'état de la confirmation, sans publier de valeurs complètes contenant un secret. N'exécutez jamais une mise à jour directe pour forcer Flags ou remplacer des UUID sans comprendre toutes les conséquences.
Exemple de structure : deux bases qui ne se synchronisent pas
Schéma conceptuel seulement : ce n'est pas du SQL exécutable et l'organisation exacte des entrées dépend de l'étape de validation.
GRILLE A / GRID A (ROBUST FriendsStore) PrincipalID = UUID_ALICE Friend = UUI_BOB + secret GRILLE B / GRID B (ROBUST FriendsStore) PrincipalID = UUID_BOB Friend = UUI_ALICE + secret NOUVEL AVATAR / NEW AVATAR: UUID_ALICE2 Une copie SQL sur A ne met PAS à jour B. Copying SQL on A does NOT update B.
Vérifier les lignes en lecture seule
Exemple SQL de lecture sur une sauvegarde ou une instance de test. Les données Friend peuvent inclure un jeton : ne pas publier le résultat brut.
SELECT PrincipalID, Friend, Flags FROM FriendsStore WHERE PrincipalID = 'UUID_DU_RESIDENT';
Continuer le dossier Hypergrid
- Installation et configuration Hypergrid
- Principes et architecture
- Identités des visiteurs
- Téléportations intergrilles
- Réseau et ports
- Inventaire et assets
- Sécurité
- Dépannage