diff --git a/club.md b/club.md new file mode 100644 index 0000000..9cb53e2 --- /dev/null +++ b/club.md @@ -0,0 +1,38 @@ +--- +title: Über Bastelei e. V. +description: +published: true +date: 2021-03-24T13:14:34.310Z +tags: +editor: markdown +dateCreated: 2021-03-14T12:56:11.370Z +--- + +# Bastelei e. V. + +Die Bastelei ist ein eingetragener Verein mit [Satzung](https://www.bstly.de/charter?lang=de). + +## Präambel {#Was} + +Jeden Monat überweisen wir zwielichtigen Konzernen zweistellige Beträge, damit sie uns unsere Daten abnehmen. Dafür bekommen wir intransparente Software mit denen wir auf Geräten, die wir nicht kontrollieren irgendwie unseren digitalen Alltag bestreiten müssen. Als erste Initiative dem ein Ende zu haben *\_Bastler* und *Louis Fabu*, der Sekretär der Kommenden Bastelei, die DIE DIGITALE BASTELEI gegründet. + +## Was wir machen {#Wir} + +Wir betreiben freie Software auf selbst-verwaltenden Servern und bieten euch so Alternativen zu den sog. "Cloud-Diensten", die euch sonst Google, Apple oder wer sonst andrehen. Wir verteilen die Kosten gleichmäßig auf alle Nutzenden und sammeln noch etwas mehr Geld ein, um das Ganze weiter zu entwickeln und weitere Projekte und Initiativen im Rahmen der Kommenden Bastelei zu finanzieren. Wir verwahren nur [minimale Daten](/de/privacy) von euch und verknüpfen eure Zahlungsinformationen nicht mit euren User-Konten. + +Zum Start gibt es aktuell für eine Jahresmitgliedschaft etliche Dienste wie ein E-Mail-Konto auf @bstly.de mit eigenem Adressbereich, 5GB Speicher und catch-all-Funktion, einen Account für unsere Nextcloud mit 15GB Speicherplatz, dazu gehören so praktische Funktionen wie synchronisierbare Kalender, Online Office zum kollaborativen Erstellen von Texten und einiges mehr. Außerdem mit Matrix eine Messaging Plattform und Zugang zu unserem digitalen Vereinsheim. Mehr Details zu den aktuellen und geplanten Dienste findest du [hier](/de/services). + +## Was du machen kannst {#Du} + +Du kannst Teil der Digitalen Bastelei werden: Werde Vereinsmitglied und bezahle deinen Mitgliedsbeitrag direkt über unser Einkaufs-System. Je mehr Leute die Dienste +nutzen, desto effizienter wird es natürlich, weswegen wir später eventuell weitere Dienste, Upgrades oder Wunschfeatures zur Verfügung stellen können. + +Die Vereinsmitgliedschaft richtet sich an alle, die den Verein aktiv unterstützen und mitgestalten möchten. Als Vereinsmitglied kannst du durch Teilnahme an Mitgliederversammlungen und Abstimmungen mitbestimmen. + +Vor allem mit Blick auf zukünftige Projekte auch außerhalb des digitalen Raumes ist deine aktive Beteiligung nötig, damit wir größere Vielfältigkeit und Kreativität in unsere Projekte bekommen. Und da wir große Freude an demokratischen Prozessen haben, ist jedes Mitglied auch eine Bereicherung um Vereinsprozesse offener gestalten zu können. Bei der Bastelei soll es um möglichst kreative, zwanglose und gute Zusammenarbeit zur Bereicherung aller Beteiligten gehen. + +Wenn du also nicht nur ein Interesse an unseren digitalen Diensten hast, sondern Ideen und Ziele mitverfolgen möchtest, kannst du dir deine Vereinsmitgliedschaft ganz einfach unter membership.bstly.de klicken. Du musst nur noch auf Genehmigung deines Antrages warten und anschließend deinen ersten Mitgliedsbeitrag überweisen. Anschließend bekommst du jährlich automatisch eine Erinnerung an deine hinterlegte E-Mail Adresse, deine Mitgliedschaft zu verlängern. Ein ausführliche Anleitung dazu findest du [hier](/de/services/pretix#Mitgliedschaft). + +## Warum ein e. V. {#Warum} + +Der eingetragene Verein bietet sich für unsere Zwecke als Rechtsform an, da wir nicht wirtschaftlich orientiert arbeiten wollen, sondern ideelle Ziele haben. Wir haben uns allerdings bewusst gegen eine Gemeinnützigkeit im Sinne des Vereinsgesetzes entschieden. Dies hat rechtliche Gründe, da wir uns selbst sehr wohl als Gemeinnützig betrachten würden. Die Erfahrung mit der Arbeit in gemeinnützigen Vereinen sowie die aktuellen Rechtsprechungen, die nicht mit unserem Verständnis von Gemeinnützigkeit übereinstimmen, haben uns jedoch zu dem Schluss kommen lassen, dass wir von Anfang an auf den juristischen Anspruch der Gemeinnützigkeit verzichten werden. Der offensichtliche Nachteil besteht vor allem im Verzicht auf Steuerbegünstigungen, dies gilt auch z.B. für die Steuererstattung von Mitgliedsbeiträgen, die hier entfällt. Auf der anderen Seite können wir jetzt einfacher Rücklagen bilden, Mitglieder für Arbeit entlohnen und freier Entscheidungen treffen, so dass wir unsere Ziele einfacher und schneller erreichen können. diff --git a/help.md b/help.md new file mode 100644 index 0000000..02e8e93 --- /dev/null +++ b/help.md @@ -0,0 +1,61 @@ +--- +title: Hilfsangebote +description: +published: true +date: 2021-03-24T07:22:04.678Z +tags: +editor: markdown +dateCreated: 2021-03-22T20:39:44.940Z +--- + +# Hilfsangebote von Bastelei e. V. + +> Unsere Hilfsangebote befinden sich noch im Aufbau. Wir versuchen so schnell es geht zu reagieren! +{.is-warning} + +Die Idee von einer zentralen Anlaufstelle für Hilfe haben wir vom [Chaos Computer Club](https://help.ccc.de) übernommen. + +## Übersicht + +Du brauchst emotionale Unterstützung bei **Konflikten**, **Belästigung** oder **Diskriminierung**? +- [Awareness](#Awareness) + +Du brauchst **technische Hilfe** oder hast Sorge um deine **Datensicherheit**? +- [Support](#Support) + +## Awareness {#Awareness} + +Mit dem Awarenessteam wollen wir dir eine Anlaufstelle bieten, um Erlebtes zu verarbeiten, Konflikte zu lösen und insbesondere auch für Minderheiten eine sicherere und angenehmere Atmosphäre zu schaffen. + +### Kontakt +- **Email** + - [help@bstly.de](mailto:help@bstly.de) + {.links-list} +- **Matrix** + - \_Bastler [@=5fbastler:bstly.de](https://element.bstly.de/#/user/@=5fbastler:bstly.de) + - fabu [@fabu:bstly.de](https://element.bstly.de/#/user/@fabu:bstly.de) + {.links-list} + +## Support {#Support} + +Unser Support wird versuchen dir bei allen technischen Problemen behilflich zu sein. Keine Frage sollte dir zu dumm vorkommen, frage lieber einmal zu viel als einmal zu wenig! + +### Kontakt +- **Email** + - [support@bstly.de](mailto:support@bstly.de) + {.links-list} +- **Matrix** + - [#support:bstly.de](https://element.bstly.de/#/room/#support:bstly.de) + {.links-list} + +## Allgemeiner Kontakt + +- **Email** + - [help@bstly.de](mailto:help@bstly.de) + {.links-list} +- **Matrix** + - [#help:bstly.de](https://element.bstly.de/#/room/#help:bstly.de) + {.links-list} +- **Telefon** + - [02332 666 77 01](tel:+4923326667701) + {.links-list} \ No newline at end of file diff --git a/home.md b/home.md new file mode 100644 index 0000000..1b30027 --- /dev/null +++ b/home.md @@ -0,0 +1,49 @@ +--- +title: Bastelei Wiki +description: +published: true +date: 2021-03-23T19:39:11.724Z +tags: +editor: markdown +dateCreated: 2021-03-12T17:03:32.148Z +--- + +# Willkommen + +Herzlich Willkommen im Wiki vom Bastelei e. V. + +In diesem Wiki findest du alle Informationen und Anleitungen. + +Benötigst du akute oder spezielle Hilfe schaue bitte direkt auf unsere Seite mit [Hilfsangeboten](/de/help). + +## Bastelei e. V. {#Bastelei} + +Alle Informationen rund um den Bastelei e. V. + +- [Über den Verein](/de/club) +- [Datenschutz](/de/privacy) + +## Dienste {#Dienste} + +Alle Informationen rund um unsere Dienste + +- [Überblick über vorhanden Dienste](/de/services) +- [Überblick über geplante Dienste und Ideen](/de/services/planned/) + +### Direkthilfen für einzelne Dienste + +* [Pretix](/de/services/pretix) Mitgliedschaft beantragen, verwalten, erweitern +* [we.bstly](/de/services/webstly) Account registrieren, verwalten +* [E-Mail](/de/services/email) Einrichten, @Catch-All +* [Nextcloud](/de/services/nextcloud) Dateien, Kalender, Kontakte uvm. verwalten +* [Matrix](/de/services/matrix) Instant Messenger, Communities +* [Partey](/de/services/partey) virutelles Vereinsheim +* [Wiki.js](/de/services/wiki) Informationen, Anleitungen uvm. +* [Gitea](/de/services/gitea) Git-Repositieres einrichten, verwalten + + +## Technik {#Technik} + +Überblick über die technische Umsetzung + +- [Server](/de/server) \ No newline at end of file diff --git a/partey/prty_action1.png b/partey/prty_action1.png new file mode 100644 index 0000000..44429c6 Binary files /dev/null and b/partey/prty_action1.png differ diff --git a/partey/prty_action2.png b/partey/prty_action2.png new file mode 100644 index 0000000..32fa308 Binary files /dev/null and b/partey/prty_action2.png differ diff --git a/partey/prty_audio.png b/partey/prty_audio.png new file mode 100644 index 0000000..7990ad6 Binary files /dev/null and b/partey/prty_audio.png differ diff --git a/partey/prty_avatar.png b/partey/prty_avatar.png new file mode 100644 index 0000000..33d463f Binary files /dev/null and b/partey/prty_avatar.png differ diff --git a/partey/workdadvenutekey.pub b/partey/workdadvenutekey.pub new file mode 100644 index 0000000..a14c337 --- /dev/null +++ b/partey/workdadvenutekey.pub @@ -0,0 +1 @@ +ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQCytD12SSJBjf4R6NK5jOBGIe45Wax94878C1eqgCa8JTkq9kJ9oDiJ9v9tE5K8DDI33rkI2a9ObEWhV9oygIp7G/vGcL6xU6x9yLp5FXgrEtBn5YZwyvgL8uz3szblnyvZX/QZK8P5yq4SEQ7I731iVh1duSBSPb1eUu6LirPcq4RCc9OTBZxSyKpOHEpQR0Ox1eUjE0CZ+zA8ma0Ztrwem6WavLI33d7YPcAVyVHN9qacmhSahAxmd+WPcfprnAx86I2n0QGTMqGn6YI20qoMTOQodwctBlTyyZhDuK19v2cV/8bd6yJzJPMEPk5mROmedLb37PjaFyKXLz5x9t0nelN7ZCJI5PMG3e7kbFBXbMxfSoWShX6+oq7/HjF5ybAtPFKBAxbxkCwuxCwSs6ceI+xYCmSu7fJX+IKJq1JTNT20QiNzYbedJdyZdjAM+w4Z7SgnJa6m0GrgxM5k6pbbM5vQUv7iciTzCjh1Kx+QoqzxDk9UmRU09BIpB6E6+mE= workadventure@bstly diff --git a/privacy.md b/privacy.md new file mode 100644 index 0000000..1d40d66 --- /dev/null +++ b/privacy.md @@ -0,0 +1,85 @@ +--- +title: Datenschutzerklärung +description: +published: true +date: 2021-03-24T12:59:29.583Z +tags: +editor: markdown +dateCreated: 2021-03-14T19:50:59.500Z +--- + +# Datenschutz + +Hier findest du eine kleine Übersicht über Datenschutz bei uns und unser Verständnis davon. Die genaue Auflistung der Verwendung deiner Nutzungsdaten findest du in unserer [Datenschutzerklärung](https://www.bstly.de/privacy-policy?lang=de). + +## Privacy By Design {#privacy} + +Privacy by Design bedeutet, dass die Systeme grundlegend auf Datensparsamkeit ausgelegt sind. Wir versuchen generell immer so wenig Daten wie möglich zu erheben. Frei nach dem Motto 'was man nicht hat, kann man auch nicht verlieren'. Das gilt zuerst einmal generell für Daten, die wir erheben, aber auch für die Verknüpfung verschiedener Daten zueinander. + +Um Account- und Zahlungsdaten zu trennen, benutzen wir das Ticket-System *Pretix* mit seinem Check-In System. Für jedes Item wird ein geheimes Token generiert. In unserer selbst entwickelten Serverkomponente *we.bstly* kann dieses Token dann eingelöst werden und die entsprechende Leistung gespeichert werden. Das Token wird dann in *Pretix* als eingelöst markiert. + +Die Verknüpfung von Account/Leistung und Token ist also nur temporär für die bestehende Browser Session gültig und wird sonst nicht dauerhaft gespeichert. Sprich: es gibt zwei Datenbanken, eine für Zahlungsdaten und Tokens (*Pretix*) und eine mit Account- und Berechtigungsdaten (*we.bstly*). Die Verknüpfung findet nur in einer aktiven Browser-Session statt und wird nach Einlösen des Token auch dort vergessen. Es gibt also keinerlei Verknüpfung von Zahlungsdaten und Account. + +Abstriche machen wir aktuell bei der Verknüpfung von Accounts bei den einzelnen Diensten. Wie immer haben Komfort und Einfachheit ihren Preis. Durch sogenanntes [Single-Sign-On](https://de.wikipedia.org/wiki/Single_Sign-on) (*SSO*) über [OpenID Connect](https://de.wikipedia.org/wiki/OpenID_Connect) (*OIDC*) heißt das: Ein Account für Alles. Sprich, die Nutzung der einzelnen Dienste ist immer auf deinen *we.bstly*-Account zurückzuführen. Zum Einen bietet das den Komfort von *SSO*, dass du nur auf diesen einen Account gut aufpassen musst. Zum Anderen bekommt man dafür natürlich auch die Einfachheit, dass alle die Gewissheit haben, dass es sich bei den verschiedenen Diensten immer um den gleichen *we.bstly*-Account handelt. So weißt du z.B., dass du auch genau dem Menschen eine E-Mail schreibst, mit dem du gerade gechattest hast. + +## Einzelne Dienste {#Dienste} + +Hier fassen wir die Datenerfassung der einzelnen Dienste zusammen. Für die genauen Details verweisen wir erneut auf unsere [Datenschutzerklärung](https://www.bstly.de/privacy-policy?lang=de). Mehr Informationen oder Anleitungen zu Funktionen der einzelnen Diensten findest du in unserem [Überblick über vohandene Dienste](/de/services). + +### Pretix {#Pretix} + +Im *Pretix* System müssen wir natürlich persönliche Daten zum Zahlungsverkehr sowie eine E-Mail-Adresse zum Versenden von E-Mails mit Bestätigungen, Zahlungsdaten sowie zum Verschicken der Token speichern. Als Vereinsmitglied werden hier deine zu erhebenden Mitgliedsdaten sowie dein Mitgliedsbeitragskonto gespeichert. Wie eingangs erwähnt findet keinerlei Verknüpfung dieser Daten mit anderen Diensten statt. + +### we.bstly {#webstly} + +In *we.bstly* brauchst du lediglich einen Usernamen und ein Passwort (gut *gesalzen*, [Argon2](https://de.wikipedia.org/wiki/Argon2) gehashed!). Zusätzlich wird noch ein [PGP](https://de.wikipedia.org/wiki/Pretty_Good_Privacy)-Schlüsselpaar erstellt, mehr nicht. Optional ist noch die Angabe einer E-Mail Adresse. Diese ist erforderlich beim Verlust der Login-Daten bzw. deines *Privaten Schlüssels*. Wir halten diese Option allerdings offen, so dass eine völlig anonyme Nutzung aller Dienste möglich ist, wenn du dein Passwort bzw. deinen *Privaten Schlüssel* nicht verlierst! + +Zusätzlich zu deinen zentralen Account-Daten werden hier auch deine Berechtigungen und das Ablaufdatum deiner Dienste gespeichert. Aktuell wird auch die Information gespeichert, dass du ein reguläres Vereinsmitglied bist. Dies hat den Vorteil, dass wir über unsere Dienste auch alle Vereinsmitglieder direkt erreichen können oder erweiterte Dienste anbieten können. Die Daten werden selbstverständlich nicht mit deinen Mitgliedsdaten oder dem Mitgliedsbeitragskonto verknüpft, sprich: wir wissen lediglich, **dass** du Vereinsmitglied bist, **nicht welches**! + +Optional kannst du deinem Account noch weitere Profildaten mit einstellbarer Sichtbarkeit (*Privat*, *Geschützt* und *Öffentlich*) anlegen. Private Profilfelder sind nur für dich sichtbar, Geschützte auch für andere Benutzer und Öffentliche sind auch für Dritte einsehbar. + +### Nextcloud {#Nextcloud} + +Wie sensibel die Daten in der *Nextcloud* sind hängt natürlich nur von deiner Nutzung ab. Vom Dienst selber fallen keine Daten außer deine Account-Daten (nur Username und freiwillige Profildaten) an. Da hier ausschließlich von Usern selbst erstellte Inhalte gespeichert werden, kommt es darauf an, was du hochlädst, veröffentlichst und schreibst. Die Daten werden automatisch verschlüsselt gespeichert, es handelt sich dabei allerdings nur um eine serverseitige Verschlüsselung, sodass du die Daten weiterhin mit Anderen teilen kannst. *Nextcloud* bietet allerdings in den aktuellen Versionen auch eine eigene *Ende-Zu-Ende*-Verschlüsselung (*E2EE*) an. Es steht dir natürlich frei diese für sensible Daten zu nutzen, sodass auch niemand anderes an diese Dateien kommt. Beachte aber, dass diese Dateien dann nicht mehr im Browser zugänglich sind und nicht geteilt werden können. Außerdem gilt die *E2EE* nur für Dateien und nicht für andere Daten wie Kontakte, Kalender o.Ä., so dass die Empfehlung ist, immer darüber nachzudenken, welche Daten man gerade erzeugt und wie sensibel diese sind. + +Da *Nextcloud* auch als Basis für einige Community-Funktionen dient, werden deine Account-Daten mit allen anderen Usern geteilt. Es steht dir aber auch frei, weitere Daten wie Dateien, Kalender etc. mit anderen Benutzern zu teilen. + + +### E-Mail {#Mail} + +Aktuell werden die E-Mails so wie sie ankommen auf dem Server gespeichert. Da dies einige Nachteile und unnötiges Vertrauen benötigt, wird an einer Lösung gearbeitet alle E-Mails automatisch mit deinem *Öffentlichen Schlüssel* zu verschlüsseln. Das gibt dir die Sicherheit, dass auch nur du die E-Mails entschlüsseln kannst. Allerdings bedeutet dies auch, dass du all deine E-Mail-Clients für die Entschlüsselung einrichten musst. Wir werden selbstverständlich detaillierte Anleitungen dazu veröffentlichen wenn es soweit ist und vermutlich auch ein *Opt-Out* anbieten, wenn du auf diese Funktion verzichten möchtest. + +Zur Authentifizierung werden deine *we.bstly*-Account Daten verwendet. Beachte, dass eine aktivierte Zwei-Faktor-Authentifizierung in deinem *we.bstly*-Account keinen Einfluss auf deinen E-Mail Login hat. + +### Matrix {#Matrix} + +Da *Matrix* ein Messaging-Dienst ist können hier natürlich sensible Kommunikationsdaten anfallen. *Matrix* bietet zum Glück eine *Ende-zu-Ende*-Verschlüsselung an. Da diese allerdings optional ist, empfehlen wir dir darauf zu achten *E2EE* immer zu aktivieren. + +Neben deinen Chat-Nachrichten werden für den Dienst noch deine Raum-Mitgliedschaften gespeichert. Erstellst du selbst öffentliche Räume sind diese natürlich auch für andere sichtbar. + +Beachte bitte auch, dass *Matrix* ein dezentrales Netzwerk ähnlich zur E-Mail Kommunikation ist. Das bedeutet, dass du die Möglichkeit hast mit Benutzern von anderen Anbietern zu kommunizieren, du aber dann auch Daten inklusive deiner Nachrichten an diese Server überträgst. + +### Partey {#Partey} + +In unserem *virtuellen Vereinsheim* werden keinerlei Daten gespeicherst. Dennoch ist durch die Übertragung von deinen Video- und Audio-Daten ein höchst sensibler Bereich betroffen. Wie erwähnt werden diese Daten nicht durch uns persistiert, es ist jedoch technisch nicht ausgeschlossen, dass andere Benutzer verbotenerweise Mitschnitte anfertigen. Falls du Kenntnis über irgendwelche Verstöße hast, bitten wir dich dringend mit uns Kontakt aufzunehmen. Als erste Anlaufstelle gibt es dafür unsere Seite mit [Hilfsangeboten](/de/help). + +### Jitsi-Meet {#Jitsi} + +In unseren *Jitsi-Meet* Räumen gilt eigentlich das Gleiche wie für unser *virtuelles Vereinsheim*. Es werden keine Daten von dir gespeichert, aber du solltest ein Bewusstsein dafür haben, dass du sensible Video- und Audio-Daten in Echtzeit an andere Benutzer überträgst. + +### Wiki.js + +In unserem *Wiki* werden generell keine persönlichen Daten erfasst. Für deinen Account werden nur dein *we.bstly* Username und deine E-Mail Adresse übertragen. Generell sind alle Texte die du verfasst öffentlich und mit deinem Usernamen verknüpft. Zusätzlich gibt es eine Kommentarfunktion. Diese ist allerdings nur für andere Benutzer zugänglich und nicht öffentlich. + +### Gitea + +Ähnlich wie bei *Nextcloud* werden vom Dienst selber nur dein Username und ein paar persönliche Einstellungen gespeichert. Wie sensibel die Daten in deinen *Git*-Repositories sind und wer auf diese zugreifen kann hängt ganz von dir ab. Achte also darauf, welche Dateien du hochläds und ob dein Repository auch öffentlich zugänglich ist. Da Repositories oft Source Code enthalten inklusive Konfigurationsdateien möchten wir dich daran erinnern darauf zu achten keine sensible Informationen wie Passwörter, *API-Keys* oder *Private Schlüssel* ausversehen in dein Repository zu laden. + +## Webserver {#Webserver} + +Alle Dienste laufen über einen Webserver, wie auch z.B. diese Seite. Generell fallen bei einem Webserver automatisch ein Haufen Daten an, wie z.B. deine IP-Adresse, deine Webbrowser-Version und einiges mehr. Dass diese Daten übertragen werden ist technisch bedingt und lässt sich nur mit Aufwand von deiner Seite aus verhindern. Wichtig ist also, was wir mit diesen Daten machen. + +Die Antwort darauf ist einfach: Nichts! Im Allgemeinen werden diese Daten gar nicht gespeichert. Im Zuge von Wartungsarbeiten o.Ä. kann es dazu kommen, dass diese Daten in Log-Files geschrieben werden, damit wir Problemen auf den Grund gehen können. Diese werden dann allerdings mit keinen anderen Daten verknüpft und direkt nach Beendigung der Arbeiten gelöscht! + + + diff --git a/server.md b/server.md new file mode 100644 index 0000000..99cc78a --- /dev/null +++ b/server.md @@ -0,0 +1,44 @@ +--- +title: Server +description: +published: true +date: 2021-03-22T08:18:05.139Z +tags: +editor: markdown +dateCreated: 2021-03-14T12:59:42.340Z +--- + +# Details zur Technik + +## Übersicht über eingesetzte Server {#Server} + +| Zweck | Art | Prozessor | RAM | HDD | LAN | OS | +| - | - | - | - | - | -| +| Aktuell für alle Dienste |virtueller Root-Server (KVM) | AMD EPYC™ 7702 6x 3.35 GHz | 32 GB DDR4 | 800 GB SSD | 2.5 GBit/s | Ubuntu 20.04 | + +Aktuell wird ein Server für alle Dienste eingesetzt. Für unsere aktuellen Bedürfnisse und Mitgliederzahlen sollte das ausreichend sein und ein erstes Upgrade wird auch nur ein Umzug auf einen einzelnen größer dimensionierten Server sein. Technisch wäre es schöner und sicherer, die einzelnen Dienste auch auf verschiedenen Servern laufen zu lassen. Wir haben uns aber aktuell natürlich lieber für geringere Kosten entschieden um so einen niedrigen Jahresbeitrag festlegen zu können. + +## Übersicht über eingesetzte Software {#Software} + +Neben den direkt zugänglichen [Diensten](/de/services) wird noch weitere Software eingesetzt: + +* [Apache Webserver](https://httpd.apache.org/) Neben der direkten Funktion als Webserver, wird Apache auch als Proxy für fast alle Dienste eingesetzt, so dass diese nur lokal direkt erreichbar sind +* [OpenSSH](https://www.openssh.com/) Zugang für *\_Bastler* +* [PostgreSQL](https://www.postgresql.org/) SQL Datenbank für einige andere Dienste +* [MariaDB](https://mariadb.org/) SQL Datenbank für einige Dienste +* [Ufw](https://launchpad.net/ufw) Firewall +* [Fail2ban](https://www.fail2ban.org) Bruteforce protection + +## F.A.Q. {#FAQ} + +### Warum Ubuntu? + +Sicher eine berechtigte Frage. Die Gründe sind allerdings weniger technisch, sondern eher pragmatisch. *\_Bastler* ist mit Debian-basierten Systemen bestens vertraut und Ubuntu bietet eine etwas bessere Update-Politik als Debian-Stable. Mit einem Ubuntu Desktop können gleichzeitig einfach Dinge getestet werden, da die Umgebungen weitestgehend identisch sind. + +### Warum zwei SQL Datenbanken + +Dem Umstand geschuldet, dass alle Dienste auf einem Server laufen muss neben dem bevorzugten *PostgreSQL* auch noch *MariaDB* installiert sein, da einige Dienste leider (noch?) kein *PostgreSQL* unterstützen. + +### Warum Apache Webserver und nicht nginx? + +Auch einfach nur der mangelnden Erfahrung mit *nginx* aber relativ großer Expertise im Umgang mit *Apache* von *\_Bastler* geschuldet. \ No newline at end of file diff --git a/services.md b/services.md new file mode 100644 index 0000000..932153e --- /dev/null +++ b/services.md @@ -0,0 +1,166 @@ +--- +title: Dienste +description: +published: true +date: 2021-03-24T13:09:03.513Z +tags: +editor: markdown +dateCreated: 2021-03-14T12:45:06.982Z +--- + +# Aktuelle Dienste + +Hier findest du eine Übersicht über unsere Dienste. Wenn du mehr über den Datenschutz der einzelnen Dienste erfahren möchtest, schaue doch unter [Datenschutz](/de/privacy#Dienste) rein oder lese direkt unsere [Datenschutzerklärung](https://www.bstly.de/privacy-policy?lang=de). Eine Übersicht über geplante Dienste findest du [hier](/de/services/planned/). + +## Pretix {#pretix} + +## {.tabset} + +### Info +Pretix ist ein Event-Ticketsystem. Wir setzen Pretix hauptsächlich dafür ein, unsere Mitgliedsbeiträge und Mitgliedschaften zu verwalten. Natürlich wird Pretix auch für Tickets für Veranstaltungen genutzt werden. + +[Details zur Nutzung](/de/services/pretix) + +### Software +| | Homepage | Source Code | Lizenz | +| - | - | - | - | +| Pretix | [pretix.eu](https://pretix.eu)| [github.com/pretix/pretix](https://github.com/pretix/pretix) | [Apache 2.0](https://github.com/pretix/pretix/blob/master/LICENSE) + +## we.bstly {#we-bstly} + +## {.tabset} + +### Info +Das we.bstly-System ist die zentrale Verwaltung für Account-Daten und Berechtigungen. Hier werden also Login-Daten (Username + Password-Hash) und optional Profildaten wie dein Öffentlicher Schlüssel gespeichert, sowie verknüpfte Berechtigungen mit ihrer Gültigkeitsdauer (Beispiel: Mitgliedschaft noch bis 24.03.2049, Git-Zugang bis 01.02.2027). + +Implementiert ist dort ein OpenID Connect (OIDC) Provider der den Zugriff auf die anderen Dienste ermöglicht. Sprich, für alle weiteren Dienste (Ausnahme E-Mail, siehe unten) läuft der Login direkt über we.bstly (SSO - Single Sign On). + +[Details zur Nutzung](/de/services/webstly) + +### Software +| | Homepage | Source Code | Lizenz | +| - | - | - | - | +| we.bstly API | [bstly.de](https://www.bstly.de) | [git.bstly.de/\_Bastler/we_bstly-api](https://git.bstly.de/_Bastler/we_bstly-api) | [AGPL 3](https://git.bstly.de/_Bastler/we_bstly-api/src/branch/main/LICENSE) | +| we.bstly Frontend | [bstly.de](https://www.bstly.de) | [git.bstly.de/\_Bastler/we_bstly-web](https://git.bstly.de/_Bastler/we_bstly-web) | [AGPL 3](https://git.bstly.de/_Bastler/we_bstly-web/src/branch/main/LICENSE) | + + +## E-Mail {#mail} + +## {.tabset} + +### Info +Für deinen Usernamen wird automatisch ein E-Mail Konto mit dem Schema {username}@we.bstly.de (Beispiel für den User foobar: [foobar@we.bstly.de](#)) erstellt. Außerdem wird ein sogenanntes @Catch-All für @{username}.we.bstly.de eingerichtet. Das bedeutet, dass automatisch alle E-Mails an eine Adresse an @{username}.we.bstly.de in deinem Postfach landen. So hast du eigentlich endlos viele E-Mail-Adressen zur Verfügung. Ein automatischer Spam-Filter und ein Webmail Zugang sind natürlich auch dabei. + +Für E-Mail Protokolle gibt es keinen OIDC-Login, dies bedeutet technisch, dass zum Login einfach die Account-Datenbank von we.bstly genommen werden und somit dein we.bstly-Account Passwort. + +[Details zur Nutzung](/de/services/email) + +### Software + +| | Homepage | Source Code | Lizenz | +| - | - | - | - | +| Dovecot | [dovecot.org](https://www.dovecot.org) | [github.com/dovecot/core](https://github.com/dovecot/core) | [MIT](https://github.com/dovecot/core/blob/master/COPYING) | +| Postfix | [www.postfix.org](http://www.postfix.org) | [postfix.org/download.html](http://www.postfix.org/download.html) | [EPL 2.0 / IPL 1.0](https://de.postfix.org/ftpmirror/LICENSE) | +| Rspamd | [rspamd.com](https://www.rspamd.com) | [github.com/rspamd/rspamd](https://github.com/rspamd/rspamd) | [Apache 2.0](https://github.com/rspamd/rspamd/blob/master/LICENSE.md) | +| RainLoop Webmail | [rainloop.net](https://www.rainloop.net) | [github.com/RainLoop/rainloop-webmail](https://github.com/RainLoop/rainloop-webmail) | [AGPL 3.0](https://github.com/RainLoop/rainloop-webmail/blob/master/LICENSE) | + +## Nextcloud {#nextcloud} + +## {.tabset} + +### Info +Nextcloud vereint einige Cloud-Dienste in einem. Ein einfaches Dateisystem wie z.B. von Dropbox, einen Kalender wie z.B. von Google und und und. Die Daten in der Nextcloud sind generell verschlüsselt, für volle Sicherheit deiner Dateien kannst du allerdings auch die Ende-zu-Ende-Verschlüsselung der Nextcloud nutzen. + +Durch einige App-Erweiterungen bietet auch einige Community-Funktionen, die wir gerne mit euch nutzen möchten. + +[Details zur Nutzung](/de/services/nextcloud) + +### Software + +| | Homepage | Source Code | Lizenz | +| - | - | - | - | +| Nextcloud | [nextcloud.com](https://nextcloud.com) | [github.com/nextcloud/server]("https://github.com/nextcloud/server) | [AGPL 3](https://github.com/nextcloud/server/blob/master/COPYING) | +| Collabora Online | [collaboraoffice.com/code/](https://www.collaboraoffice.com/code/) | [github.com/CollaboraOnline/online](https://github.com/CollaboraOnline/online) | [Mozilla Public 2.0](http://mozilla.org/MPL/2.0/) | + +## Matrix {#matrix} + +## {.tabset} + +### Info +Mit einem Matrix-Server können wir Teil eines dezentralen Messaging Netzwerk werden, welches mit einer E2EE die größtmögliche Datensicherheit bietet. Es gibt verschiedene Clients, alles im allem ähnelt die Handhabung aber den gängigen, bekannten Messenger wie Signal, WhatsApp, Threema oder Telegram. Mit Element Web wird auch direkt eine Oberfläche für den Browser mit angeboten. + +Über Matrix werden wir euch auch mit allen wichtigen Informationen über "Bastelei e. V." informieren. + +[Details zur Nutzung](/de/services/matrix) + +### Software +| | Homepage | Source Code | Lizenz | +| - | - | - | - | +| Synapse | [matrix.org/docs/projects/server/synapse](https://matrix.org/docs/projects/server/synapse) | [github.com/matrix-org/synapse](https://github.com/matrix-org/synapse/) | [Apache 2.0](https://github.com/matrix-org/synapse/blob/develop/LICENSE) | +| Element Web | [element.io](https://element.io/) | [github.com/vector-im/element-web](https://github.com/vector-im/element-web) | [Apache 2.0](https://github.com/vector-im/element-web/blob/develop/LICENSE) | + + +## Partey {#partey} +## {.tabset} + +### Info + +Partey ist unser virtuelles Vereinsheim und basiert auf der Software Workadventure. Workadventure wurde in etwas abgewandelter Form beim [rC3](https://events.ccc.de/2020/09/04/rc3-remote-chaos-experience/) des [Chaos Computer Club](https://www.ccc.de/) eingesetzt. In niedlicher 2D Adventure Grafik setzen wir so unser digitales Vereinsheim um. Mit Kamera und Mikrofon werden bis zu 4 Teilnehmer direkt verbunden, wenn sie sich nahe kommen. Eine Einbindung von [Jitsi](#jitsi)-Räumen bietet die Möglichkeit sich in größeren Gruppen zu treffen. Weitere Features sind das einblenden von externen Webseiten und das Abspielen von Musik(-Streams) um ein noch interaktiveres Erlebnis zu ermöglichen. + +Im Zusammenspiel mit [Gitea](#gitea) können alle Nutzer eigene Karten einbinden! + +[Details zur Nutzung](/de/services/partey) + +### Software +| | Homepage | Source Code | Lizenz | +| - | - | - | - | +| Workadventure | [workadventu.re](https://workadventu.re/) | [github.com/thecodingmachine/workadventure](https://github.com/thecodingmachine/workadventure)
Partey-Fork:
[git.bstly.de/\_Bastler/partey_workadventure](https://git.bstly.de/_Bastler/partey_workadventure) | custom [AGPL](https://github.com/thecodingmachine/workadventure/blob/develop/back/LICENSE.txt) :warning:[^1] | + + +## Jitsi Meet {#jitsi} + +## {.tabset} + +### Info +Jitsi Meet ist eine Online-Konferenzsoftware. Vor allem die Einfachheit in der Bedienung und aufs Nützlichste beschränkte Funktionen sind die Vorteile von Jitsi Meet. Da es in jedem modernen Browser läuft, fällt auch die lästige Installation von Anwendungen auf Endgeräten weg. Lediglich auf Smartphones wird die kostenlose [Jitsi-App](https://jitsi.org/#download) benötigt. Hier muss als Server dann der Bastelei-Server angegeben werden. + +Aktuell fehlt noch die Umsetzung zur Erstellung von eigenen Räumen und der Dienst ist nur in [Partey](#partey) eingebunden. + +### Software +| | Homepage | Source Code | Lizenz | +| - | - | - | - | +| Jitsi Meet | [jitsi.org/jitsi-meet](https://jitsi.org/jitsi-meet/) | [github.com/jitsi/jitsi-meet](https://github.com/jitsi/jitsi-meet) | [Apache 2.0](https://github.com/jitsi/jitsi-meet/blob/master/LICENSE) | + + +## Wiki.js {#wiki} + +## {.tabset} + +### Info +Du befindest dich gerade schon in Wiki.js 😉! + +[Details zur Nutzung](/de/services/wiki) + +### Software +| | Homepage | Source Code | Lizenz | +| - | - | - | - | +| Wiki.js | [js.wiki](https://js.wiki/)| [github.com/Requarks/wiki](https://github.com/Requarks/wiki) | [AGPL 3.0](https://github.com/Requarks/wiki/blob/dev/LICENSE) | + +## Gitea {#gitea} + +## {.tabset} + +### Info +Gitea bittet offene Source-Code Verwaltung auf Basis von git-Repositories (vergleichbar mit GitHub). Gegenüber der Konkurrenz bietet Gitea vor allem den Vorteil, dass es selbst betrieben werden kann und man so die Hoheit über seine Daten und seinen Code behält. Nennenswerte zusätzliche Features gegenüber vergleichbarer Software gibt es nicht, der Funktionsumfang steht allerdings auch in nichts nach. + +[Details zur Nutzung](/de/services/gitea) + +### Software +| | Homepage | Source Code | Lizenz | +| - | - | - | - | +| Gitea | [gitea.io](https://gitea.io/) | [github.com/go-gitea/gitea](https://github.com/go-gitea/gitea) | [MIT](https://github.com/pretix/pretix/blob/master/LICENSE) | + + +## {-} + +[^1]: https://github.com/thecodingmachine/workadventure/issues/678 \ No newline at end of file diff --git a/services/email.md b/services/email.md new file mode 100644 index 0000000..556c7a6 --- /dev/null +++ b/services/email.md @@ -0,0 +1,32 @@ +--- +title: E-Mail +description: +published: true +date: 2021-03-21T11:35:55.507Z +tags: +editor: markdown +dateCreated: 2021-03-19T10:32:38.603Z +--- + +# Nutzung von E-Mail + +## Webmail {#Webmail} + +Unter [webmail.bstly.de](https://webmail.bstly.de/) erreichst du die Webmail Oberfläche. Hier kannst du dich einfach mit deinem we.bstly Usernamen und Passwort einloggen. An den Usernamen wird automatisch @we.bstly.de angehängt, du kannst aber auch deine vollständige E-Mail Adresse angeben. + +## E-Mail Client {#Client} + +Wenn du einen E-Mail Client einrichten möchtest, empfehlen wir folgende Einstellungen: +* *Server* mail.bstly.de +* *IMAP* mit SSL auf Port 993 +* *STMP* mit SSL auf Port 465 +* *Login* {username}@we.bstly.de +* *Passwort* dein we.bstly Passwort + +## @Catch-All {#CatchAll} + +Für die @Catch-All Funktion musst du nichts weiter tun. Eine Weiterleitung aller E-Mails an @{username}.we.bstly.de findet automatisch statt. Die E-Mail sind also ganz normal über dein Postfach abrufbar. + +## Verschlüsselte E-Mail mit PGP {#PGP} + +T.B.D. \ No newline at end of file diff --git a/services/gitea.md b/services/gitea.md new file mode 100644 index 0000000..b8f05cf --- /dev/null +++ b/services/gitea.md @@ -0,0 +1,21 @@ +--- +title: Gitea +description: +published: true +date: 2021-03-21T12:33:12.906Z +tags: +editor: markdown +dateCreated: 2021-03-19T10:46:19.893Z +--- + +# Nutzung von Gitea + +Der Zugang zu Gitea ist aktuell eingeschränkt, da (noch) keine Quota umgesetzt ist. Möchtest du Gitea nutzen musst du den Zugang zunächst beantragen. + +## Zugang beantragen {#Antrag} + +Der Zugang zu Gitea kann über ein Add-On im [Pretix](/de/services/pretix) System beantragt werden. Fordere einfach [Gutschein](/de/services/webstly#Gutscheine) an und löse diesen unter [membership.bstly.de](https://membership.bstly.de) ein. Nach Genehmigung des Antrages bekommst du wieder eine E-Mail zum einlösen des Token für deinen Account. Nachdem du das Token eingelöst hast ist der Zugang für dich aktiviert. + +## Basis Anleitung zu Git {#Git} + +T.B.D. \ No newline at end of file diff --git a/services/matrix.md b/services/matrix.md new file mode 100644 index 0000000..60c56c3 --- /dev/null +++ b/services/matrix.md @@ -0,0 +1,17 @@ +--- +title: Matrix +description: +published: true +date: 2021-03-21T18:48:53.718Z +tags: +editor: markdown +dateCreated: 2021-03-19T10:38:23.948Z +--- + +# Nutzung von Matrix + +> Dieser Artikel ist unvollständig und kann von \_Bastler mangels Expertise nicht verfasst werden. Falls du Erfahrung mit diesem Thema hast, überarbeite bitte diesen Artikel! +{.is-danger} + +Zur Nutzung des Dienstes *Matrix* empfiehlt sich die Installation einer App wie [Element](https://element.io/get-started). Als Serveradresse muss [matrix.bstly.de](https://matrix.bstly.de) eingetragen weren. Der Login erfolgt über SSO mit deinem *we.bstly*-Account. Die Web-Version wird ebenfalls von uns gehostet und ist unter [element.bstly.de](https://element.bstly.de) erreichbar. + diff --git a/services/nextcloud.md b/services/nextcloud.md new file mode 100644 index 0000000..a8edc3a --- /dev/null +++ b/services/nextcloud.md @@ -0,0 +1,87 @@ +--- +title: Nextcloud +description: +published: true +date: 2021-03-22T08:16:56.206Z +tags: +editor: markdown +dateCreated: 2021-03-19T10:37:56.210Z +--- + +# Nutzung von Nextcloud + +Die Kernfunktion von [Nextcloud](https://www.nextcloud.com) liegt im Speichern und Synchronisieren von Dateien. Da Nextcloud aber durch Erweiterungen (*Apps*) weitaus mehr Funktionen bietet, findest du hier Anleitungen zu allen installierten Apps. Die meisten Features sind vor allem nützlich im Zusammenspiel mit installierten Anwendungen auf deinem Rechner oder deinem Smartphone. Alle Funktionen sind jedoch auch über die Weboberfläche unter [nc.bstly.de](https.//nc.bstly.de) erreichbar. Ausführliche Anleitungen findest du auch direkt unter [docs.nextcloud.com](https://docs.nextcloud.com/server/latest/user_manual/en/webinterface.html) \[english\]. Die deutsche Version ist leider nicht aktuell, weswegen hier auf die englische Dokumentation verwiesen wird. + +## Dateien {#Dateien} + +Wie erwähnt ist der Dateispeicher die Hauptfunktion von Nextcloud. Wie dein ganz normales Dateisystem kannst du dort deine Dateien in hierarchische Ordnerstrukturen ablegen. + +### Synchronisation {#Dateisync} + +Am meisten Sinn macht der Dateispeicher erst durch die Installation des [Desktop-Clients](https://nextcloud.com/install/#install-clients) auf deinem Rechner. Dadurch werden die Dateien automatisch zwischen deinem Computer und dem Server synchronisiert. Nach der Installation musst du [nc.bstly.de](https.//nc.bstly.de) als Serveradresse eintragen. Es öffnet sich ein Browserfenster mit der Login-Maske, wähle hier **we.bstly Login** aus um dich mit deinem *we.bslty*-Account einzuloggen. + +Die Installation eines [Mobile-Clients](https://nextcloud.com/install/#install-clients) für dein Smartphone ist ebenfalls möglich. Die Einrichtung läuft analog zum Desktop-Client, beachte nur, dass hier nicht automatisch alle Dateien synchronisiert werden, sondern zunächst nur eine Ansicht der Dateien auf dem Server erscheint. Die Synchronisation auf deinem Handyspeicher kannst du dann individuell auch nur für einzelne Ordner oder Dateien festlegen. + +### Teilen {#Teilen} + +Komplette Ordner oder einzelne Dateien kannst du auch mit anderen teilen. Über das Teilen Icon in der Weboberfläche oder im Client hast du die Auswahl zwischen zwei Arten: +- Teilen mit anderen Nextcloud-Usern über Namen, E-Mail, Gruppen oder anderen Nextcloud-Instanzen +- Teilen über einen Link + +Im Teilen-Dialog hast du die Möglichkeit die gewünschten Berechtigungen sowie einige weitere Einstellungen zu setzen. So kannst du einstellen ob die Datei(en) nur gelesen, bearbeitet, gelöscht oder neue Dateien erstellt werden können. Die Freigabe kann zusätzlich zeitlich befristet sein. Beim Teilen über einen Link hast du zudem die Möglichkeit die Freigabe mit einem Passwort zu schützen oder einen sogenannten *Filedrop* über die Funktion *Dateien ablegen* einzurichten. So können Dritte über den Link zwar selbst Dateien hochladen, aber haben keinen Zugriff auf vorhandene Dateien. + +## Kalender {#Kalender} + +Ähnlich zur [Datei](#Dateien)-Funktion erweist sich die Kalender-App durch die Synchronisation und das Teilen als besonders nützlich. Die Grundfunktion ist eine Kalender-Übersicht in der du mehrere Kalender und entsprechende Termine anlegen kannst. Durch Unterstützung von [CalDAV](https://de.wikipedia.org/wiki/CalDAV) ist eine Synchronisation über mehrere Geräte möglich. Entsprechende Anleitungen findest du in der [Nextcloud-Doku](https://docs.nextcloud.com/server/latest/user_manual/en/pim/index.html) \[english\]. Du kannst einzelne Kalender auch mit anderen Teilen, entweder nur lesend oder auch mit der Option anderen Schreibrechte zu erteilen. Das öffentliche Teilen über einen Link ist ebenfalls möglich. + +## Kontakte {#Kontakte} + +Auch die Kontakte-App hat ihre Kernfunktion in der Synchronisation. Nach der [Einrichtung](https://docs.nextcloud.com/server/latest/user_manual/en/pim/index.html) \[english\] auf deinem Smartphone werden deine Kontakte automatisch synchronisiert. So hast du stets ein Backup von deinen gesammelten Kontakten. So sparst du dir manuelles Kopieren oder die Weitergabe deines Adressbuchs an andere Cloud-Anbieter. Du kannst deine Kontakte auch zusätzlich in verschiedenen Adressbüchern organisieren. + +## Collabora Online {#Collabora} + +[Collabora Online](https://www.collaboraoffice.com/) ist der Name der Online Version von [LibreOffice]( https://www.libreoffice.org/). Zusätzlich dazu, dass du mit *LibreOffice Online* schon eine komplette Office-Suite für Textverarbeitung, Tabellenkalkulation und Präsentationen direkt in deinem Browser hast, bietet die App kollaboratives Arbeiten an den Dokumenten an. Du kannst also mit anderen Benutzern gleichzeitig die Dokumente bearbeiten, ganz ähnlich zu z.B. *Google Docs*. *Collabora Online* ist auch in die [mobilen Clients](https://nextcloud.com/install/#install-clients) integriert, sodass du dir direkt an deinem Smartphone die Dokumente anschauen oder Änderungen durchführen kannst. Da die Dateien im [OpenDocument](https://de.wikipedia.org/wiki/OpenDocument)-Format gespeichert werden, sind sie natürlich komplett kompatibel zu den Desktop-Anwendungen wie *LibreOffice*. + +## Zusätzliche Apps {#Weitere} + +Weitere installierte Apps sind hier nur zusammenfassend beschrieben, da die Funktionen entweder einfache Integration oder durch die Nutzung selbsterklärend sind. + +### Text {#Text} + +Neben einfachen Bearbeiten von Textdateien bietet der integrierte Text-Editor auch kollaboratives, also gleichzeitiges, Bearbeiten von mehreren Benutzern. + +### Deck {#Deck} + +Deck bietet Projekt- und Aufgaben-Organisation über [Kanban-Boards](https://de.wikipedia.org/wiki/Kanban-Tafel). Du kannst diese für dich persönlich Nutzen aber auch mit anderen Benutzern teilen und zusammen nutzen. Für *Android* Smartphones gibt es auch eine [kompatible App](https://github.com/stefan-niedermann/nextcloud-deck). + +### Umfragen {#Umfragen} + +Einfaches erstellen von Datumsumfragen ähnlich zu Diensten wie *Doodle* und einfache Textumfragen. Umfragen können sowohl intern mit anderen Benutzern aber auch öffentlich über einen Link geteilt werden. + +### Aufgaben {#Aufgaben} + +Das einfache Aufgaben-Management wird in die [Kalender-App](#Kalender) integriert, so dass über *CalDAV* eine Synchronisation mit anderen Geräten und mobile Apps möglich ist. + +### Formulare {#Formulare} + +Mit *Formulare* kannst du etwas ausgiebigere Umfragen erstellen. + +### Fotos {#Fotos} + +Eine Galerie-Ansicht für Fotos in deinen [Datei](#Dateien)-Speicher. + +### Tags {#Tags} + +Du kannst Dateien und Ordner mit sogenannten *Tags* also Schlagwörtern versehen um Dateien über Ordnerstrukturen hinaus zu organisieren. + +### Kommentare {#Kommentare} + +Die Kommentarfunktion bietet sich natürlich nur an, wenn du Dateien oder Ordner mit [anderen teilst](#Teilen). + +### PDF Viewer {#PDF} + +Kleine Erweiterungen um PDF Dateien direkt im Browser zu öffnen. + +### Video-Player {#Video} + +Kleine Erweiterungen um Video Dateien direkt im Browser abzuspielen. \ No newline at end of file diff --git a/services/partey.md b/services/partey.md new file mode 100644 index 0000000..2477eab --- /dev/null +++ b/services/partey.md @@ -0,0 +1,76 @@ +--- +title: Partey +description: +published: true +date: 2021-03-24T07:30:04.649Z +tags: +editor: markdown +dateCreated: 2021-03-15T04:43:03.718Z +--- + +# Nutzung von Partey + +Hier findest du alle Informationen zur Nutzung unseres virtuellen Vereinsheims. + +## Features {#Features} + +Partey basiert auf der Software [Workadventure](https://workadventu.re). Hier findest du eine Übersicht über die Kernfeatures von *Workadventure*: +- Treffe andere Benutzer in einer frei begehbaren 2D-Welt +- Bis zu vier Benutzer in der Nähe werden automatisch zu einem Videochat zusammengeschaltet +- An bestimmten Stellen gibt es [besondere Bereiche](#Bereiche) mit erweiterten Funktionen + +## Start {#Start} + +Hier findest du eine kleine Einführung zur Benutzung von Partey. + +> Du wirst sehr wahrscheinlich schon direkt zu Beginn von deinem Browser gefragt, ob du der Seite den Zugriff auf deine Kamera und dein Mikrofon erlauben möchtest. Zur Nutzung der Videochat-Funktion ist die Freigabe von Kamera und Mikrofon natürlich unverzichtbar. Wenn du mehr den Datenschutz des Dienstes erfahren möchtest, kannst du dich [hier](/de/privacy#Partey) informieren. +{.is-info} + +> Du begibst dich in eine interaktive Welt wo du anderen Benutzern begegnest. Benötigst du Hilfe schaue bitte unsere [Hilfsangebote](/de/help) an. +:camera: Außerdem gilt unsere Fotopolicy: Möchtest du Bilder oder Screenshots machen, bitte alle im Bild vorher um Erlaubnis. +{.is-warning} + + +### Avatar auswählen {#Avatar} + +Zu Beginn kannst du dein Avatar auswählen. Neben einer kleinen Auswahl vorkonfigurierter Avatare gibt es einen ausgiebigen Editor in der du dein Avatar individuell gestalten kannst. Mit den vier Richtungstasten :arrow_left:,:arrow_up:,:arrow_down:,:arrow_right: kannst du zwischen den verschiedenen Ebenen umschalten. Mit der *Entertaste* bestätigst du deine Auswahl. + +![Screenshot der Avatarauswahl](/partey/prty_avatar.png =300x) + +### Kamera und Mikrofon auswählen {#Kamera+Mikrofon} + +Im folgendem Bildschirm siehst du eine Vorschau auf deine ausgewählte Kamera und dein Mikrofon. Hast du mehrere Geräte an deinem System zur Auswahl kannst du hier erneut mit den Pfeiltasten zwischen deiner Kamera :arrow_right:, :arrow_left: und deinem Mikrofon :arrow_down:,:arrow_up: umschalten. Erneut deine Auswahl mit der *Entertaste* bestätigen. + +### Steuerung {#Steuerung} + +Dein Avatar bewegst du einfach mit den vier Richtungstasten :arrow_left:,:arrow_up:,:arrow_down:,:arrow_right: oder mit *W*,*A*,*S*,*D* über die Karte. Mit der *Shiftaste* kannst du dein Avatar schneller bewegen. An bestimmten Stellen können [besondere Bereiche](#Bereiche) manuell durch drücken der *Leertaste* aktiviert werden. Die Stellen werden durch ein animiertes Pop-Up am unteren Bildschirmrand markiert: +![prty_action1.png](/partey/prty_action1.png) ![prty_action2.png](/partey/prty_action2.png) + +### Videochat {#Videochat} + +Der Videochat startet automatisch sobald ein anderer Avatar in deiner Nähe verweilt. Durch einen weißen Kreis wird der aktive Videochat-Bereich markiert. Du hast zusätzlich die Möglichkeit deinen Bildschirm zu teilen. Außerdem kannst du natürlich jederzeit dein Video oder Mikrofon deaktivieren. + +## Besondere Bereiche {#Bereiche} + +Bestimmte Bereiche auf der Karte haben besondere Funktionen. Manche aktivieren oder öffnen sich automatisch, andere können manuell aktiviert werden, siehe dazu [Steuerung](#Steuerung). + +### Jitsi-Räume {#Jitsi} + +Um Videochat für mehr als vier Personen zu ermöglichen, gibt es bestimmte Bereich in denen ein [Jitsi](/de/services#jitsi)-Raum in einer Hälfte des Browserfensters geöffnet wird. Eventuell musst du erneut deine Kamera und dein Mikrofon freigeben. In unserem Vereinsheim werden die meisten Jitsi-Räume erst nach manueller Aktivierung geöffnet. + +### eingebettete Webseiten {#Webseiten} + +Ähnliche wie Jitsi-Räume können an bestimmten Stellen Webseiten in einer Browser-Hälfte geöffnet werden. Es werden keine Daten des Dienstes an diese Seiten übertragen! + +### Audiostreams {#Audio} + +An bestimmten Stellen starten automatisch Audiodateien oder Audiostreams. Die Lautstärke kann über ein kleines Kontrollfenster am oberen Bildschirmrand kontrolliert werden. +![prty_audio.png](/partey/prty_audio.png) + +### Stille Bereiche {#Stille} + +In stillen Bereichen ist der [Videochat](#Videochat) automatisch deaktiviert. Aktuell werden diese Bereiche leider nicht besonders markiert oder hervorgehoben, so dass die Funktion nur über die Gestaltung der Karte erkennbar ist. + +## Eigene Karte erstellen {#Karte} + +Du kannst deine eigene Karte direkt in *Partey* einbinden. Dazu gibt es eine extra [Anleitung im Wiki](/de/services/partey/map). Eine allgemeine Anleitung zum Erstellen von eigenen Karten findest du [hier](https://workadventu.re/map-building) \[english\]. diff --git a/services/partey/map.md b/services/partey/map.md new file mode 100644 index 0000000..f097964 --- /dev/null +++ b/services/partey/map.md @@ -0,0 +1,70 @@ +--- +title: Partey Map +description: +published: true +date: 2021-03-22T19:07:59.535Z +tags: +editor: markdown +dateCreated: 2021-03-21T17:00:04.415Z +--- + +# Eigene Karte erstellen + +Um eine eigene Karte zu erstellen folgst du einfach der [Anleitung von Workadventure](https://workadventu.re/map-building) \[english\]. Nachdem du deine Karte erstellt hast, kann die Karte automatisch in [Partey](/de/services/partey) eingebunden werden. Die genauen Schritte dazu werden hier erklärt. + +## Karte für Partey vorbereiten {#Vorbereitung} + +Workadventure funktioniert nur mit `.json`-Maps. Exportiere also deine Karten ins JSON-Format oder speichere diese direkt als JSON ab. + +> Es findet keine Überprüfung auf Korrektheit deiner Karte statt. Fehlt also die `main.json` oder der `start`-Layer, ist die `exitUrl` falsch angegeben oder ein *Tileset* nicht korrekt werden andere Benutzer mit diesen Fehlern direkt konfrontiert. +{.is-info} + +### Einsteigspunkt {#Einstiegspunkt} + +Der Einstiegspunkt in deine Karte ist automatisch immer die `main.json`. Benenne also deine Startmap in `main.json` um. Vergiss nicht den `start`-Layer zu setzen. + +### Exit-Layer {#ExitLayer} + +Der [Austiegspunkt](https://workadventu.re/map-building/entry-exit#defining-exits) zurück in das *virtuelle Vereinsheim* ist immer über folgende `exitUrl` erreichbar: `../../member.json#start_{username}`. Ersetze `{username}` natürlich noch mit deinem Usernamen. + +Beispiel für den User *foobar*: `../../member.json#start_foobar`. + +### Beispiel Karte {#Beispiel} + +Als Beispiel für eine eigene Karte kannst du dir die Map von [Lurkars](https://we.bstly.de/p/Lurkars) unter [git.bstly.de/Lurkars/prty-map](https://git.bstly.de/Lurkars/prty-map) anschauen. + +## Karte in Partey einbinden {#Einbinden} + +Damit die Karte automatisch eingebunden werden kann, muss die Karte in einem Git-Repository liegen und die URL über dein [we.bstly-Profil](/de/services/webstly#Profil) angegeben sein. Über das Repository wird die Karte automatisch zur *Partey*-Karte hinzugefügt und in einem regelmäßigen Intervall aktualisiert. Du kannst also jederzeit deine Karte durch Änderungen in deinem Repository aktualisieren. + +### Git-Repository {#Git} + +Ein Git-Repository bekommst du entweder über unseren [Gitea](/de/services/gitea) Dienst oder bei verschiedenen kostenlosen Anbietern wie [GitHub](https://github.com/), [GitLab](https://gitlab.com/) oder [Bitbucket](https://bitbucket.org/). Eine schnelle Anleitung für den Einstieg in Git findest du [hier](https://rogerdudler.github.io/git-guide/index.de.html). Die verschiedenen Dienste wie [Gitea](/de/services/gitea) erklären die Einrichtung beim erstellen eines neuen Repositories aber meistens auch. Hier eine schnelle Auflistung der wichtigstens Befehle wenn du dein Repsoritory erfolgreich eingerichtet hast: +``` +# Änderungen und neuen Dateien hinzufügen +git add . +# Änderungen übernehmen +git commit -m "Text über deine Änderungen" +# Änderungen hochladen +git push +``` + +> Manche Dienste bennen den Hauptzweig eines neuen Repositories oft mit *master*. Wir empfehlen für den Hauptzweig eine andere Bezeichung wie z.B. **main** zu wählen, siehe [Code ohne Rassismus](https://www.golem.de/news/black-lives-matter-code-ohne-rassismus-2006-149032.html) \[Golem\]. +{.is-info} + + +#### Zugriff {#Zugriff} + +Wenn dein Repository öffentlich ist, reicht es den http-Link in dein [Profil](#Profil) einzutragen. Möchtest du gerne ein nicht öffentliches Repository verwenden, musst du für folgenden [Öffentlichen Schlüssel](/partey/workdadvenutekey.pub) Lesezugriff gewähren und den ssh-Link in dein [Profil](#Profil) übernehmen. + +### Repository-Url zum Profil zufügen {#Profil} + +Füge eine [neues Profilfeld](/de/services/webstly#Profil) vom Datentyp **URL** mit dem Namen **prtyMap** deinem Account hinzu und trage als Link einfach die URL zu deinem Repository ein. Das Profilfeld kann auch auf *Privat* gestellt sein. + +> Änderungen der Repository URL werden ignoriert! Das Repository wird einmalig hinzugefügt und dann nur noch geupdated. Möchtest oder musst du die URL ändern, [lösche](#Löschen) bitte deine Karte und warte eine Weile, bis deine Karte auch wirklich entfernt wurde. Anschließend kannst du eine neue URL eintragen. +{.is-warning} + + +## Karte löschen {#Löschen} + +Du kannst natürlich auch jederzeit deine Karte wieder aus *Partey* entfernen. Dazu musst du nur das Profilfeld **prtyMap** löschen. Im nächsten Update-Intervall wird die Karte dann automatisch vom Server und aus der *Partey*-Karte entfernt. \ No newline at end of file diff --git a/services/planned.md b/services/planned.md new file mode 100644 index 0000000..27e5b2b --- /dev/null +++ b/services/planned.md @@ -0,0 +1,63 @@ +--- +title: Geplante Dienste +description: +published: true +date: 2021-03-21T11:31:13.910Z +tags: +editor: markdown +dateCreated: 2021-03-14T12:57:31.654Z +--- + +# Geplante Dienste und Ideen + +Hier findest du eine Übersicht über geplante Dienste und/oder Ideen. Die Dienste/Ideen sind mit folgenden Symbolen markiert um den aktuellen Status wiederzugeben: +* ✅ fertig, benötigt nur Finanzierung +* ❔ noch nicht fertig +* ⚠️ noch nicht konkret/technische Hürden + +## Dienste + +### Wireguard ⚠️ {#wireguard} + +Ein VPN Server bietet zum einen den Vorteil, dass deine echte IP-Adresse verschleiert wird, zum anderen würde ein VPN uns ein paar technische Möglichkeiten bieten, da du dich als User dann in einem internen Netzwerk befindest, worüber wir weitere Dienste oder Zugriffe auf bestimmte Dienste ermöglichen können. + +Da natürlich sehr viel Traffic über den Server läuft wenn viele User im VPN sind, wird aktuell ein Hybrid-Betrieb bevorzugt. Dies bedeutet dass du zwar weiterhin mit deiner eigenen IP direkt auf das Internet zugreifst, wir aber eben durch das interne Netzwerk weitere Services zur Verfügung stellen können. + +> ⚠️ In der Theorie ist das Aufsetzen des Servers kein Problem. Da die Authentifizierung über ein Public-Private-Key Verfahren läuft, bräuchte es eigentlich nur ein kleines Script um den Public-Key eines Users zur Konfiguration hinzuzufügen (oder zu entfernen). Das Szenario muss allerdings noch von \_Bastler verifiziert und getestet werden. +{.is-warning} + +### Pi-Hole ❔ {#pihole} + +Werbeblocking über DNS bietet einige Vorteile gegenüber klassischem Ad-Blocking über Browser-Plugins. Da das Request als solches blockiert wird, bekommt der Werbeserver nicht einmal mit, dass er gerade blockiert wird. Außerdem funktioniert so ein Blocking dann für alle Geräte, Applikation usw. die auf das Internet zugreifen. So wird auch Werbung und Tracking in mobilen Anwendungen blockiert. + +> ❔ Pi-Hole selber einzurichten ist kein Problem. ⚠️ Allerdings würde eine offene Konfiguration für jeden zugänglich sein, so dass Serverlasten nicht kontrollierbar wären. Deshalb ist die Idee von \_Bastler, den Service über ein VPN ([Wireguard ⚠️](#wireguard)) zur Verfügung zu stellen. So ist Pi-Hole immer aktiv, sobald du eine gültige VPN Verbindung zu unserem Server hast. +{.is-info} + +### Bitwarden ⚠️ {#bitwarden} + +Ein Passwort Manager verwaltet sicher all deine Passwörter. Außerdem kannst du dir komplizierte Passwörter generieren lassen, so dass du für all deine Konten ein anderes, schwer zu erratendes Passwort hast und die Sicherheit deiner Konten erhöhst. + +Bitwarden empfiehlt sich vor allem durch seine regelmäßigen unabhängigen Audits mit positiven Ergebnissen. Es gibt kaum vergleichbare Alternativen in selbst betriebenen Open-Source Password Managern. + +> ⚠️ Aktuell bietet Bitwarden leider OIDC Unterstützung nur für eine bezahlte Premium Lizenz. Es gibt einen offenen [Rust-Klon](https://github.com/dani-garcia/bitwarden_rs) der Server Komponente, diese legt aber aktuell wenig Wert auf die Unterstützung des Organisationen-Feature und damit auf das damit verbundene OIDC. Somit bleibt abzuwarten, ob sich hier in nächster Zeit etwas entwickelt oder ob etwas für den Einsatz einer Alternative spricht. +{.is-warning} + +### BigBlueButton ⚠️ {#bbb} + +BigBlueButton ist ein mächtiges Konferenz-Tool, dass für den Einsatz an Schulen konzipiert wurde. Dadurch bietet es einen großen Umfang an Funktionen um viele denkbare Konferenz-Situationen abzubilden. Gerade aus Sicht der Bastelei und des Vereins bietet ein solches Tool Vorteile um größere Online-Konferenzen zu organisieren oder z.B. eine Mitgliederversammlung abzuhalten. + +> ⚠️ Größerer Umfang an Funktionen bringt große Komplexität mit sich. Aktuell wird für BBB empfohlen einen eigenständigen Server zu verwenden. Hinzu kommen einige Sicherheitsbedenken, da die empfohlenen Systemvoraussetzungen veraltet sind. Außerdem bietet BBB derzeit auch keine OIDC-Unterstützung, was zusätzlich das Thema der Authentifizierung mit sich bringt. +{.is-warning} + +## Ideen + +### Mini-Server für Mitglieder ❔ {#mini-server} + +Auf Basis eines [Raspberry Pi](https://www.raspberrypi.org/) kann jeder auch Dienste im Kleineren selber hosten. LouisFabu betreibt so zum Beispiel mit Hilfe von \_Bastler [Nextcloud](/de/services#nextcloud) und [Pi-Hole](#pihole) Zuhause. Die Idee wäre hier vorkonfigurierte Hardware mit Festplatte anzubieten, die entweder für Interessierte in Eigenregie oder von \_Bastler via Fernzugriff verwaltet werden kann. + +Die Vorteile Nextcloud und Pi-Hole selber zu betreiben liegen vor allem darin, dass der Speicherplatz weniger limitiert ist, zum anderen das man noch mehr Kontrolle über seine eigenen Daten hat. Außerdem kann der Zugriff lokal viel schneller erfolgen, was Backups von größeren Dateien beschleunigt. + +Durch Föderation von Nextcloud und einer VPN Anbindung kann der Zusammenschluss von mehreren Mini-Servern auch für andere Nutzer von Vorteil sein. So kann man sich z.B. gegenseitig Speicher für Backups anbieten um Redundanz zu erzeugen. + +> ❔ Das generelle Setup mit einem Raspberry Pi ist bereits erprobt. Fehlende Schritte sind zum einen konkrete Auswahl von Hardware um ein fertiges Paket anzubieten, sowie die automatisierte Konfiguration des Systems. ⚠️ Nicht getestet sind bisher die Aspekte der Förderation und die VPN ([Wireguard ⚠️](#wireguard)) Anbindung. Außerdem sind genaue Fragen über Anforderungen wie Fernwartung oder die verschiedenen Expertisen, die zur Selbstverwaltung nötig sind, ungeklärt. +{.is-info} \ No newline at end of file diff --git a/services/pretix.md b/services/pretix.md new file mode 100644 index 0000000..109a0d6 --- /dev/null +++ b/services/pretix.md @@ -0,0 +1,46 @@ +--- +title: Pretix +description: +published: true +date: 2021-03-22T19:29:42.135Z +tags: +editor: markdown +dateCreated: 2021-03-19T07:42:03.337Z +--- + +# Nutzung von Pretix + +Da Pretix primär zur Verwaltung deiner Vereinsmitgliedschaft genutzt wird, ist hier eine kleine Anleitung, wie du deine Mitgliedschaft beantragst, bezahlst und deine Stammdaten ändern kannst. + +## Mitgliedschaft {#Mitgliedschaft} + +> Da Pretix als Ticket-System für Events entwickelt wurde, ist Pretix wie ein Online-Shop aufgebaut und an einigen Stellen ist von Ticket, Veranstalter etc. die Rede. Einfach durch die Begrifflichkeiten nicht irritieren lassen, sondern die Mitgliedschaft einfach als *Ticket* für die Veranstaltung *Bastelei e. V.* vom Veranstalter *Bastelei e. V.* betrachten. +{.is-info} + +### Antrag {#Antrag} + +Um deinen Antrag auf Mitgliedschaft auszufüllen gehe einfach auf [membership.bstly.de](https://membership.bstly.de/). Dort siehst du unter der Kategorie **Vereinsmitgliedschaft** das Item **Mitgliedschaft** ausgewählt. Falls das Item nicht ausgewählt ist, setze dort einfach einen Haken. Anschließend klickst du auf **Zum Warenkorb hinzufügen** und auf der nächsten Seite direkt auf **Zur Kasse**. Nun werden ein paar Stammdaten abgefragt: +* **E-Mail** Bitte gebe eine gültige E-Mail Adresse an damit du E-Mails vom System empfangen kannst um über den Status deines Antrages informiert zu werden. +* **Vorname**, **Nachname**, **Straße**, **Hausnummer**, **Postleitzahl**, **Stadt** Deine Adresse wird zur Mitgliederverwaltung benötigt, außerdem können wir dich so auch postalisch erreichen. +* **Außerhalb von Deutschland** Setzte hier nur ein Häkchen, wenn sich dein Wohnsitz außerhalb von Deutschland befindet. Anschließend kannst du ein Land auswählen. + +Nachdem du auf **Fortfahren** geklickt hast, findest du noch einmal eine Übersicht über deine angegebenen Daten. Wenn alle Daten korrekt sind nur noch auf **Zahlungspflichtig bestellen** klicken und du müsstest sehr bald eine Bestätigung über deinen erfolgreichen Antrag in deinem E-Mail Postfach finden. + +Da eine Mitgliedschaft durch den Vorstand genehmigt werden muss, musst du nun ein wenig Geduld haben. Sobald dein Antrag angenommen wurde, wirst du per E-Mail darüber informiert. + +### Zahlung deines Jahresbeitrages {#Jahresbeitrag} + +Wurde dein Antrag angenommen, kommst du über den Link in der E-Mail erneut auf die Seite für deine Bestellung. Deine Mitgliedschaft beginnt erst mit erfolgreicher Zahlung deines Jahresbeitrages. Klicke dazu einfach auf **Jetzt bezahlen** und wähle anschließend **Banküberweisung** aus. Die Zahlungsinformation werden dir schon angezeigt, klicke bitte trotzdem noch einmal auf **Fortfahren** und anschließend auf **Jetzt Bezahlen**. Auf der Übersichtsseite wird dir weiterhin die Bankverbindung und der Verwendungszweck angezeigt. Nachdem du den Betrag auf unser Konto überwiesen hast, kann es noch bis zu einer Woche dauern, bis die Zahlung im System angekommen ist. Nach Zahlungseingang wirst du umgehend per E-Mail informiert. Die E-Mail enthält auch schon direkt deinen Link zur [Registrierung deines we.bstly-Accounts](/de/services/webstly). + +> Aktuell bieten wir neben der Banküberweisung keine weiteren Zahlungsmethoden an, da wir uns nicht von Anbietern wie *PayPal* abhängig machen wollen. +{.is-info} + + +### Verlängerung der Mitgliedschaft {#Verlängerung} + +Vier Wochen vor Ablauf deiner Mitgliedschaft wird für dich automatisch eine Verlängerung eingestellt. Du bekommst also automatisch eine E-Mail an deine beim [Antrag](#Antrag) hinterlegte Adresse mit einer Zahlungsaufforderung. Möchtest du deine Mitgliedschaft auslaufen lassen, kannst du diese E-Mail einfach ignorieren und deine Mitgliedschaft endet mit dem Kalenderjahr. Ansonsten läuft der Zahlungsvorgang wieder wie oben beschrieben ab. + +## Stammdaten ändern {#Stammdaten} + +> Das ändern von deinen Stammdaten ist leider aktuell nicht umgesetzt. Der genaue Prozess muss noch entiwckelt werden. +{.is-warning} diff --git a/services/webstly.md b/services/webstly.md new file mode 100644 index 0000000..923e18a --- /dev/null +++ b/services/webstly.md @@ -0,0 +1,96 @@ +--- +title: we.bstly +description: +published: true +date: 2021-03-24T07:37:49.886Z +tags: +editor: markdown +dateCreated: 2021-03-19T07:42:12.380Z +--- + +# Nutzung von we.bstly + +Voraussetzung zur Nutzung ist eine aktive Vereinsmitgliedschaft. Falls du noch keine Mitgliedschaft beantragt hast, schaue doch erst unter [Mitgliedschaft](/de/services/pretix#Mitgliedschaft) rein. + +## Registrierung {#Registrierung} + +Nach erfolgreichem Abschluss deiner [Mitgliedschaft](/de/services/pretix#Mitgliedschaft) erhältst du eine E-Mail mit einem Link zum Einlösen deines Token. Auf der [Token](https://we.bstly.de/tokens)-Seite wird dir aufgelistet welches Token du eingelöst hast und welche Dienste und Quotas damit verbunden sind. Klicke nun auf den **Registrieren** Button um deinen Account anzulegen. + +Auf der Registrierungs-Seite musst du lediglich deinen Usernamen und dein Passwort festlegen. Optional kannst du noch eine andere primäre E-Mail Adresse anlegen. So bekommst du z.B. Systembenachrichtigungen an die angebende E-Mail Adresse und nicht an deine *@we.bstly.de* Adresse. + +> Aktuell hat die Angabe einer primären E-Mail Adresse keine weitere Funktion. Später wird es auch die Möglichkeit geben über deine externe E-Mail Adresse dein Passwort zurückzusetzen. Du kannst auch im Nachhinein eine primäre Adresse über dein [Profil](#Profil) hinzufügen. +{.is-info} + +Nach erfolgreicher Registrierung öffnet sich noch ein Dialog mit einer Übersicht über deine Daten und mit deinem [Privaten Schlüssel](#privatekey). + +### Privater Schlüssel {#privatekey} + +Für jeden Benutzer wird (clientseitig) ein *Öffentlicher* und ein *Privater* [PGP](https://de.wikipedia.org/wiki/Pretty_Good_Privacy) *Schlüssel* generiert. Der *Öffentliche Schlüssel* wird mit deinem Benutzer gespeichert. Dein *Privater Schlüssel* wird dir nur einmalig nach deiner Registrierung angezeigt. Deshalb ist es wichtig, dass du diesen Schlüssel sicher speicherst. Zum einen kannst du den Schlüssel als QR-Code scannen, z.B. mit einer Password-Manager App. Du kannst den Schlüssel in die Zwischenablage kopieren und sicher abspeichern oder direkt als Datei herunterladen. + +Aktuell wird der *Private Schlüssel* nur verwendet um deinen Account wiederherzustellen wenn du dein Passwort vergessen hast. +Verwenden andere Benutzer deinen *Öffentlichen Schlüssel* um dir verschlüsselte Daten zu senden, brauchst du natürlich deinen *Privaten Schlüssel* zur Entschlüsselung. + +Solange du Zugang zu deinem Account hast, kannst du deinen *Öffentlichen Schlüssel* austauschen in dem du einfach das entsprechende [Profilfeld bearbeitest](#Profil). + +## Token einlösen {#Token} + +Hast du weitere Token für zusätzliche Dienste oder Erweiterungen, kannst du diese ähnlich zur Registrierung einlösen. Nach Klick auf den Link aus der Bestätigungsmail oder der manuellen Eingabe des Token landest du in der gleichen Übersicht über verknüpfte Dienste und Quotas. Wenn du bereits eingeloggt bist brauchst du nur noch auf den **Token einlösen** Button klicken. Bist du noch nicht eingeloggt kannst du einfach den **Login** Button klicken und dich einloggen. Du wirst dann wieder zur Übersicht weitergeleitet. + +## Zweifaktor-Authentifizierung {#2FA} + +Du kannst deinen Login zusätzlich zu deinem Passwort auch mit einem zweiten Faktor absichern. Aktuell wird nur [TOTP](#TOTP) unterstützt. Eventuell kommen in Zukunft weitere Optionen hinzu. + +### TOTP {#TOTP} + +[TOTP](https://de.wikipedia.org/wiki/Time-based_One-time_Password_Algorithmus) ist ein standardisiertes Verfahren um offline einmalige Codes zu generieren. Um Zweifaktor-Authentifizierung mit TOTP zu aktivieren gehe auf [Account/Sicherheit](https://we.bstly.de/account/security). Mit Klick auf den Button **2FA (TOTP) einrichten** öffnet sich ein Dialog auf dem dir ein QR-Code angezeigt wird. Scanne den QR-Code mit einer [TOTP-App](#TOTPApps) und gebe den aktuellen TOTP-Code ein um die Aktivierung abzuschließen. + +#### Auswahl an TOTP Apps {#TOTPApps} + +| Name | Android | iOS | +| - | - | +| andOTP | :heavy_check_mark: | | +| FreeOTP | :heavy_check_mark: | :heavy_check_mark: | +| Authy | :heavy_check_mark: | :heavy_check_mark: | +| Google Authenticator | :heavy_check_mark: | :heavy_check_mark: | + +## Profil {#Profil} + +Zusätzlich zu deinem Usernamen gibt es auch die Möglichkeit Profilfelder zu speichern. Deine Profilfelder kannst du unter [Account/Profil](https://we.bstly.de/account/profile) erstellen, bearbeiten und löschen. Profilfelder können mehrere Zwecke erfüllen: +- Systemeinstellungen speichern z.B. die Verwendung einer anderen primären E-Mail Adresse (siehe [Registrierung](#Registrierung)) +- Informationen für dich selbst, andere Benutzer oder Dritte z.B. über deine private Homepage oder ein Infotext +- Einstellungen oder Parameter für andere Dienste z.B. ein Repository-Link zu deiner persönlichen [Partey-Karte](/de/services/partey/map) + +### Profilfeld Datentypen {#Profiltyp} + +Es stehen verschiedene Datentypen für Profilfelder zur Verfügung: +- **Textfeld** Freitextfeld auf 255 Zeichen beschränkt +- **Numerisch** Numerische Werte inkl. negative Fließkommazahlen +- **Datum** festes Datumsfeld +- **URL** gültiger Link +- **E-Mail** gültige E-Mail Adresse +- **Boolean** True/False oder An/Aus +- **BLOB** Freitextfeld ohne Beschränkung, auch für Binärdaten + +### Profilfeld Sichtbarkeit {#Profilsichtbarkeit} + +Es können drei verschiedene Sichtbarkeiten für Profilfelder eingestellt werden: +- **Privat** Private Profilfelder sind nur für dich und das System sichtbar +- **Geschützt** Geschützte Profilfelder sind auch für andere Benutzer sichtbar +- **Öffentlich** Öffentliche Profilfelder können zusätzlich auch von Dritten eingesehen werden + +### Index {#Profilindex} + +Du kannst den Profilfeldern eine Indexnummer zuweisen. In der Profilansicht werden die Felder nach diesem Index sortiert. + +### Profile anschauen {#Profilansicht} + +Du kannst dir Profile anderer Benutzer anschauen. Voraussetzung dafür ist, dass du den Usernamen des Benutzers kennst und der Benutzer geschützte oder öffentliche Profilfelder eingestellt hat. Folgende URL ruft das Profil für einen Benutzer auf: *we.bstly.de/p/{username}*. Ersetzte *{username}* einfach durch einen dir bekannten Usernamen. +> Es ist absichtlich keine Benutzer-Auflistung implementiert. Hat ein Benutzer keine öffentlichen oder geschützten Profilfelder wird der Zugriff ebenso verweigert wie wenn ein Benutzer gar nicht existiert. Dies verhindert eine Auflistung durch Ausprobieren. +{.is-info} + + +## Gutscheine {#Gutscheine} + +Unter [Account/Gutscheincodes](https://we.bstly.de/account/voucher) hast du die Möglichkeit Gutscheine für das [Pretix](/de/services/pretix)-System anzufordern. Aktuell ist die Möglichkeit Gutscheine zur Registrierung anzufordern deaktiviert. Du kannst allerdings Gutscheine für Add-Ons, sprich Erweiterungen generieren. + +Damit der Gutscheincode nicht deinem Account zugewiesen werden kann, wird dieser dir nur einmalig im Browser angezeigt. Nachdem du den Gutscheincode kopierst hast, kannst du ihn auf [membership.bstly.de](https://membership.bstly.de) einlösen und das gewünschte Item auswählen. Nach erfolgreichem Vorgang bekommst du wieder eine entsprechende E-Mail mit einem [Token zum einlösen](#Token). \ No newline at end of file diff --git a/services/wiki.md b/services/wiki.md new file mode 100644 index 0000000..38a315f --- /dev/null +++ b/services/wiki.md @@ -0,0 +1,13 @@ +--- +title: Wiki.js +description: +published: true +date: 2021-03-19T10:45:58.376Z +tags: +editor: markdown +dateCreated: 2021-03-19T10:45:56.931Z +--- + +# Nutzung von Wiki.js + +T.B.D. \ No newline at end of file