TA4OHN · · Aktualisiert am

APRS Passcode Generator: Passcode berechnen und verstehen, wie er funktioniert

Wer nur die Zahl braucht: einfach den APRS Passcode Generator benutzen. Rufzeichen eingeben, Passcode ablesen. Er läuft komplett im Browser, das Rufzeichen wird nie an einen Server geschickt, und die SSID wird automatisch entfernt. Der Rest dieser Seite erklärt, was diese Zahl eigentlich ist.

Früher oder später stößt jeder APRS-Nutzer auf dieselbe fünfstellige Zahl. Man tippt sie in die APRS World App ein, in ein Yaesu FT3DR, in die Konfigurationsdatei eines selbstgebauten iGates oder auf einer Website, die einen gegenüber APRS-IS authentifizieren will. Sie heißt APRS Passcode, und fast jeder versteht sie falsch. Dieser Artikel erklärt genau, was der Passcode ist, was er nicht ist, wie der Algorithmus funktioniert und wo man ihn sicher bekommt.

Wer neu bei APRS ist, fängt am besten mit unserem Grundlagenartikel an: Was ist APRS?.

Die wichtigste Tatsache überhaupt

Ein APRS-IS Passcode ist weder ein Passwort noch ein Sicherheitstoken. Es ist eine öffentlich berechenbare Ganzzahl, die mit einem veröffentlichten Algorithmus aus dem Rufzeichen abgeleitet wird. Jeder kann den Passcode jedes anderen berechnen. Die Zahl authentifiziert niemanden: Sie zeigt lediglich, dass man den Algorithmus gelesen hat, und das gilt als (sehr schwaches) Zeichen dafür, dass man ein echter APRS-Nutzer ist und kein zufälliges Rauschen aus dem Internet. Man sollte den Passcode behandeln wie einen Absenderaufkleber, nicht wie eine Kreditkartennummer.

Das ist aus zwei Gründen wichtig:

  1. So etwas wie einen "geleakten Passcode" gibt es nicht. Er ist ohnehin öffentlich; wer jemals jemandem sein Rufzeichen genannt hat, dessen Passcode lässt sich in Millisekunden berechnen.
  2. APRS-IS bietet keine Identitätsprüfung. Jeder, der das Rufzeichen und den öffentlichen Algorithmus kennt, kann sich unter diesem Rufzeichen mit APRS-IS verbinden. Der Schutz gegen Missbrauch fremder Rufzeichen ist sozial, regulatorisch und serverseitig, nicht kryptografisch.

So funktioniert der Algorithmus

Der Passcode ist eine vorzeichenlose 16-Bit-Ganzzahl, die aus dem Basisrufzeichen berechnet wird (also ohne SSID wie -9, -1 usw.). Der Algorithmus selbst ist eine einfache, ASCII-basierte rollierende XOR-Prüfsumme. Referenz-Quellcode in C wird mindestens seit Mitte der 1990er-Jahre öffentlich verbreitet und ist in vielen Open-Source-iGate-Projekten dokumentiert, darunter aprx und Direwolf 1.

Die Schritte im Überblick:

  1. Die SSID vom Rufzeichen entfernen (W1ABC-9 → W1ABC) und in Großbuchstaben umwandeln.
  2. Einen vorzeichenlosen 16-Bit-Akkumulator mit einem festen Startwert initialisieren (0x73E2 in der veröffentlichten Referenz).
  3. Das Rufzeichen jeweils zwei Zeichen auf einmal durchlaufen, das erste Zeichen um 8 Bit nach links schieben und beide per XOR in den Akkumulator einrechnen.
  4. Das Vorzeichenbit ausmaskieren, damit das Ergebnis in 15 Bit passt.
  5. Die verbleibende Zahl (0 bis 32767) ist der Passcode.

Die ganze Funktion besteht aus etwa 15 Zeilen C, läuft in Mikrosekunden und liefert für jedes Rufzeichen ein stabiles Ergebnis: Der Passcode ändert sich für dasselbe Rufzeichen nie, egal welchen Generator man benutzt.

Warum größere Netze ihn als Höflichkeitsfilter behandeln

Wenn der Passcode öffentlich berechenbar ist, wozu dann das Ganze? Aus drei Gründen:

  1. Er verhindert versehentlichen Missbrauch. Webcrawler, Skripte von Nicht-Funkamateuren und naive Software, die APRS-IS nicht kennt, erzeugen nicht zufällig einen gültigen Passcode. Der Passcode ist ein kleines Tor, das offensichtliches Rauschen draußen hält.
  2. Er signalisiert "Ich habe die Doku gelesen". Betreiber von Tier-2-Servern werten ein Rufzeichen mit korrektem Passcode als Beleg dafür, dass die Gegenseite zumindest die grundlegende Anleitung zur APRS-IS-Verbindung gelesen hat und sich ernsthaft beteiligen will.
  3. Er ermöglicht Ratenbegrenzung und Protokollierung pro Rufzeichen. Server protokollieren jede Verbindung nach Rufzeichen. Fällt ein Rufzeichen negativ auf (Baken-Flut, fehlerhafte Pakete, Aussendungen auf Bändern ohne passende Lizenz), können Tier-2-Betreiber dieses Rufzeichen netzweit sperren. Der Passcode verknüpft die Verbindung mit einem bestimmten Logeintrag.

Was der Passcode nicht leistet:

Mit anderen Worten: Der Passcode ist im Netz so etwas wie eine Mütze mit der Aufschrift "Ich bin APRS-Funker". Ein Reisepass ist er nicht.

