OpenSimulator · FR

Amitiés Hypergrid : confirmations, FriendsStore et migrations

Deux avatars, deux grilles administrées séparément · La deuxième invitation au retour : fonctionnement normal

Documentation généraliste OpenSimulator : le comportement exact dépend de la version et de la configuration des grilles. Ne modifiez pas de bases ou de services en production sans sauvegarde et diagnostic.

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';
Important : un administrateur de la grille A ne peut pas réparer par SQL local les références conservées sur les grilles B, C ou D. Pour un nouvel avatar, il faut normalement refaire les demandes d'amitié Hypergrid et leur confirmation.

Continuer le dossier Hypergrid

Code source et documentation