projektdokumentation/.gitignore

@@ -6,7 +6,7 @@
 *.fls
 *.out
 *.toc
-
+*.pdf
 ## Intermediate documents:
 *.dvi
 *-converted-to.*

projektdokumentation/Abkuerzungen.tex

@@ -35,4 +35,6 @@
 	\acro{URL}{Uniform Resource Locator}\acused{URL}
 	\acro{VM}{Virtual Machine}
 	\acro{XML}{Extensible Markup Language}
+	\acro{API}{Application Programming Interface}
+	\acro{JWT}{JSON Web Token}
 \end{acronym}

projektdokumentation/Inhalt.tex

@@ -3,3 +3,4 @@
 \input{Inhalt/Projektarchitektur}
 \input{Inhalt/CI}
 \input{Inhalt/Dice.tex}
+\input{Inhalt/Auth.tex}

projektdokumentation/Inhalt/Auth.tex

@@ -0,0 +1,9 @@
+\section{Authentifizierung}
+\label{sec:Authentifizierung}
+Die Authentifizierung gegenüber der \acs{API} erfolgt über einen \acs{JWT}-Token, der dem Frontend nach Erfolgreicher Authentifizierung übergeben wird.
+Authentifizierung läuft über zwei verschiedene Wege ab:
+\begin{itemize}
+    \item \textbf{Registrierung mit username/password:} Der Nutzer füllt ein Registrierungs-Formular aus, welches die Anmeldedaten an die \acs{API} sendet. Diese validitert die Anmeldedaten und legt bei Erfolg einen neuen Nutzer an. Anschließend wird eine E-Mail-Verifizierungs-Mail gesendet. Bis der Link in der Verifizierungs-Mail nicht angeklickt wurde, ist der Nutzer nicht aktiv und kann sich nicht anmelden. Nach dem Klick auf den Link wird der Nutzer aktiviert und kann sich anmelden.
+    \item \textbf{Login mit username/password:} Der Nutzer füllt ein Anmelde-Formular, welches die Anmeldedaten an die \acs{API} sendet. Diese prüft die Anmeldedaten und gibt bei Erfolg einen \acs{JWT}-Token zurück. Falls kein Nutzer mit den Anmeldedaten existiert, wird der Nutzer aufgefordert einen Account zu erstellen.  
+    \item \textbf{Login über Oauth (Open Authorization):} Der Nutzer meldet sich mit einem Oauth-Provider an, in unserem Fall Google oder Github. Das Backend leitet den Nutzer zum Oauth-Provider weiter, der die Anmeldedaten prüft und bei Erfolg den Nutzer auf die Applikation weiterleitet und einen Authorization-Code zurück gibt. Mit diesem Code holt sich die \acs{API} einen \acs{JWT} vom jeweiligen Provider und holt sich Nutzer-Informationen. Mit diesen wird dann ein existierender Nutzer eingeloggt, oder registriert falls der Nutzer noch kein Konto hatte. Anschließend wird von der \acs{API} ein \acs{JWT} generiert und an das Frontend weitergegeben. 
+\end{itemize}