TA4OHN · · Aktualisiert am
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?.
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:
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:
W1ABC-9 → W1ABC) und in Großbuchstaben umwandeln.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.
Wenn der Passcode öffentlich berechenbar ist, wozu dann das Ganze? Aus drei Gründen:
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.
-1Wer 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.
Es gibt mehrere Wege, und alle liefern dieselbe Zahl:
aprspass W1ABC ausführen, und man erhält die 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.
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:
ta4ohn-9 und W1ABC-9 können beide funktionieren, aber der Passcode muss aus dem großgeschriebenen Basisrufzeichen W1ABC berechnet werden.rotate.aprs2.net statt eines bestimmten Tier-2-Hostnamens verwenden.Am Passcode selbst liegt es nur selten.
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.
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.
APRS Passcode Generator: jetzt im Browser berechnen.
Was ist APRS?: Grundlagenartikel.
APRS-Frequenzen nach Land: den richtigen Kanal wählen.
APRS-Symbole erklärt: das richtige Symbol wählen.
Die APRS World App: berechnet den Passcode nach der Anmeldung automatisch, ohne manuelle Eingabe.
APRS-Hardware-Ratgeber: viele Funkgeräte erzeugen den Passcode intern.
Über aprs.world: was wir aufbauen.
WB2OSZ Direwolf, Quellcode von aprs_tt.c und zugehörigen Dateien. https://github.com/wb2osz/direwolf ↩
APRS-IS, "Connecting to APRS-IS". http://www.aprs-is.net/Connecting.aspx ↩