opencode
6eb3dfd8f9
- Remove all prior release notes and version snapshots (v0.6.0-v0.8.6) - Rename handbook to *.de.md; keep *.en.md - New release notes v0.9.0.de.md/.en.md with v0.9.0 snapshot - generate-docs.mjs: .de/.en convention incl. search index and en-fallback - docs.tsx: release fallback now uses version.de.md - Wording: neutral tagline, anonymous user, no gender forms - Add docs/examples/import-tools.yaml and link from administration docs
109 lines
3.7 KiB
Markdown
109 lines
3.7 KiB
Markdown
---
|
|
title: Administration
|
|
order: 13
|
|
---
|
|
|
|
# Administration
|
|
|
|
Der Bereich **Admin** (`/admin`) ist ausschließlich für Admins zugänglich.
|
|
Ohne Admin-Rolle erscheint eine Zugriffsverweigerung.
|
|
|
|
> Oben rechts führt die Schaltfläche **Redundanz-Dashboard** zur automatischen
|
|
> Doppelungs-Erkennung (siehe [Redundanz](/docs/handbook/redundanz)).
|
|
|
|
## Tab „Nutzer"
|
|
|
|
Verwaltung der lokalen Konten.
|
|
|
|
- **Nutzer hinzufügen:** Benutzername (Pflicht), Passwort (mind. 6 Zeichen),
|
|
E-Mail (optional), **Rolle** (User/Admin), **Tarif** (Free/Premium/Enterprise).
|
|
- **Nutzer bearbeiten:** Rolle, Tarif und (für lokale Konten) ein neues Passwort
|
|
setzen. Für OIDC-Konten wird die Passwortverwaltung im Identitätsanbieter
|
|
(z. B. Keycloak) angeboten.
|
|
- **Nutzer löschen:** Entfernt das Konto endgültig (nicht für das eigene Konto).
|
|
|
|
API-Referenz:
|
|
[`POST /users`](/docs/reference/endpoints/users#createUser),
|
|
[`PATCH /users/{id}`](/docs/reference/endpoints/users#updateUser),
|
|
[`DELETE /users/{id}`](/docs/reference/endpoints/users#deleteUser).
|
|
|
|
## Tab „Tools"
|
|
|
|
Zentraler Zugriff auf den Tool-Katalog.
|
|
|
|
- **Suchen** nach Tools.
|
|
- Tools einzeln ansehen, bearbeiten oder in den Papierkorb verschieben.
|
|
- **Massenaktion:** mehrere Tools auswählen und in den Papierkorb verschieben
|
|
(Bestätigungsdialog; soft gelöschte Tools sind aus allen öffentlichen Ansichten
|
|
entfernt und können wiederhergestellt oder endgültig gelöscht werden).
|
|
- **Importieren** (Premium): über die Schaltfläche **Importieren** oben rechts
|
|
können mehrere Tools gleichzeitig angelegt werden. Das Format wird automatisch
|
|
erkannt (CSV, JSON oder YAML); für CSV lässt sich der Trenner wählen
|
|
(automatisch, Komma, Semikolon oder Tabulator). Die Daten lassen sich direkt
|
|
ins Formular einfügen oder als Datei hochladen.
|
|
|
|
Unterstützte Felder: `name` (Pflicht), `description`, `category`, `websiteUrl`,
|
|
`iconUrl`, `features`, `tags` (`features`/`tags` sind mit `|` getrennte Listen).
|
|
|
|
**CSV-Beispiel:**
|
|
|
|
```csv
|
|
name;description;category;features;tags
|
|
Grafana;Observability- und Dashboard-Plattform;Monitoring;Dashboards|Alerts;devops
|
|
Prometheus;Zeitreihen-Datenbank;Monitoring;Metrics;devops
|
|
```
|
|
|
|
**JSON-Beispiel:**
|
|
|
|
```json
|
|
[
|
|
{ "name": "Grafana", "category": "Monitoring", "features": ["Dashboards"] },
|
|
{ "name": "Prometheus", "category": "Monitoring" }
|
|
]
|
|
```
|
|
|
|
**YAML-Beispiel:**
|
|
|
|
```yaml
|
|
- name: Grafana
|
|
category: Monitoring
|
|
features:
|
|
- Dashboards
|
|
- name: Prometheus
|
|
category: Monitoring
|
|
```
|
|
|
|
Eine umfangreichere, fertig importierbare Beispieldatei liegt unter
|
|
`docs/examples/import-tools.yaml` (24 gängige Enterprise-Tools).
|
|
|
|
Beim Import werden einzelne fehlerhafte Zeilen übersprungen und mit Zeilennummer
|
|
aufgelistet; korrekte Zeilen werden trotzdem angelegt. Jeder Import erzeugt
|
|
Audit-Log-Einträge.
|
|
|
|
## Tab „Audit-Log"
|
|
|
|
Chronologisches Protokoll aller Anlage-, Änderungs- und Löschvorgänge
|
|
(max. 100 Einträge): Aktion, Entität + ID, Zeitstempel, ausführende Person und
|
|
geänderte Felder.
|
|
|
|
API-Referenz: [`GET /audit-logs`](/docs/reference/endpoints/audit#listAuditLogs).
|
|
|
|
## Tab „System"
|
|
|
|
Versionsinformationen der laufenden Instanz:
|
|
|
|
- **Version** (z. B. `v0.8.1`),
|
|
- **Commit** (7-stelliger SHA, verlinkt zum Repository),
|
|
- **Build-Datum**,
|
|
- **Papierkorb-Aufbewahrung** („N Tage" oder „Für immer").
|
|
|
|
## Tool-Verknüpfungen (Admin)
|
|
|
|
Auf der Detailseite eines Tools kannst du als Admin **Verknüpfungen**
|
|
(eigene/„manual" sowie automatisch erkannte) verwalten:
|
|
|
|
- **Tool verknüpfen:** Dialog mit Tool-ID, **Beziehungstyp**
|
|
(Ähnlich / Ersetzt / Abgelöst durch) und optionalen Notizen.
|
|
- Beziehungstypen werden als Badges auf der Detailseite angezeigt.
|
|
- Manuelle Verknüpfungen lassen sich per Papierkorb-Icon wieder entfernen.
|