Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

merge First draft #2

Merged
merged 2 commits into from
Sep 18, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 32 additions & 10 deletions docs/alpakasso/forgot.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,45 @@
AlpakaSSO - Passwort vergessen
===

Hier Passwort Reset procedure erklären
Wenn du bereits einen AlpakaAuth Account (auch SSO Account genannt) besitzt, du aber dein Passwort nicht mehr weißt oder ein falsches in deinem Passwort Manager hinterlegt ist, kannst du dein Passwort erneuern.

Wenn du bereits einen AlpakaAuth Account (auch SSO Account genannt) besitzt, du aber dein Passwort nicht mehr weißt oder ein falsches in deinem Passwort Manager hinterlegt ist, kannst du dein Passwort neu einstellen.
Dafür brauchst du dein Anmeldenamen (das ist der, den du nicht mehr ändern kannst, nicht der, den andere sehen) und eine E-mail-Adresse, die in deinem Account hinterlegt ist. Das ist wahrscheinlich die E-Mail-Adresse, mit der du dich das erste mal Registriert hast.
Dafür brauchst du dein Anmeldenamen *(das ist der, den du nicht mehr ändern kannst, nicht der, den andere sehen)* und eine E-mail-Adresse, die in deinem Account hinterlegt ist. Das ist wahrscheinlich die E-Mail-Adresse, mit der du dich das erste mal registriert hast.

![Schitt 1,Passwort Vergessen Button](../assets/forgot/forgot1.png){width=300}


Im Anmeldemenü findest du unter dem Anmelden Button ein **Passwort vergessen** Button, wenn du auf den klickst, kommst du zur Passwort zurücksetzen Ansicht.


![Schritt 2, Anmeldenamen und E-Mail](../assets/forgot/forgot2.png){width=300}

Im Anmeldemenü findest du unter dem Anmelden Button ein "Passwort vergessen", wenn du darauf klicksty, kommst du zu einer neuen Meldung.

Dort kannst du dein Anmeldenamen und deine E-Mail Adresse eintragen. Wenn beides eingetragen ist, klickst du auf den "Passwort-Zurücksetzen-Mail versenden" Button.

Unabhängig davon, ob Anmeldename und E-Mail existieren und korrekt geschrieben sind, erscheint eine hellblaue Meldung, dass eine E-Mail gesendet wurde, wenn alles korrekt ist.
Erhälst du nach einigen Minuten keine E-Mail an die angegebene E-Mail Adresse schaue noch einmal im SPAM bzw. JUNK Ordner nach und überprüfe ob du Anmeldenamen und E-Mail-Adresse korrekt geschireben hast. Denke dara, dass der Anmeldenamen keine Großbuchstaben enthält. Ansonsten frage eine\*n Mentor\*in um Hilfe.
!!! note "Hinweis"
Wenn du dich an Anmeldenamen und E-Mail nicht mehr erinnern kannst, frage eine\*n Mentor\*in oder die Orga um hilfe.

![Schritt 3, Bestaetigungs Meldung](../assets/forgot/forgot3.png){width=300}

Sind beide ANgaaben korrekt und ein Account mit deinem Anmeldenamen und zugehöriger E-Mail regestriert erhálst du eine E-Mail von [email protected] mit dem Betreff Password reset.
Die E-Mail ist auf Englisch und ein Link, der mit TODOOOOOOOO beginnt, erlaubt dir dein Passwort innerhalb der nächsten zwei Tage zurück zu setzen. Schaffst du es in der Zeit nicht, musst du dir erneit unter "Passwort vergessen" eine E-Mail zusenden lassen.

Auch bei deinem neuen Passwort, gelten die Regeln vom Registrieren. Es muss mindestens 8 Zeichen lang sein. Du kannst Groß und Kleinbuchstaben verwenden, sowie Ziffern und verschiedene Sonderzeichen. Ä, Ö, Ü und andere Umlautbuchstaben wie Ñ funktionieren nicht. Auch nicht als Kleinbuchstaben :D.
Unabhängig davon, ob Anmeldename und E-Mail existieren und korrekt geschrieben sind, erscheint eine hellblaue Meldung, dass eine E-Mail gesendet wurde.
Erhälst du nach einigen Minuten keine E-Mail an die angegebene E-Mail Adresse schaue noch einmal im *Spam* bzw. *Junk* Ordner nach und überprüfe ob du Anmeldenamen und E-Mail-Adresse korrekt geschrieben hast.

