MeshCore Directory

Wat is MeshCore Directory?

MeshCore Directory is een openbare lijst van MeshCore-contactgegevens. Het stelt je in staat om:

Andere MeshCore-gebruikers te vinden en hen als contact toe te voegen.
Je eigen apparaat te vermelden zodat anderen jou kunnen vinden.

Elke vermelding in de directory is betrouwbaar omdat registratie cryptografisch bewijs vereist dat je de privésleutel bezit die hoort bij de publieke sleutel die je registreert. Dit betekent dat niemand een apparaat kan registreren dat hij of zij niet beheert.

Bladeren en zoeken in de directory

Overzichtskaart

Bovenaan de startpagina staat een interactieve kaart met geregistreerde nodes. Onder de kaart staat een lijst van de nodes die momenteel zichtbaar zijn in het zichtbare kaartgebied.

Verschuif en zoom de kaart om een regio te bekijken. De nodelijst wordt automatisch bijgewerkt.
Klik op een cluster om de namen van de nodes erin te zien.
Als je browser dit ondersteunt centreert de kaart zich op je huidige locatie bij het laden.

Nodes zoeken

Typ tekst in het zoekvak om de zichtbare nodes in realtime te filteren. De zoekopdracht doorzoekt:

Naam
Publieke sleutel
Notities

Klik op Clear of verwijder je zoekopdracht om het filter te resetten.

Zoeken werkt samen met de kaart: de zoekopdracht filtert de nodes die zichtbaar zijn in het huidige kaartgebied.

Nodedetails bekijken

Elke node verschijnt als een ingeklapte rij met de naam en de datum van de laatste wijziging. Klik op een rij om deze uit te klappen en de details van de node bekijken:

Element	Omschrijving
QR-code	Scan deze in de MeshCore-app om de node direct als contact toe te voegen
Publieke sleutel	De volledige publieke sleutel van 64 tekens; klik op het copy-icon om te kopiëren
Locatie	Minikaart met de (ruwe) locatie van de node (zie Locatieprivacy)
Notities	Optionele tekst die de eigenaar heeft toegevoegd
Registratiedatum	Wanneer de vermelding voor het laatst is bijgewerkt

Je node registreren

Je hebt de publieke sleutel van je apparaat nodig (64 hexadecimale tekens). Je kunt deze kopiëren uit de node details in de MeshCore-app.

Stap 1: Het registratieformulier invullen

Ga naar Add contact (link rechtsboven op de pagina) en vul het formulier in:

Veld	Verplicht	Toelichting
Naam	Ja	Een naam van maximaal 100 tekens. Hoeft niet overeen te komen met de naam in de MeshCore-app. Vul geen persoonlijk identificeerbare informatie in, want wordt is publiek zichtbaar.
Publieke sleutel	Ja	Precies 64 hexadecimale tekens.
Locatie	Ja	Klik op een punt op de interactieve kaart om een ruwe locatie in te stellen. Zie Locatieprivacy voor meer informatie.
Notities	Nee	Eventuele aanvullende informatie, tot 500 tekens. Vul geen persoonlijke informatie in.

Klik op Verify & Register om verder te gaan. Als de publieke sleutel al in de directory staat, zie je een foutmelding: elke node kan maar één keer worden geregistreerd.

Stap 2: Verificatie

Registratie vereist dat je bewijst dat je de node beheert die je wilt registreren. Dit is een procedure van 3 stappen die volledig in de MeshCore-app plaatsvindt.

Stap 2a: Voeg MeshCore Directory Verifier toe als contact

De pagina toont een QR-code. Kies in de MeshCore-app de optie Contact toevoegen en vervolgens QR-code scannen. Dit voegt MeshCore Directory Verifier toe aan je contacten. Je hoeft dit maar één keer te doen; als je de verifieerder al eerder hebt toegevoegd, kun je deze stap overslaan.

Stap 2b: Stuur de verificatiecode

