restructure

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "docs/tools"]
+	path = docs/tools
+	url = https://git.local-it.org/local-it/tools

docs/apps/matrix.md

@@ -1,31 +0,0 @@
-# Matrix
-
-### deployment
-
-```
-abra app new matrix-synapse
-abra app config matrix.example.org
-abra app deploy matrix.example.org
-abra app new element-web
-abra app config chat.example.org
-abra app deploy chat.example.org
-```
-
-
-## Migration
-
-
-### Backup
-
-
-### Restore
-
-secrets importieren 
-signing-key kopieren
-media-store kopien /data/media_store
-db dump importieren
-
-check that user 991 has ownership of /data/media_store
-
-
-

docs/extra.css

@@ -0,0 +1,8 @@
+h1 { 
+}
+
+
+.md-header {
+    background-color: #f5bd1c
+    
+}

docs/index.md

@@ -1,14 +1,24 @@
-# Software für kollaboratives Arbeiten [SKA]
+# Local-IT e.V.
 
 
-[Installation](installation.md)
+## Tool Übersicht
 
-## Apps
+[Liste mit kollaborativen Tools](tools/README.md)
 
-* [Authentik](apps/authentik.md)
+## Software für kollaboratives Arbeiten [SKA]
-* [Nextcloud](apps/nextcloud.md)
+
-* [OnlyOffice](apps/onlyoffice.md)
+
-* [Wekan](apps/wekan.md)
+
+### Installation
+
+[Installation](installation/)
+
+Apps:
+
+* [Authentik](installation/authentik.md)
+* [Nextcloud](installation/nextcloud.md)
+* [OnlyOffice](installation/onlyoffice.md)
+* [Wekan](installation/wekan.md)
 
 ---
 

docs/installation/authentik.md

