Teams/Keys-Team: Unterschied zwischen den Versionen

Aus Freifunk MWU Wiki
Zur Navigation springen Zur Suche springen
 
(34 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt)
Zeile 2: Zeile 2:
 
|Name=              Keys
 
|Name=              Keys
 
|Kurzbeschreibung=  Eintragen von Mesh-VPN Keys
 
|Kurzbeschreibung=  Eintragen von Mesh-VPN Keys
|Mitglieder=        erik,florian,jan,juventas,marc,Martin_Mainz,mitch,prisma,wolfgang,MAGIC
+
|Mitglieder=        erik,florian,jan,juventas,marc,Martin_Mainz,mitch,prisma,wolfgang,MAGIC, Sven, ccgx, Ralph
 
|Link=              [[Teams/Keys-Team]]
 
|Link=              [[Teams/Keys-Team]]
 
|Aktiv=              wahr
 
|Aktiv=              wahr
 
|}}
 
|}}
  
= Aufgaben =
+
= Hintergrund =
 +
* In unserer aktuellen Freifunk-Architektur verbinden sich die einzelnen Knoten entweder direkt untereinander (Mesh per WLAN) oder per VPN mit einem der Gateways (und darüber dann mit den anderen Freifunk-Knoten und mit dem Internet).
 +
* Als VPN-Software verwenden wir 'fastd'. Beim Aufsetzen des Knotens wird ein fastd-Schlüssel generiert, wenn "Mesh-VPN aktivieren" angekreuzt ist.
 +
* Damit ein Mesh-VPN-Knoten sich mit dem Gateway verbinden kann, muss das Gateway den öffentlichen fastd-Schlüssel des Knotens kennen.
 +
