Unter Portainer, auf Stacks und neuen Stack im Editor erstellen.

Wichtig: Unter PAPERLESS_SECRET_KEY: XXX eine Zeichenkette generieren lassen.

Docker Compose

[crayon-6767a5ffa09fe062450257/]

Benutzer erstellen

über ssh verbinden. Anschließend in die Konsole vom Docker Container bewegen:
[crayon-6767a5ffa0a05650285042/]
[crayon-6767a5ffa0a07245409139/]

Dokumente + Einstellungen exportieren

über ssh verbinden. In dem Pfad nach -z wird eine Datei erstellt
[crayon-6767a5ffa0a08023693053/]
 

https://kroki.io/examples.html#erd

[crayon-6767a5ffa1094435753219/]
 

[crayon-6767a5ffa1233385710868/]
 

Alt + T -> „NU“ eingeben
[crayon-6767a5ffa13d1970473186/]
 

[crayon-6767a5ffa1589531140013/]
 

[crayon-6767a5ffa171f860932957/]
 

In diesem Beitrag will ich eine Schritt für Schritt Anleitung geben, wie man Nuxt 3 mit Keycloak autorisiert.

Die Thematik um Autorisierung und Authentifizierung bedarf einer soliden Kenntnis in der Thematik. Ich empfehle daher unbedingt sich die Zeit zu nehmen und das folgende Video anzuschauen und sicher zu gehen, dass alles verstanden wurde:

Zum Ende füge ich weitere Lohnenswerte Links hinzu.

1. Keycloak installieren

1. Keycloak herunterladen: downloads – Keycloak
2. Zip-Datei entpacken und in das bin Verzeichnis wechseln. Dort eine Verknüpfung vom kc.bat erstellen, dann auf Eigenschaften und beim Ziel start-dev anhängen
3. Verknüpfung starten und keycloak ist unter der Adresse http://localhost:8080 erreichbar. Dort einen neuen Admin User anlegen

2. Keycloak einrichten

1. Keycloak Administarion console aufrufen über http://localhost:8080
2. Neuen realm erstellen und nur Realm name eintragen. Wichtig! Keine Sonderzeichen benutzen
3. Jetzt in dem angelegten realm einen neuen Client erstellen
4.  User erstellen. Der Username reicht
5. Zu dem User wechseln und folgende Sachen um Credentials ergänzen

3. nuxt 3 App aufsetzen

Installiertes nodeJs und pnpm sind Voraussetzung

1. Visual studio Code starten und das prime-vue starter repository clonen: https://github.com/sfxcode/nuxt3-primevue-starter.git
2. Verzeichnis auswählen wo die repo hin soll und mit öffnen bestätigen
3. Wir wechseln zum Terminal und installieren sidebase nuxt-auth. Zur Zeit des Schreibens existiert auch eine 0.4.0 alpha Version. Diese Version verursacht aber Fehler mit Keycloak.:
   [crayon-6767a5ffa18d6198353160/]
4. nun in der nuxt.config.ts die modules ergänzen und nuxt mitteilen, dass Autorisierung auf jeder Seite gelten soll:
   [crayon-6767a5ffa18da024127722/]
5. Jetzt muss unter server 2 Dateien erstellt werden: 1. server\auth\[…].ts
   [crayon-6767a5ffa18dc722489250/]
   und 2. server\api\session.get.ts
   [crayon-6767a5ffa18dd356668406/]
6.  Eine weitere Datei muss angelegt werden für die Umgebungsvariablen: .env
   [crayon-6767a5ffa18de720971265/]
   Lasst euch ein Secret irgendwo generieren. Dieser String ist nur für Demozwecke!!!

   Wichtig ist, dass die lokale Adresse mit 127.0.0.1 angegeben wird. localhost oder 0.0.0.0 kann nicht aufgelöst werden. In den Url ist der real name enthalten.

Weitere Links

Schritt für Schritt Anleitung zur lokalen Einrichtung von Keycloak und einer Vue Applikation:

Security in Vuejs 3.0 with authentication and authorization by KeyCloak Part 1 | by Nicolas Barlatier | Dev Genius

Documentation Nuxt-Auth von Sidebase:

Quick Start · sidebase

Nuxt-Auth wurde von Next-Auth portiert. Fehlende Dokumentation kann hier nachgelesen werden:

Introduction | NextAuth.js (next-auth.js.org)

Ich nutze das prime-vue starter Paket, welches nuxt 3 inkludiert hat. Ich kann das Paket jeden nur empfehlen!

sfxcode/nuxt3-primevue-starter: Build your VUE.js App with Nuxt3 . First Class PrimeVUE support. Formkit Validation included. (github.com)

Für OAuth und OpenId Connectt gibt es Debugger. Der Author ist Nathon aus dem YouTube Video weiter oben.

OAuth 2.0 debugger (oauthdebugger.com)

OpenID Connect debugger (oidcdebugger.com)

Keycloak Dokumentation:

Documentation – Keycloak

Typescript muss in VS Code installiert werden. -g steht für globally (Alle Projekte)
[crayon-6767a5ffa1ad4967120367/]
Typescript Version prüfen
[crayon-6767a5ffa1ad8081696440/]
 

Enums
[crayon-6767a5ffa1ad9697768036/]
Objekte werden mit reactive<type>({…}) reactiviert und primitive Datentypen mit ref<string>(…)
[crayon-6767a5ffa1ada006503959/]
Mixins werden in eine Vue Instanz hinzugefügt. So als würde man 2 Vue Instanzen verschmelzen. Composables sind dem ähnlich. In Mixins wird alles importiert, bei Composables muss jede Variable, Methode, etc. einzeln importiert werden.

Guter Artikel dazu:

What is a Vue.js Composable? – Vue.js Tutorials (vueschool.io)

Wenn man durch eine App navigiert, dann ist der Seitenaufbau überall identisch. Das Menü, die Kopfzeile und Fusszeile sind auf jeder Seite identisch. Lediglich der Inhalt ändert sich.

In Nuxt 3 werden Layouts im „layouts“-Ordner erstellt und anschließend in die app.vue hinzugefügt. Einzelne Seiten werden im „pages“-Ordner erstellt.

Nuxt 3 routet die pages anhand des Namens. Nur die page „index.vue“ wird zum root Knoten geroutet.

Also erstellen wir ein Verzeichnis „layouts“ und ein Verzeichnis „pages“.

In das „layouts“ Verzeichnis, eine Datei erstellen „default.vue“.

und folgenden Inhalt kopieren:
[crayon-6767a5ffa1c93565532460/]
Dort, wo <slot /> steht, kommt der Inhalt der einzelnen Pages hinein.

Jetzt in das Verzeichnis „pages“

die Datei index.vue mit folgenden Inhalt
[crayon-6767a5ffa1c97759551073/]
und die Datei „pageOne.vue“ mit folgenden Inhalt erstellen
[crayon-6767a5ffa1c99025642867/]
In der app.vue müssen wir nun sagen, dass wir nicht mehr die Nuxt Welcome page sehen wollen, sondern unser Layout:
[crayon-6767a5ffa1c9a994464827/]