restructure
continuous-integration/drone Build is failing Details

main
Philipp Rothmann 2022-07-23 23:28:17 +02:00
parent 26b8841101
commit 870429937b
20 changed files with 216 additions and 40 deletions

3
.gitmodules vendored 100644
View File

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

View File

@ -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

8
docs/extra.css 100644
View File

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

View File

@ -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)
* [Nextcloud](apps/nextcloud.md)
* [OnlyOffice](apps/onlyoffice.md)
* [Wekan](apps/wekan.md)
## Software für kollaboratives Arbeiten [SKA]
### Installation
[Installation](installation/)
Apps:
* [Authentik](installation/authentik.md)
* [Nextcloud](installation/nextcloud.md)
* [OnlyOffice](installation/onlyoffice.md)
* [Wekan](installation/wekan.md)
---

View File

@ -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.

View File

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

View File

@ -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/

View File

@ -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

View File

@ -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

View File

@ -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>

1
docs/tools 160000

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

View File

@ -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