!!! note "Hinweis"
Dein Anmeldenamen kann nur Zahlen und Kleinbuchstaben enthalten. Setzt dein hany zum Beispiel den ersten Buchstaben in einem Feld groß, musst du das korrigieren.

![Schritt 4, E-Mail](../assets/forgot/forgotMail.jpg){width=300}

Sind beide Angaben korrekt und ein Account mit deinem Anmeldenamen und zugehöriger E-Mail registriert erhälst du eine E-Mail von "noreply@jugendhackt."org" mit dem Betreff **Password reset**.
Die E-Mail ist auf Englisch und ein Link, der mit "https://auth.alpaka.space/self/token/password/" beginnt, erlaubt dir dein Passwort innerhalb der nächsten zwei Tage zurück zu setzen. Schaffst du es in der Zeit nicht, musst du dir erneut unter "Passwort vergessen" eine E-Mail zusenden lassen.

Nachdem du auf den Link geklickst hast, kannst du ein neues Passwort setzen.
Auch bei deinem neuen Passwort, gelten die Regeln, dass es mindestens 8 Zeichen lang sein muss, du Groß- und Kleinbuchstaben verwenden solltest, sowie Ziffern und verschiedene Sonderzeichen.
Ä, Ö, Ü und andere Umlautbuchstaben wie Ñ funktionieren nicht. Auch nicht als Kleinbuchstaben :D.
Falls du einen Passwort-Manager hast, lass dir ein Passwort generieren. Falls du keinen hast, aber gerne wüsstest, was das ist, frag in den kommenden Tagen gerne eine\*n Mentor\*in.

Wenn du dein neues Passwort zwei mal identisch eingegeben hast, kannst du es mit dem "passwort zurücksetzen" Button bestätigen. Eine hellblaue Bestätigungsmeldung taucht auf und dir wird Automatisch die generelle Anmeldemaske gezeigt.
![Schritt 5, neues Passwort](../assets/forgot/forgot5.png){width=300}


Wenn du dein neues Passwort zwei mal identisch eingegeben hast, kannst du es mit dem **Passwort zurücksetzen** Button bestätigen. Eine hellblaue Bestätigungsmeldung taucht auf und dir wird automatisch die Anmeldemaske gezeigt.
Du kannst dich mit deinem neuen Passwort und deinem Anmeldenamen direkt einloggen.
92 changes: 60 additions & 32 deletions docs/alpakasso/index.md
Original file line number Diff line number Diff line change
@@ -1,80 +1,108 @@
AlpakaSSO / uffd
===

Wilkommen bei Jugend hackt!
**Wilkommen bei Jugend hackt!**

Egal ob auf einem Event oder im Lab, wir haben verschiedene Tools bzw. Dienste um dir das zusammenarbeiten, basteln, oder auch nachsehen, wann was stattfindet, so einfach wie möglich zu machen.
Egal ob auf einem Event oder im Lab, wir haben verschiedene Tools beziehungsweise Dienste um dir das Zusammenarbeiten, Basteln, oder auch Planen, so einfach wie möglich zu machen.

Damit du dir nicht viele verschiedene Accounts und Passwörter merken musst, gibt es ein Zentrales Anmeldesystem. Das wird auch Single Sign On oder SSO genannt. Du wirst das immer wieder finden. Vielleicht auch unter einem der folgenden Namen: *Jugend hackt SSO*, *AlpakaSSO*, *AlpakaAuth*, *SSO*, *Single-Sign-On*, *uffd*, *OIDC*, *OAUTH(2)*
Für diese Anleitjngen versuchen wir bei *SSO* und *AlpakaAuth* zu bleiben.
Wenn du dich in dem System angemeldet hast, kannst du dadurch auf die meisten weiteren Tools zugreifen, die du im Lab oder auf einem Event benutzen wirst.