* Dazu tragen wir alle öffentlichen Schlüssel manuell in ein [https://de.wikipedia.org/wiki/GitHub Github]-Repository ein und die Gateways ziehen sich die Schlüssel aus dem Repository.
 +
* Das manuelle Eintragen wird vom Keys-Team übernommen. Es gibt zwei Arten, Keys ins Repository einzutragen: Via Web-Interface oder via Git-Client (beides siehe unten)
 +
* Nach dem Eintragen dauert es ca. 15 Minuten, bis der neue Key auf den Gateways übernommen ist und der Freifunk-Knoten über die Gateways online gehen kann.
 +
 
 +
= Aufgaben des Teams =
 
* Verwaltung der Key-Repositories auf Github
 
* Verwaltung der Key-Repositories auf Github
** [https://github.com/freifunk-mwu/peers-ffmz Key-Repo Mainz]
+
** [https://github.com/freifunk-mwu/peers-ffmwu Key-Repository MWU]
** [https://github.com/freifunk-mwu/peers-ffwi Key-Repo Wiesbaden]
 
 
* Kommunikation auf den keys@ Listen
 
* Kommunikation auf den keys@ Listen
** [mailto:keys@freifunk-mainz.de keys@freifunk-mainz.de]
+
** [mailto:keys@freifunk-mwu.de keys@freifunk-mwu.de]
** [mailto:keys@freifunk-wiesbaden.de keys@freifunk-wiesbaden.de]
+
* Prüfen eventueller Fehler via Travis
 +
** [https://travis-ci.org/freifunk-mwu/peers-ffmwu Travis MWU]
  
= Vorgehen =
+
= Vorgehen zum Eintragen eines neuen Knotens =
[[Datei:Github addnode.png|right|445px|]]
+
# Prüfen, ob die Mail für Mainz oder Wiesbaden ist, d.h, prüfen, ob sich jemand aus Mainz aus Versehen die Wiesbadener Firmware geflasht hat oder umgekehrt - anhand Angaben in der Mail oder Info in der Karte (spätestens nach dem Eintragen).
# Mail für Mainz oder Wiesbaden?
+
# Prüfen, ob der Knoten evtl. näher an einer Nicht-MWU Community dran ist (sofern die Infos das hergeben)
## Prüfen ob sich jemand aus Mainz Wiesbadener Firmware geflasht hat oder umgekehrt.
+
#Key ins Repository eintragen. Dazu gibt es zwei Möglichkeiten:
## Prüfen ob der Knoten evtl. näher an einer Nicht-MWU Community dran ist (sofern die Infos das hergeben).
+
## Entweder [[Teams/Keys-Team/Eintragen eines neuen Knotens via Web-Interface | Key ins Repo eintragen über Web-GUI]] auf [http://www.github.com www.github.com]
# Key ins Repo eintragen (siehe Bild am Beispiel Mainz)
+
## oder  [[Teams/Keys-Team/Eintragen_eines_neuen_Knotens_mit_Git_Client | mittels Git-Client]]. Für beide Varianten brauchst du einen Github-Account, der für die Keys-Repositories berechtigt sein muss.
## Richtiges Repo wählen (Mainz oder Wiesbaden, siehe Links oben)
 
## Dateiname: Knotenname
 
## Body: key "key-kennung";
 
## Commit-Message: Add key Knotenname
 
## In die Datei und Commit-Message '''nur''' den Key aufnehmen, keine Zusatzinfos (Datensparsamkeit!)
 
# Antwort mit Willkommensnachricht an alle (keys@ in CC nicht vergessen)
 
## Wenn die Anfrage von einem bekannten Freifunker kommt, muss die Willkommensnachricht nicht nochmal geschickt werden.
 
  
 
= Willkommensnachricht =
 
= Willkommensnachricht =
Wenn ein neuer Freifunker einen Key einsendet versorgen wir ihn mit Zusatzinfos und weiteren Anlaufstellen:
+
Wenn ein neuer Freifunker einen Key einsendet, versorgen wir ihn mit Zusatzinfos und weiteren Anlaufstellen:
  
== Mainz ==
 
 
  <nowiki>
 
  <nowiki>
 
Hallo ...
 
Hallo ...
  
super, dass Du dabei bist und das Freifunk-Netz erweiterst!
+
super, dass du dabei bist und das Freifunk-Netz erweiterst!
 +
 
 +
Ich habe deinen Key soeben eingetragen. Das heißt, dein Freifunk-Knoten sollte sich in wenigen Minuten mit dem Netz verbinden können und auf unserer Karte auftauchen: https://map.freifunk-mwu.de
 +
 
 +
Solltest du Probleme haben, melde dich immer gerne bei uns. Tipp: Solltest du weitere Router anbinden wollen, die keinen eigenen Internet-Uplink haben, sondern nur mit Nachbar-Knoten "meshen" sollen, wird für diese Knoten kein eigener Schlüssel benötigt.
 +
 
 +
Ein paar generelle Infos noch für dich: Die Freifunker aus Mainz, Wiesbaden und Umgebung (MWU) organisieren sich über verschiedene Plattformen wie Mailinglisten, Telegram-Gruppen oder Foren, zu denen jeder herzlich eingeladen ist. Unter diesen Adressen kannst du dich auf der für dich passenden registrieren, deine Fragen stellen und mit diskutieren.
 +
 
 +
Freifunk Mainz:
 +
https://lists.freifunk.net/mailman/listinfo/mainz-freifunk.net
 +
https://t.me/freifunkmainz
 +
 
 +
Freifunk Wiesbaden:
 +
https://lists.freifunk.net/mailman/listinfo/wiesbaden-freifunk.net
 +
https://t.me/freifunkwiesbaden
 +
 
 +
Freifunk Rheingau-Taunus:
 +
https://lists.freifunk.net/mailman/listinfo/rheingau-taunus-freifunk.net
 +
https://t.me/freifunkrtk
  
Ich habe Deinen Key soeben eingetragen. Das heißt Dein Freifunk-Knoten sollte sich in wenigen Minuten mit dem Netz verbinden können. Solltest Du Probleme haben, melde Dich immer gerne bei uns.
+
Freifunk Bingen:
Tipp: Solltest Du weitere Router anbinden wollen, die keinen eigenen Uplink haben, sondern nur mit dem eingetragenen Router meshen sollen, wird für diese Knoten kein eigener Schlüssel benötigt.
+
https://forum.freifunk-bingen.de/
  
Ein paar generelle Infos noch für Dich: Die Mainzer Freifunker organisieren sich über eine Mailingliste, zu der jedermann herzlich eingeladen ist. Unter dieser Adresse kannst du dich registrieren: https://lists.freifunk.net/mailman/listinfo/mainz-freifunk.net
+
Freifunk Limburg:
 +
https://lists.freifunk.net/mailman/listinfo/limburg-freifunk.net
  
Da über die Mailingliste durchaus mal ein paar Mails am Tag kommen können, bieten wir zusätzlich noch einen Newsletter an für diejenigen, die nur die wichtigsten Updates mitbekommen wollen: https://lists.freifunk.net/mailman/listinfo/mainz-newsletter-freifunk.net
+
Aktuelle Infos verbreiten wir immer auch in unseren Blogs
 +
https://blog.freifunk-mainz.de
 +
https://www.wiesbaden.freifunk.net/blog.html
 +
https://www.freifunk-rtk.de/blog
 +
https://www.freifunk-bingen.de/news
 +
https://www.freifunk-limburg.de/blog/
  
Aktuelle Infos verbreiten wir immer auch im Blog (https://blog.freifunk-mainz.de), über Twitter (https://twitter.com/freifunkmainz) und Facebook (https://www.facebook.com/FreifunkMainz).
+
über Twitter
 +
https://twitter.com/freifunkmainz
 +
https://twitter.com/freifunkwi
 +
https://twitter.com/FreifunkRTK
 +
https://twitter.com/freifunkbingen
 +
https://twitter.com/freifunk_LM
  
Außerdem bist Du natürlich immer herzlich eingeladen, zu unseren Treffen vorbeizukommen und uns kennen zu lernen und dich direkt auszutauschen. Alle Termine findest Du hier: https://blog.freifunk-mainz.de/termine/
+
und Facebook
 +
https://www.facebook.com/FreifunkMainz
 +
https://www.facebook.com/FreifunkWiesbaden
 +
https://www.facebook.com/FreifunkRTK
 +
https://www.facebook.com/FreifunkBingen
 +
https://www.facebook.com/FreifunkLimburg
 +
 
 +
Außerdem bist du natürlich immer herzlich eingeladen, zu unseren Treffen vorbeizukommen und uns kennen zu lernen und dich direkt auszutauschen. Die Termine findest du meistens im entsprechenden Blog aber immer auch auf der Mailingliste.
 +
 
 +
Wenn du magst, schick uns doch ein Foto deines Freifunk-Knotens und ein paar Worte dazu. Wenn wir das im Blog oder in den sozialen Netzen veröffentlichen, inspirieren wir auch andere, mitzumachen.
  
 
Viele Grüße und viel Spaß beim Freifunken! :-)
 
Viele Grüße und viel Spaß beim Freifunken! :-)
 
</nowiki>
 
</nowiki>
  
== Wiesbaden ==
+
= Welcome Message =
 +
Englische Übersetzung (by Google, überarbeitet von Martin Mainz)
 +
 
  <nowiki>
 
  <nowiki>
Hallo ...
+
Hi there ...
 +
 
 +
great that you are with us and expanding the Freifunk network!
 +
 
 +
I've just entered your key. This means that your Freifunk node should be able to connect to the network in a few minutes and appear on our map: https://map.freifunk-mwu.de
 +
 
 +
If you have any problems, please do not hesitate to contact us. Hint: If you want to connect additional routers that do not have their own Internet uplink, but should only "mesh" with neighboring nodes, no separate key is required for these nodes.
 +
 
 +
A few more general information for you: The Freifunker from Mainz, Wiesbaden and the surrounding area (MWU) organize themselves via mailing lists or forums to which everyone is cordially invited. At these addresses you can register on the one that suits you, ask your questions and participate in discussions:
 +
https://lists.freifunk.net/mailman/listinfo/mainz-freifunk.net
 +
https://lists.freifunk.net/mailman/listinfo/wiesbaden-freifunk.net
 +
https://lists.freifunk.net/mailman/listinfo/rheingau-taunus-freifunk.net
 +
https://forum.freifunk-bingen.de/
  
super, dass Du dabei bist und das Freifunk-Netz erweiterst!
+
We always spread the latest information in our blogs:
 +
https://blog.freifunk-mainz.de
 +
https://www.wiesbaden.freifunk.net/blog.html
 +
https://www.freifunk-rtk.de/blog
 +
https://www.freifunk-bingen.de/news
  
Ich habe Deinen Key soeben eingetragen. Das heißt Dein Freifunk-Knoten sollte sich in wenigen Minuten mit dem Netz verbinden können. Solltest du Probleme haben, melde dich immer gerne bei uns.
+
via Twitter
Tipp: Solltest Du weitere Router anbinden wollen, die keinen eigenen Uplink haben, sondern nur mit dem eingetragenen Router meshen sollen, wird für diese Knoten kein eigener Schlüssel benötigt.
+
https://twitter.com/freifunkmainz
 +
https://twitter.com/freifunkwi
 +
https://twitter.com/FreifunkRTK
 +
https://twitter.com/freifunkbingen
  
Ein paar generelle Infos noch für dich: Die Wiesbadener Freifunker organisieren sich über eine Mailingliste, zu der jedermann herzlich eingeladen ist. Unter dieser Adresse kannst du dich registrieren: https://lists.freifunk.net/mailman/listinfo/wiesbaden-freifunk.net
+
and Facebook
 +
https://www.facebook.com/FreifunkMainz
 +
https://www.facebook.com/FreifunkWiesbaden
 +
https://www.facebook.com/FreifunkRTK
 +
https://www.facebook.com/FreifunkBingen
  
Aktuelle Infos verbreiten wir immer auch auf unserer Webseite (http://wiesbaden.freifunk.net ), über Twitter (https://twitter.com/freifunkwi ) und Facebook (https://www.facebook.com/FreifunkWiesbaden ) zu verteilen.
+
In addition, you are of course always cordially invited to come to our meetings and get to know us and exchange ideas directly. You can usually find the dates in the relevant blog but always on the mailing list.
  
Außerdem bist du natürlich immer herzlich eingeladen, zu unseren Treffen vorbeizukommen und uns kennen zu lernen und dich direkt auszutauschen. Alle Termine findest du hier: http://wiesbaden.freifunk.net/treffen.html
+
If you like, send us a photo of your Freifunk node and a few words about it. When we post this on the blog or social media, we inspire others to join in too.
  
Viele Grüße und viel Spaß beim Freifunken! :-)
+
Many greetings and have fun with free sparking! :-)
 
</nowiki>
 
</nowiki>

Aktuelle Version vom 20. Januar 2022, 15:29 Uhr


Keys-Team
Name Keys
Kurzbeschreibung Eintragen von Mesh-VPN Keys
Mitglieder User:erik, User:florian, User:jan, User:juventas, User:marc, User:Martin_Mainz, User:mitch, User:prisma, User:wolfgang, User:MAGIC, User:Sven, User:ccgx, User:Ralph
Link Teams/Keys-Team
Aktiv wahr





Hintergrund

  • In unserer aktuellen Freifunk-Architektur verbinden sich die einzelnen Knoten entweder direkt untereinander (Mesh per WLAN) oder per VPN mit einem der Gateways (und darüber dann mit den anderen Freifunk-Knoten und mit dem Internet).
  • Als VPN-Software verwenden wir 'fastd'. Beim Aufsetzen des Knotens wird ein fastd-Schlüssel generiert, wenn "Mesh-VPN aktivieren" angekreuzt ist.
  • Damit ein Mesh-VPN-Knoten sich mit dem Gateway verbinden kann, muss das Gateway den öffentlichen fastd-Schlüssel des Knotens kennen.
  • Dazu tragen wir alle öffentlichen Schlüssel manuell in ein Github-Repository ein und die Gateways ziehen sich die Schlüssel aus dem Repository.
  • Das manuelle Eintragen wird vom Keys-Team übernommen. Es gibt zwei Arten, Keys ins Repository einzutragen: Via Web-Interface oder via Git-Client (beides siehe unten)
  • Nach dem Eintragen dauert es ca. 15 Minuten, bis der neue Key auf den Gateways übernommen ist und der Freifunk-Knoten über die Gateways online gehen kann.

Aufgaben des Teams

Vorgehen zum Eintragen eines neuen Knotens

  1. Prüfen, ob die Mail für Mainz oder Wiesbaden ist, d.h, prüfen, ob sich jemand aus Mainz aus Versehen die Wiesbadener Firmware geflasht hat oder umgekehrt - anhand Angaben in der Mail oder Info in der Karte (spätestens nach dem Eintragen).
  2. Prüfen, ob der Knoten evtl. näher an einer Nicht-MWU Community dran ist (sofern die Infos das hergeben)
  3. Key ins Repository eintragen. Dazu gibt es zwei Möglichkeiten:
    1. Entweder Key ins Repo eintragen über Web-GUI auf www.github.com
    2. oder mittels Git-Client. Für beide Varianten brauchst du einen Github-Account, der für die Keys-Repositories berechtigt sein muss.

Willkommensnachricht

Wenn ein neuer Freifunker einen Key einsendet, versorgen wir ihn mit Zusatzinfos und weiteren Anlaufstellen:

Hallo ...

super, dass du dabei bist und das Freifunk-Netz erweiterst!

Ich habe deinen Key soeben eingetragen. Das heißt, dein Freifunk-Knoten sollte sich in wenigen Minuten mit dem Netz verbinden können und auf unserer Karte auftauchen: https://map.freifunk-mwu.de

Solltest du Probleme haben, melde dich immer gerne bei uns. Tipp: Solltest du weitere Router anbinden wollen, die keinen eigenen Internet-Uplink haben, sondern nur mit Nachbar-Knoten "meshen" sollen, wird für diese Knoten kein eigener Schlüssel benötigt.

Ein paar generelle Infos noch für dich: Die Freifunker aus Mainz, Wiesbaden und Umgebung (MWU) organisieren sich über verschiedene Plattformen wie Mailinglisten, Telegram-Gruppen oder Foren, zu denen jeder herzlich eingeladen ist. Unter diesen Adressen kannst du dich auf der für dich passenden registrieren, deine Fragen stellen und mit diskutieren.

Freifunk Mainz:
https://lists.freifunk.net/mailman/listinfo/mainz-freifunk.net
https://t.me/freifunkmainz

Freifunk Wiesbaden:
https://lists.freifunk.net/mailman/listinfo/wiesbaden-freifunk.net
https://t.me/freifunkwiesbaden

Freifunk Rheingau-Taunus:
https://lists.freifunk.net/mailman/listinfo/rheingau-taunus-freifunk.net
https://t.me/freifunkrtk

Freifunk Bingen:
https://forum.freifunk-bingen.de/

Freifunk Limburg:
https://lists.freifunk.net/mailman/listinfo/limburg-freifunk.net

Aktuelle Infos verbreiten wir immer auch in unseren Blogs
https://blog.freifunk-mainz.de
https://www.wiesbaden.freifunk.net/blog.html
https://www.freifunk-rtk.de/blog
https://www.freifunk-bingen.de/news
https://www.freifunk-limburg.de/blog/

über Twitter
https://twitter.com/freifunkmainz
https://twitter.com/freifunkwi
https://twitter.com/FreifunkRTK
https://twitter.com/freifunkbingen
https://twitter.com/freifunk_LM

und Facebook
https://www.facebook.com/FreifunkMainz
https://www.facebook.com/FreifunkWiesbaden
https://www.facebook.com/FreifunkRTK
https://www.facebook.com/FreifunkBingen
https://www.facebook.com/FreifunkLimburg

Außerdem bist du natürlich immer herzlich eingeladen, zu unseren Treffen vorbeizukommen und uns kennen zu lernen und dich direkt auszutauschen. Die Termine findest du meistens im entsprechenden Blog aber immer auch auf der Mailingliste.

Wenn du magst, schick uns doch ein Foto deines Freifunk-Knotens und ein paar Worte dazu. Wenn wir das im Blog oder in den sozialen Netzen veröffentlichen, inspirieren wir auch andere, mitzumachen.

Viele Grüße und viel Spaß beim Freifunken! :-)

Welcome Message

Englische Übersetzung (by Google, überarbeitet von Martin Mainz)

Hi there ...

great that you are with us and expanding the Freifunk network!

I've just entered your key. This means that your Freifunk node should be able to connect to the network in a few minutes and appear on our map: https://map.freifunk-mwu.de

If you have any problems, please do not hesitate to contact us. Hint: If you want to connect additional routers that do not have their own Internet uplink, but should only "mesh" with neighboring nodes, no separate key is required for these nodes.

A few more general information for you: The Freifunker from Mainz, Wiesbaden and the surrounding area (MWU) organize themselves via mailing lists or forums to which everyone is cordially invited. At these addresses you can register on the one that suits you, ask your questions and participate in discussions:
https://lists.freifunk.net/mailman/listinfo/mainz-freifunk.net
https://lists.freifunk.net/mailman/listinfo/wiesbaden-freifunk.net
https://lists.freifunk.net/mailman/listinfo/rheingau-taunus-freifunk.net
https://forum.freifunk-bingen.de/

We always spread the latest information in our blogs:
https://blog.freifunk-mainz.de
https://www.wiesbaden.freifunk.net/blog.html
https://www.freifunk-rtk.de/blog
https://www.freifunk-bingen.de/news

via Twitter
https://twitter.com/freifunkmainz
https://twitter.com/freifunkwi
https://twitter.com/FreifunkRTK
https://twitter.com/freifunkbingen

and Facebook
https://www.facebook.com/FreifunkMainz
https://www.facebook.com/FreifunkWiesbaden
https://www.facebook.com/FreifunkRTK
https://www.facebook.com/FreifunkBingen

In addition, you are of course always cordially invited to come to our meetings and get to know us and exchange ideas directly. You can usually find the dates in the relevant blog but always on the mailing list.

If you like, send us a photo of your Freifunk node and a few words about it. When we post this on the blog or social media, we inspire others to join in too.

Many greetings and have fun with free sparking! :-)