Op de pagina wordt een willekeurige 6-cijferige code getoond. Stuur deze code als bericht naar het contact MeshCore Directory Verifier in de MeshCore-app. De app versleutelt het bericht met je privésleutel voordat het wordt verzonden, waarmee je bewijst dat het jouw node is.

 Opmerking: De code verloopt na 15 minuten. Als de tijd verstrijkt voordat je klaar bent, klik dan op de link om een nieuwe registratie te starten.

Stap 2c: Automatische afronding

Omdat de server waar de MC Directory op draait zelf geen MeshCore radio heeft maakt deze gebruik van de vele observers (die het MeshCore-netwerk monitoren) om het verificatie bericht te ontvangen. Dit betekent dat het bericht in de app na een aantal pogingen als "mislukt" zal worden gemarkeerd. Dit betekent echter niet dat de verificatie niet is gelukt. Wanneer de server je bericht ontvangt, wordt de registratie vanzelf afgerond.

 Opmerking: Het is mogelijk dat je bericht door geen enkele observer wordt opgepikt, waardoor de verificatie niet kan worden afgerond. Je kunt proberen het bericht opnieuw te sturen, maar als de verificatie blijft wachten ben je mogelijk buiten bereik van alle observers.

Gegevens bewerken

Om je gegevens te bewerken, klap de rij van je node in de directory uit en klik op Edit.

Het bewerkingsformulier lijkt op het registratieformulier. Nadat je de gewenste velden hebt gewijzigd, klik je op Verify & Update. Je doorloopt dezelfde verificatieprocedure als bij de registratie. Dit zorgt ervoor dat alleen de eigenaar van een node de gegevens kan wijzigen.

Zodra het verificatiebericht is ontvangen, worden je wijzigingen opgeslagen en word je doorgestuurd naar de directory.

Gegevens verwijderen

Om je gegevens te verwijderen, klap de rij van je node in de directory uit en klik op Delete.

Bevestig de verwijdering en klik op Verify & Delete. Je doorloopt dezelfde verificatieprocedure. Na verificatie wordt de vermelding permanent verwijderd uit de directory.

Locatieprivacy

Omdat je locatie gevoelige informatie is, slaat de directory je exacte locatie niet op. Hieronder leggen we uit hoe je locatie wordt verwerkt om je privacy te beschermen.

Hoe coördinaatvereenvoudiging werkt

Wanneer je tijdens registratie (of bewerking) een punt op de kaart aanklikt, registreert de browser de precieze GPS-coördinaten die de kaart teruggeeft. Voordat er iets wordt opgeslagen of weergegeven, worden de coördinaten afgerond op minder decimalen. Dit proces is onomkeerbaar: de precieze coördinaten worden onmiddellijk weggegooid en nooit naar de server verzonden of door de server opgeslagen.

Het gevolg hiervan is dat veel posities op de kaart naar dezelfde locatie worden afgerond als je erop klikt. Via een keuzelijst kun je het nauwkeurigheidsniveau kiezen waar je je prettig bij voelt. Dit resulteert in de volgende precisie:

Nauwkeurigheidsinstelling	Opgeslagen decimalen
~0,5 km (hoogste)	2 decimalen
~5 km	1 decimaal
~50 km (laagste)	0 decimalen

Voorbeeld: als je op breedtegraad 52.3728 en lengtegraad 4.8936 klikt, en de instelling ~5 km kiest, wordt de opgeslagen waarde 52.4, 4.9. Er is geen manier om 52.3728 terug te halen uit 52.4, dus de oorspronkelijke precisie is permanent verloren.

De directory slaat alleen de afgeronde coördinaatreeks op (bijv. "52.4, 4.9"). De precieze coördinaten bestaan alleen in het geheugen van je browser terwijl de kaart open is en worden nooit verzonden.

Wanneer de locatie van een node op de directorypagina wordt weergegeven, toont de kaart een gearceerde cirkel gecentreerd op de opgeslagen afgeronde coördinaat. De locatie waarop je hebt geklikt is niet het middelpunt van die cirkel (tenzij dat toevallig zo uitkomt).