!!! note
!!! note "Hinweis"
Falls du noch keinen Link bekommen hast, um dich anzumelden, können dir die Mentor\*innen oder Orga weiterhelfen. Oft gibt es ein QR Code, den du abscannen kannst.

Wenn du den Link geöffnet hast, erscheint dir ein buntes Alpaka unter dem EINLADUNGSLINK steht.
Du hast zwei Optionen. Entweder einen neuen Account zu regestrieren, oder dich anzumelden.
Wenn du den Link geöffnet hast, erscheint dir ein buntes Alpaka unter dem **Einladungslink** steht.
Du hast zwei Optionen. Entweder einen neuen Account zu regestrieren, oder die Gruppe deinem Account hinzuzufügen.

Wenn du dir bereits einen Account angelegt hast, zum Beispiel, weil du bereits auf einem anderen Event warst, kannst du dich durch diesen Link einer neuen Gruppe hinzufügen. Du musst keinen neuen Account anlegen.
Dafür klickst du auf den Button "Anmelden und die Rollen zu deinem Account hinzufügen". Nachdem du dich mit deinem Anmeldenamen und Passwort angemeldet hast, bist du automatisch in den neuen Gruppen des Events oder Labs.
Hast du dein Passwort vergessen, kannst du es entweder selbstständig unter https://auth.alpaka.space/self/passwordreset zurücksetzen, oder Mentor\*innen sowie Orga um Hilfe fragen.
![Schritt 1, Regestrieren oder hinzufügen](../assets/new/new1.png){width=300}

Wenn du sicher weißt, dass du noch keinen Account hast, klickst du auf den oberen Button "Neuen Account regestrieren".
Wenn du dir bereits einen Account angelegt hast, zum Beispiel, weil du bereits auf einem anderen Event warst, kannst du dich durch diesen Link einer neuen Gruppe hinzufügen. *Du musst keinen neuen Account anlegen*.
Dafür klickst du auf den Button **Anmelden und die Rollen zu deinem Account hinzufügen**. Nachdem du dich mit deinem Anmeldenamen und Passwort angemeldet hast, bist du automatisch in den neuen Gruppen des Events oder Labs.
Hast du dein Passwort vergessen, kannst du es entweder selbstständig unter https://auth.alpaka.space/self/passwordreset zurücksetzen, oder Mentor\*innen sowie Orga um Hilfe fragen.

!!! note "Passwort zurücksetzen"
Hast du dein Passwort vergessen, kannst du es entweder selbstständig zurücksetzen [(Anleitung)](/alpakasso/forgot), oder Mentor\*innen sowie Orga um Hilfe fragen.
Wenn du sicher weißt, dass du noch keinen Account hast, klickst du auf den oberen Button **Neuen Account regestrieren**.


## Registrieren

Du kannst nur nun einen Namen aussuchen, mit dem du dich Anmelden kannst. Das kann dein Name sein, oder ein Spitzname, der dir gefällt. Dieser Name wird nicht von anderen Teilnehmenden gesehen, kann aber auch NICHT wieder geändert werden.
Dein Name kann aus Kleinbuchstaben (a-z) bestehen. Außerdem kannst du Zahlen (0-9) verwenden und Bindestriche (-) oder Unterstriche (\_). Was nicht funktioniert sind Großbuchstaben (A-Z) und Sonderzeichen wie \*. Du kannst dich also "cooles_alpaka2" nennen. "CoolesAlpaka:D" funktioniert nicht, da es Großnbuchstaben und Sonderzeichen enthält.
Du kannst dir nun einen Namen aussuchen, mit dem du dich anmelden möchtest. Das kann dein Name sein, oder ein Spitzname, der dir gefällt. Dieser Name wird nicht von anderen Teilnehmenden gesehen, kann aber auch **NICHT** wieder geändert werden.
Dein Name kann aus Kleinbuchstaben (a-z) bestehen. Außerdem kannst du Zahlen (0-9) verwenden und Bindestriche (-) oder Unterstriche (\_). Was nicht funktioniert sind Großbuchstaben (A-Z) und Sonderzeichen wie \* oder Emojis. Du kannst dich also "cooles_alpaka2" nennen. "CoolesAlpaka:D" funktioniert nicht, da es Großnbuchstaben und Sonderzeichen enthält.