@@ -1,3 +1,7 @@
+---
+title: Single-Sign-On Provider
+---
+
 # Single-Sign-On Provider
 
 [Authentik](https://goauthentik.io) ist unser Single-Sign-On (SSO) Provider und Identity Management.

docs/installation/index.md

@@ -1,3 +1,7 @@
+---
+title: Installation
+---
+
 # Installation
 
 Unser Setup basiert auf [abra](https://git.coopcloud.tech/coop-cloud/abra) von [coopcloud](https://coopcloud.tech)

docs/installation/kimai.md

@@ -0,0 +1,11 @@
+### sso
+
+saml
+https://www.kimai.org/documentation/saml-authentik.html
+* mapper für name: SAML Property Mapping
+  name: name
+  saml-attribute: $http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name
+  ausdruck: return user.username
+
+
+https://goauthentik.io/integrations/services/kimai/

docs/installation/matrix.md

@@ -0,0 +1,46 @@
+# Matrix
+
+### deployment
+
+```
+abra app new matrix-synapse
+abra app config matrix.example.org
+abra app deploy matrix.example.org
+abra app new element-web
+abra app config chat.example.org
+abra app deploy chat.example.org
+```
+
+
+## Migration
+
+
+### Backup
+
+
+### Restore
+
+secrets importieren 
+signing-key kopieren
+media-store kopien /data/media_store
+db dump importieren
+
+check that user 991 has ownership of /data/media_store
+
+
+
+
+
+
+--
+
+
+https://www.matrix.org/docs/api/#overview
+
+https://www.matrix.org/docs/guides/client-server-api
+
+
+curl -X POST -d '{"type":"m.login.password", "user":"admin", "password":""}' http://localhost:8008/_matrix/client/r0/login
+{"user_id":"@admin:matrix.local-it.org","access_token":"syt_YWRtaW4_nNAvEJZqiMqOCOqizuIQ_1oR29V","home_server":"matrix.local-it.org","device_id":"YSZDLGKMQI","well_known":{"m.homeserver":{"base_url":"https://matrix.local-it.org/"}}}
+
+curl --header "Authorization: Bearer secretsecret" -X POST -d '{"user_id": "@yksflip:matrix.kaputt.cloud"}' http://localhost:8008/_synapse/admin/v1/rooms/\!TvsvJVDwEFtMnPCbkA:matrix.local-it.org/make_room_admin

docs/installation/zammad.md

@@ -0,0 +1,22 @@
+
+## sso
+
+saml
+https://admin-docs.zammad.org/en/latest/settings/security/third-party/saml.html
+
+
+Einstellungen -> Sicherheit -> Anwendungen von Drittanbietern
+
+https://sso.local-it.org/application/saml/zammad/sso/binding/init
+https://goauthentik.io/docs/providers/saml
+idp-initated-login
+
+
+customization -> Property Mappings -> Create SAML
+mappings:
+https://goauthentik.io/docs/property-mappings/expression
+https://goauthentik.io/docs/user-group/user#object-attributes
+
+Danach dem Provider die neuen Mappings hinzufügen
+
+

docs/scratch/howtowintegrateaapp.drawio

@@ -0,0 +1,80 @@
+<mxfile host="65bd71144e">
+    <diagram id="SOYL9MAsovj4soq4rpn3" name="Page-1">
+        <mxGraphModel dx="976" dy="615" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="850" pageHeight="1100" math="0" shadow="0">
+            <root>
+                <mxCell id="0"/>
+                <mxCell id="1" parent="0"/>
+                <mxCell id="2" value="find a cool app" style="rounded=1;whiteSpace=wrap;html=1;" parent="1" vertex="1">
+                    <mxGeometry x="10" y="180" width="120" height="60" as="geometry"/>
+                </mxCell>
+                <mxCell id="16" value="yes" style="edgeStyle=none;html=1;" parent="1" source="3" target="4" edge="1">
+                    <mxGeometry relative="1" as="geometry"/>
+                </mxCell>
+                <mxCell id="3" value="is license FOSS?" style="rounded=1;whiteSpace=wrap;html=1;" parent="1" vertex="1">
+                    <mxGeometry x="340" y="180" width="120" height="60" as="geometry"/>
+                </mxCell>
+                <mxCell id="19" value="no" style="edgeStyle=none;html=1;" edge="1" parent="1" source="4">
+                    <mxGeometry relative="1" as="geometry">
+                        <mxPoint x="540" y="310" as="targetPoint"/>
+                    </mxGeometry>
+                </mxCell>
+                <mxCell id="20" value="yes" style="edgeStyle=none;html=1;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="4" target="5">
+                    <mxGeometry relative="1" as="geometry"/>
+                </mxCell>
+                <mxCell id="4" value="SSO supported (oidc, saml, ldap)?" style="rounded=1;whiteSpace=wrap;html=1;" parent="1" vertex="1">
+                    <mxGeometry x="340" y="280" width="120" height="60" as="geometry"/>
+                </mxCell>
+                <mxCell id="22" value="no" style="edgeStyle=none;html=1;" edge="1" parent="1" source="5" target="11">
+                    <mxGeometry relative="1" as="geometry"/>
+                </mxCell>
+                <mxCell id="24" value="yes" style="edgeStyle=none;html=1;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="5" target="6">
+                    <mxGeometry relative="1" as="geometry"/>
+                </mxCell>
+                <mxCell id="5" value="docker image?" style="rounded=1;whiteSpace=wrap;html=1;" parent="1" vertex="1">
+                    <mxGeometry x="340" y="374" width="120" height="60" as="geometry"/>
+                </mxCell>
+                <mxCell id="6" value="docker-compose?" style="rounded=1;whiteSpace=wrap;html=1;" parent="1" vertex="1">
+                    <mxGeometry x="340" y="470" width="120" height="60" as="geometry"/>
+                </mxCell>
+                <mxCell id="7" value="gain some knowledge about software on local machine / dev server" style="rounded=1;whiteSpace=wrap;html=1;" parent="1" vertex="1">
+                    <mxGeometry x="340" y="550" width="120" height="60" as="geometry"/>
+                </mxCell>
+                <mxCell id="9" style="edgeStyle=none;html=1;entryX=0;entryY=0.5;entryDx=0;entryDy=0;" parent="1" source="8" target="3" edge="1">
+                    <mxGeometry relative="1" as="geometry"/>
+                </mxCell>
+                <mxCell id="10" value="no" style="edgeLabel;html=1;align=center;verticalAlign=middle;resizable=0;points=[];" parent="9" vertex="1" connectable="0">
+                    <mxGeometry x="-0.4286" y="-2" relative="1" as="geometry">
+                        <mxPoint x="10" y="-2" as="offset"/>
+                    </mxGeometry>
+                </mxCell>
+                <mxCell id="8" value="already in abra catalogue?" style="rounded=1;whiteSpace=wrap;html=1;" parent="1" vertex="1">
+                    <mxGeometry x="150" y="180" width="120" height="60" as="geometry"/>
+                </mxCell>
+                <mxCell id="25" style="edgeStyle=none;html=1;" edge="1" parent="1" source="11" target="6">
+                    <mxGeometry relative="1" as="geometry"/>
+                </mxCell>
+                <mxCell id="11" value="create docker image" style="rounded=1;whiteSpace=wrap;html=1;" parent="1" vertex="1">
+                    <mxGeometry x="510" y="374" width="120" height="60" as="geometry"/>
+                </mxCell>
+                <mxCell id="21" value="yes" style="edgeStyle=none;html=1;entryX=0.5;entryY=0;entryDx=0;entryDy=0;" edge="1" parent="1" source="12" target="5">
+                    <mxGeometry relative="1" as="geometry"/>
+                </mxCell>
+                <mxCell id="12" value="is effort to implement sso reasonable?" style="rounded=1;whiteSpace=wrap;html=1;" parent="1" vertex="1">
+                    <mxGeometry x="540" y="280" width="120" height="60" as="geometry"/>
+                </mxCell>
+                <mxCell id="13" value="try SSO" style="rounded=1;whiteSpace=wrap;html=1;" parent="1" vertex="1">
+                    <mxGeometry x="340" y="620" width="120" height="60" as="geometry"/>
+                </mxCell>
+                <mxCell id="14" value="volumes" style="rounded=1;whiteSpace=wrap;html=1;" parent="1" vertex="1">
+                    <mxGeometry x="340" y="700" width="120" height="60" as="geometry"/>
+                </mxCell>
+                <mxCell id="15" value="how to backup and restore" style="rounded=1;whiteSpace=wrap;html=1;" parent="1" vertex="1">
+                    <mxGeometry x="340" y="820" width="120" height="60" as="geometry"/>
+                </mxCell>
+                <mxCell id="27" value="create docker image" style="rounded=1;whiteSpace=wrap;html=1;" vertex="1" parent="1">
+                    <mxGeometry x="510" y="470" width="120" height="60" as="geometry"/>
+                </mxCell>
+            </root>
+        </mxGraphModel>
+    </diagram>
+</mxfile>

docs/tools

@@ -0,0 +1 @@
+Subproject commit b3f7eae1f7c1fb9e9eb54288d4a8471842f99f71

mkdocs.yml

@@ -1,4 +1,4 @@
-site_name: LIT Docs
+site_name: local-it Dokumentation
 site_url: https://docs.local-it.org
 
 theme:
@@ -15,5 +15,23 @@ markdown_extensions:
   - pymdownx.superfences
 
 repo_name: LIT/docs
-repo_url: https://git.local-it.org/LIT/docs
+repo_url: https://git.local-it.org/local-it/docs
 edit_uri: _edit/main/docs/
+
+nav:
+  - Home: index.md
+  - Toolübersicht: tools/README.md
+  - Installation:
+    - Basis: installation/
+    - Single-Sign-On Provider: installation/authentik/
+    - Tools:
+      - Nextcloud: installation/nextcloud/
+      - Wekan: installation/wekan/
+  - FAQ: faq.md
+  - Source Code (Gitea): https://git.local-it.org
+  - Rechtliches:
+    - Datenschutz: https://local-it.org/datenschutzerklaerung/
+    - Impressum: https://local-it.org/datenschutzerklaerung/
+    
+extra_css:
+  - extra.css