Nur-Lese-Zugang: -1

Wer sich mit APRS-IS nur verbindet, um Pakete zu lesen (zum Beispiel für eine Website, die APRS-Daten anzeigt, oder für ein Analyse-Dashboard), braucht überhaupt keinen aus dem Rufzeichen berechneten Passcode. Der bekannte Passcode -1 kennzeichnet eine Verbindung als Nur-Lese-Zugang. Tier-2-Server akzeptieren ihn, liefern den gefilterten Paketstrom und verweigern die Weiterleitung jeder Bake, die man einspeisen will. Die meisten Websites, auch aprs.world, nutzen genau diesen Modus für ihre öffentlichen Live-Kartendaten.

Das ist im ursprünglichen APRS-IS-Verbindungsprotokoll 2 dokumentiert und wird von allen Tier-2-Servern allgemein respektiert.

Wo bekommt man seinen Passcode?

Es gibt mehrere Wege, und alle liefern dieselbe Zahl:

Wir empfehlen, den Passcode lokal auf einem eigenen Gerät zu berechnen, statt ihn von der Website eines Fremden zu holen. Nicht weil die Zahl geheim wäre (ist sie nicht), sondern einfach aus Gewohnheit. Generatoren mit Webformular sind in Ordnung; man sollte nur wissen, dass ein 50-zeiliges Python-Skript dasselbe Ergebnis auch offline liefert.

Was, wenn mein Passcode "nicht mehr funktioniert"?

Das passiert nicht, denn Passcodes sind zustandslos: Der Server berechnet sie bei jeder Verbindung neu aus dem angegebenen Rufzeichen. Wird der Client abgewiesen, liegt es fast immer an einem dieser Punkte:

  1. Falsches Rufzeichen in der Client-Konfiguration. Groß- und Kleinschreibung sowie entfernte SSID prüfen. ta4ohn-9 und W1ABC-9 können beide funktionieren, aber der Passcode muss aus dem großgeschriebenen Basisrufzeichen W1ABC berechnet werden.
  2. Falsche Serveradresse. Namen von Tier-2-Servern ändern sich gelegentlich. Besser eine allgemeine Round-Robin-Adresse wie rotate.aprs2.net statt eines bestimmten Tier-2-Hostnamens verwenden.
  3. Das Netzwerk blockiert ausgehenden TCP-Port 14580. Manche restriktiven WLANs (Hotels, Schulen, Flughäfen) sperren ihn. Ein anderes Netz ausprobieren.
  4. Die eigene IP wurde vorübergehend gedrosselt, weil fehlerhafte Pakete gesendet wurden. Ein paar Minuten warten und erneut versuchen.

Am Passcode selbst liegt es nur selten.

Häufige Fragen

Kann ich denselben Passcode gleichzeitig auf mehreren Geräten nutzen? Ja. APRS-IS erlaubt Verbindungen mit demselben Rufzeichen aus mehreren Quellen, üblicherweise eine pro SSID (W1ABC, W1ABC-9, W1ABC-10...). Mit unterschiedlichen SSIDs unterscheidet man die Geräte, damit Pakete nicht doppelt auftauchen.

Brauche ich pro SSID einen eigenen Passcode? Nein. Der Passcode wird nur aus dem Basisrufzeichen berechnet (ohne SSID). W1ABC-1 und W1ABC-9 haben denselben Passcode.

Ein Freund sagt, mein Passcode sei falsch. Er hat ihn genauso berechnet wie jeder andere Client. Wenn zwei Implementierungen unterschiedliche Ergebnisse liefern, hat eine davon einen Fehler. Mit einer dritten Referenz wie Direwolf oder aprx gegenprüfen.

Gibt es einen Passcode für Clublog, Kurzwelle oder den APRS-Digipeater auf der ISS? Nein. Der Passcode betrifft ausschließlich APRS-IS. Reiner Funkbetrieb (Baken auf 144,800 MHz, Digipeating, Betrieb über den ISS-Digipeater auf 145,825 MHz) braucht überhaupt keinen Passcode. Man benötigt ihn erst in dem Moment, in dem man Daten an einen APRS-IS-Tier-2-Server sendet oder von dort abruft.

Was, wenn ich noch kein Rufzeichen habe? Dann gibt es auch keinen Passcode, denn der Algorithmus braucht ein gültiges Rufzeichen als Eingabe. APRS-Daten kann man trotzdem im Nur-Lese-Modus nutzen (Passcode -1), und alle öffentlichen Artikel auf aprs.world stehen offen, aber Baken senden oder Daten hochladen geht erst mit Lizenz. Wie man dorthin kommt, steht im Abschnitt zur Lizenz in unserem Grundlagenartikel.

Der Generator auf aprs.world

Hier gibt es einen eingebauten Passcode-Generator: APRS Passcode Generator. Rufzeichen eingeben, Zahl ablesen. Er läuft komplett im Browser (das Rufzeichen wird nie an einen Server geschickt und nie protokolliert) und entfernt die SSID automatisch, sodass W1ABC, W1ABC-5 und W1ABC-9 alle denselben gemeinsamen Passcode ergeben.

Weiterlesen

Footnotes

  1. WB2OSZ Direwolf, Quellcode von aprs_tt.c und zugehörigen Dateien. https://github.com/wb2osz/direwolf ↩

  2. APRS-IS, "Connecting to APRS-IS". http://www.aprs-is.net/Connecting.aspx ↩