!!! Warning "Einzigartiger Anmeldename"
Nachdem du einen Anmeldenamen eingegeben hast, kannst du mit dem Button **Überprüfen** kontrollieren, das der Name noch nicht vergeben ist. Wenn der Name grün umrandet wird, kannst du ihn verwenden. Ansonsten musst du dir einen neuen aussuchen.

![Schritt 2, Daten eingeben](../assets/new/new2.png){width=400}

Nachdem du einen Anmeldenamen eingegeben hast, kannst du mit dem Button "Überprüfen" kontrollieren, das der Name noch nicht vergeben ist. Wenn der Name grün umrandet wird, kannst du ihn verwenden. Ansonsten musst du dir einen neuen Ausdenken.
Danach gibt du in dem Feld "Anzeigename" ein, wie andere deinen Namen sehen wollen. Diesen Namen können auch andere Teilnehmende sehen und du kannst ihn *jederzeit* ändern. Außerdem kannst du hier auch Sonderzeichen und Großbuchstaben verwenden. "Cooles Alpaka" wäre jetzt möglich. Außerdem kannst du den gleichen Anzeigenamen wie jemand anderes haben. Es wäre also kein problem, wenn noch jemand deinen Vornamen hat, ihr den aber beide als euren Anzeigenamen nutzen wollt.

Danach gibt du in dem Feld "Anzeigename" ein, wie andere deinen Namen sehen wollen. Diesen Namen können auch andere Teilnehmende sehen und du kannst ihn jederzeit ändern. Außerdem kannst du hier auch Sonderzeichen und Großbuchstaben verwenden. "Cooles Alpaka 😎🦙" wäre anders als eben also möglich. Außerdem kannst du den gleichen Anzeigenamen wie jemand anderes haben. Also zum Beispiel auch wenn dein Vorname sehr häufig ist, du aber möchtest, das andere dich unter deinem Vornamen sehen, ist das möglich.

Bei deiner E-Mail-Adresse musst du eine Adresse angeben, auf die du Zugriff hast. Erst nachdem du deine E-Mail bestätigt hast, kannst du auf die verschiedenen Funktionen des SSO (das System für das du dich gerade Registrierst) zugreifen.
Insbesondere wenn du auf einem Event bist und nicht schnell nach Hause kannst, ist es also wichtig eine E-Mail Adresse zu benutzen, die zum Beispiel direkt von deinem Handy abbrufbar ist.
*Falls dir keine E-Mail Adresse zur Verfügung steht, sprich eine Mentor\*in an.*
!!! note "Hinweis"
Falls dir keine E-Mail Adresse zur Verfügung steht, sprich eine Mentor\*in an.

Als letztes brauchst du noch ein Passwort. Damit andere dein Passwort nicht direkt erraten können, solltest du nicht dein Benutzernamen oder dir wichtige Geburtstage oder Telefonnummern zu benutzen.
Als letztes brauchst du noch ein Passwort. Damit andere dein Passwort nicht direkt erraten können, solltest du nicht dein Benutzernamen oder dir wichtige Geburtstage oder Telefonnummern benutzen.
Außerdem muss dein Passwort mindestens 8 Zeichen lang sein. Du kannst Groß und Kleinbuchstaben verwenden, Ziffern und verschiedene Sonderzeichen. Ä, Ö, Ü und andere Umlautbuchstaben wie Ñ funktionieren nicht. Auch nicht als Kleinbuchstaben :D.
Falls du einen Passwort-Manager hast, lass dir ein Passwort generieren. Falls du keinen hast, aber gerne wüsstest, was das ist, frag in den kommenden Tagen gerne eine\*n Mentor\*in.
Falls du einen Passwort-Manager hast, lass dir ein Passwort generieren. *Falls du keinen hast, aber gerne wüsstest, was das ist, frag in den kommenden Tagen gerne eine\*n Mentor\*in.*

