This commit is contained in:
Philipp Rothmann
parent
26b8841101
commit
870429937b
20 changed files with 216 additions and 40 deletions
3
.gitmodules
vendored
Normal file
3
.gitmodules
vendored
Normal file
|
|
@ -0,0 +1,3 @@
|
|||
[submodule "docs/tools"]
|
||||
path = docs/tools
|
||||
url = https://git.local-it.org/local-it/tools
|
||||
|
|
@ -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
Normal file
8
docs/extra.css
Normal file
|
|
@ -0,0 +1,8 @@
|
|||
h1 {
|
||||
}
|
||||
|
||||
|
||||
.md-header {
|
||||
background-color: #f5bd1c
|
||||
|
||||
}
|
||||
|
|
@ -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)
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -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.
|
||||
|
|
@ -1,3 +1,7 @@
|
|||
---
|
||||
title: Installation
|
||||
---
|
||||
|
||||
# Installation
|
||||
|
||||
Unser Setup basiert auf [abra](https://git.coopcloud.tech/coop-cloud/abra) von [coopcloud](https://coopcloud.tech)
|
||||
11
docs/installation/kimai.md
Normal file
11
docs/installation/kimai.md
Normal 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/
|
||||
46
docs/installation/matrix.md
Normal file
46
docs/installation/matrix.md
Normal 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
|
||||
22
docs/installation/zammad.md
Normal file
22
docs/installation/zammad.md
Normal 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
|
||||
|
||||
|
||||
80
docs/scratch/howtowintegrateaapp.drawio
Normal file
80
docs/scratch/howtowintegrateaapp.drawio
Normal 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
Submodule
1
docs/tools
Submodule
|
|
@ -0,0 +1 @@
|
|||
Subproject commit b3f7eae1f7c1fb9e9eb54288d4a8471842f99f71
|
||||
22
mkdocs.yml
22
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
|
||||
Loading…
Reference in a new issue