Wenn du dein Passwort ein zweites mal eingegeben hast, um sicherzustellen, dass du es dir korrekt gemerkt hast (oder dein Passwort-Manager es sich für dich gemerkt), kannst du auf "Account registrieren" klicken.

Wenn alle Angaben den Vorgaben entsprechen, bekommst du eine Meldung, dass du deine E-Mail-Adresse bestätigen sollst.
Bekommst du diese Meldung nicht, stimmen vielleicht deine Passwörter nicht überein, oder dein Anmeldenamen ist bereits vergeben. Das Feld, in dem du eine Änderung vornehmen musst, ist rot.

![Schritt 3, E-mail versand](../assets/new/new3.png){width=400}

Wenn du dein Passwort ein zweites mal eingegeben hast, um sicherzustellen, dass du es dir korrekt gemerkt hast (oder dein Passwort-Manager es sich fúr dich gemerkt), kannst du auf "Account registrieren" klicken.

Wenn alle Angaben den Vorgaben entsprechen, bekommst du eine meldung, dass du deine E-Mail-Adresse bestätigen sollst.
Bekommst du diese Meldung nicht, stimmen vielleicht deine Passwörter nicht überein, oder dein Anmeldenamen ist bereits vergeben. Das Feld, in dem du eine änderung vornehmen musst, ist rot.
Öffne deine E-Mails und schaue nach, ob du eine E-Mail von "[email protected]" bekommen hast. Der Betreff der E-Mail ist **Confirm your mail address**. Hast du nach mehreren Minuten noch keine E-Mail erhalten, kontrolliere auch dein *Spam* oder *Junk* Ordner. Hast du das Registrierungsfenster noch offen, kontrolliere auch gerne, ob deine E-Mail-Adresse korrekt geschrieben ist.

![Schritt 4, E-Mail Link](../assets/new/newMail.png){width=600}

Öffne deine E-Mails und schaue nach, ob du eine E-Mail von "[email protected]" bekommen hast. Der Betreff der E-Mail ist "Confirm your mail address". Hast du nach mehreren minuten noch keine E-Mail erhalten, kontrolliere auch dein SPAM (oder JUNk) Ordner und ob du bei der Registrierung deine E-Mail-Adresse korrekt angegeben hast (wenn du den Tab nicht geschlossen hat, steht deine Email Adresse in Fett noch da).
Die E-Mail ist auf Englisch. In ihr wird bestätigt, dass du einen Account angelegt hast. Der obere Link beginnt mit "https://auth.alpaka.space/signup/confirm" und hat dahinter verschiedene Zahlen. Wenn du auf diesen Link klickst, bestätigst du, dass du deinen Account registrieren möchtest und Zugriff auf deine E-Mail-Adresse hast.
Sollte der Link nicht mehre funktionieren, hast du wahrscheinlich länger als 48 Stunden zum Bestätigen gebraucht. Dann kannst du den Registrierungslink vom Anfang nutzen, um dich erneut anzumelden.

Die E-Mail ist auf Englisch. In ihr wird bestätigt, dass du einen Account angelegt hast. Der obere Link beginnt mit "https://auth.alpaka.space/signup/confirm" und hat dahinter verschiedene Zahlen. Wenn du auf diesen Link klickst, bestätigst du, dass du deinen Account regestrieren möchtest und Zugriff auf deine E-Mail-Adresse hast.
Sollte der Link nicht mehre funktionieren, hast du wahrscheinlich länger als 48 Stunden zum Bestätigen gebraucht. Dann kannst du den Regestrierungslink vom Anfang nutzen, um dich erneut anzumelden.
Nachdem du auf den Link geklickt hast, wirst du gebeten, dein Passwort einzugeben. Wenn du das hier angibst, hast du es geschafft. Dein Account ist Registriert und du hast Zugriff auf die verschiedenen Tools.

Nachdem du auf den Link geklickt hast, wirst du gebeten, dein Passwort einzugeben. Wenn du das hier angibst, hast du es geschafft. Dein Account ist Regestrtiert und du hast Zugriff auf die verschiedenen Tools.
![Schritt 5, Passwort eingeben](../assets/new/new4.png){width=400}

Herzlichen Glückwunsch! Du bist direkt in allen für die Veranstaltung nötigen Gruppen und kannst alle Tools nutzen.
**Herzlichen Glückwunsch!** Du bist direkt in allen für die Veranstaltung nötigen Gruppen und kannst die Tools nutzen.


## Tools (Dienste)

Die Tools sind die verschiedenen Kacheln, die du direkt nach der Anmeldung, oder unter dem Reiter "Dienste" siehst.
In jedem Falle solltest du "Chat", "Wiki", "Git", "Status" und "Pads" sehen. Abhängig von den Gruppen, den du hinzugefügt wurdest, kann es sein dass du mehr Tools siehst.

Du bist in jedem dieser Tools bereits in den für dich Notwendigen Gruppen angemeldet. Wenn du weitere Gruppen brauchst, frag gerne bei Mentor\*innen nach.
![Schritt 6, Tools ansicht](../assets/new/new5.png){width=600}

Zum Anmelden bei den verschiedenen Tools gibt es jeweils eine eigene Erklärung.
- Chat erlaubt dir auch außerhalb von Zulip mit anderen zu Chatten
- Pads erlaubt dir mit anderen gemeinsam an Notizen zu arbeiten, oder über verschiedene Geräte hinweg
- In Status kannst du sehen, ob alle Tools aktuell erreichbar sind
- Wenn die Event Orga Zeiten im Fahrplan eingetragen hat, kannst du dort nachsehen, wann was stattfindet
- Mithilfe von Termimverwaltung kanst du verschiedene Terminoptionen mit anderen abstimmen

Du bist in jedem dieser Tools bereits in den für dich notwendigen Gruppen angemeldet. Wenn du weitere Gruppen brauchst, frag gerne bei Mentor\*innen nach.

!!! note "Hinweis"
Wenn du möchtest gibt es Anleitungen, wie du dich bei den verschidenen Tools einloggst. Im Wiki werden dir verschiedene Funktionen der Tool noch genauer erklärt *(aktuell noch in Arbeit)*
- **Chat** erlaubt dir auch außerhalb von Zulip mit anderen zu Chatten
- **Pads** erlaubt dir mit anderen gemeinsam an Notizen zu arbeiten, oder über verschiedene Geräte hinweg
- In **Status** kannst du sehen, ob alle Tools aktuell erreichbar sind
- Wenn die Event Orga Zeiten im **Fahrplan** eingetragen hat, kannst du dort nachsehen, wann was stattfindet
- Mithilfe von **Termimverwaltung** kanst du verschiedene Terminoptionen mit anderen abstimmen

## Einstellungen (Selfservice)

Unter dem zweiten Reiter in der grauen Oberen Zeile, Selfservice, kannst du
![Selfeservice Button](../assets/new/bar.png){width=300}

Unter dem zweiten Reiter in der grauen, oberen Zeile, Selfservice, kannst du
- deinen Anzeigenamen ändern
- deine E-Mail adresse ändern
- dein Passwort ändern
- Zwei Faktor Authentifizierung einstellen, um andere daran zu hindern, sich mit deinem Anmeldenamen und Passwort anzumelden
- aus Gruppen austreten
- sehen mit welchen Geräten du dich angemeldet hast

## Abmelden und Ansicht
In der grauen, oberen Zeile gibt es außerdem die Möglichkeit die Ansicht von Mobil (Handy ansicht) auf Desktop (Computer Bildschirm ansicht) hin und her zu wechseln.
Außerdem kannst du dich abmelden, wenn du für den Moment kein Zugriff merh auf deinen Account brauchst.

![Abmeldebutton](../assets/new/bar2.png){width=300}

Loading
Loading