Architektur-Dokumentation, die weiss, auf welchem Server sie läuft.

swark verbindet Ihr IT-Inventar – Hosts, Cluster, Zonen und Software – mit Architekturtexten und NIS2-Controls. Nerd-IT betreibt Ihre eigene Instanz: eingerichtet, befüllt, gesichert und aktuell gehalten.

Screenshot der swark-Demo: Systemlandschaft
Infrastruktur: Systemlandschaft, Cluster und Baremetal-Server, direkt aus dem Inventar erzeugt. Diese Seite in der Demo öffnen

Das Wissen über Ihre IT liegt heute an mehreren Orten.

Das Inventar steckt in Excel, die Diagramme in Visio, Entscheide im Wiki, Zuständigkeiten in Köpfen und die Nachweise fürs Audit in Ordnern. Spätestens bei einem NIS2- oder ISO-27001-Audit oder einem Personalwechsel fehlt der Zusammenhang.

swark legt diese Ebenen übereinander. Jeder Server, jede Anwendung und jede Zone ist ein Datensatz mit Beziehungen, und Texte, Diagramme und Controls verweisen auf genau diese Datensätze.

Rechts ein echter Datensatz aus der Demo: der Host dc1 mit allem, was swark über ihn weiss.

Host dc1 dc1.internal
Läuft auf
baremetal:hv Hyper-V
Betriebssystem
windows-server:2019 Windows Server 2019
Anwendungen
ad-prod Active Directory mssql-wsus-prod SQL Server wsus-prod WSUS, nutzt mssql-wsus-prod
Logische Zone
infra Infrastruktur · Daten vertraulich · Zugriff für it, devops
Cluster
hyperv-test Stage test
Aus dem Demo-Datensatz, eingelesen per Excel-Import

Was swark abbildet

swark ist ein Open-Source-Werkzeug für IT- und Software-Architektur. Es trennt strukturierte Daten von freiem Inhalt und führt beides auf denselben Seiten zusammen.

Inventar als Datenmodell

Baremetal-Server, virtuelle Hosts, Laufzeitumgebungen, Cluster, Anwendungsinstanzen, Software mit Releases, logische Zonen, Stages und Managed Services wie Cloud-Accounts und Subscriptions. Jedes Element hat einen Typ, feste Eigenschaften und Beziehungen zu anderen Elementen.

  • Eindeutige Kennungen (scomp-IDs) für jedes Element
  • Systemlandschaft und Cluster als PlantUML-Diagramme aus den Daten
  • Pflege im Admin-Bereich oder per Excel-Import
Ausschnitt aus der swark-Demo: Baremetal-Übersicht mit Text und daraus erzeugtem Diagramm

Texte dort, wo die Daten sind

Begründungen, Entscheide und Konzepte entstehen als Markdown neben den Daten, auf die sie sich beziehen. Strategie mit Vision, Zielbild, Zielen und Leitfragen, Richtlinien mit Regeln für bestimmte Zonen, ein Glossar und eine arc42-Struktur für einzelne Systeme.

  • Strategie, Ziele und Leitfragen mit Bezug zu Regulierungen
  • Richtlinien, deren Regeln auf Zonen und Systeme zeigen
  • Glossar für eine gemeinsame Sprache im Team
Ausschnitt aus der swark-Demo: Glossar der Lumen AG

Compliance mit Bezug zur echten Infrastruktur

Regulierungen, Kapitel und Controls, dazu Findings, Massnahmen und Kennzahlen mit Messperioden. Richtlinien verweisen auf die Zonen und Systeme, für die sie gelten, und auf die Artikel, die sie umsetzen. Die NIS2-Richtlinie liegt bei: Gesetzestext und deutsche Zusammenfassung für alle 46 Artikel sowie 33 vorbereitete Controls. Weitere Regelwerke wie DORA, VAIT oder TISAX lassen sich erfassen.

  • Findings mit Kritikalität und Bezug zu strategischen Zielen
  • Massnahmen mit Beginn, Dauer und Kennzahlen
  • Nachweise für Audits aus denselben Daten wie die Architektur
Ausschnitt aus der swark-Demo: Richtlinie für Authentifizierung mit Bezug auf VAIT und NIS2 Art. 21

Aus Ihren Inventarlisten wird in einem Import eine Dokumentation.

swark liest eine Excel-Arbeitsmappe mit 33 Tabellenblättern, vom Akteur bis zur Kennzahl. Wir übertragen Ihre bestehenden Listen in dieses Format, prüfen die Bezüge und spielen alles ein. Spätere Änderungen laufen über denselben Weg oder direkt im Admin-Bereich.

Namehost.scomp_idParentOperating systemVirtualizer
3esx1.internalesx1baremetal:esx1vmware:latestvmware:latest
4esx2.internalesx2baremetal:esx2vmware:latestvmware:latest
5dc1.internaldc1baremetal:hvwindows-server:2019
6k8s-controller-vm.internalk8s-controller-vmhost:esx1debian:12
7k8s-worker-1-vm.internalk8s-worker-1-vmhost:esx1debian:12
8k8s-worker-2-vm.internalk8s-worker-2-vmhost:esx2debian:12
ActorsData classificationsProtection goalsCriticalityLogical zonesStagesTechnologiesProtocol stacksResource typesSoftwareSystemsReleasesManaged accountsManaged offersManaged subscriptionsBaremetalsHostsRuntimesClustersApplication instancesRegulationsRegulation chaptersRegulation controlsStrategiesStrategy questionsStrategy objectivesFindingsActionsScope templatesPoliciesRulesMeasurement periodsMetrics
Tabellenblatt «Hosts» aus der Importvorlage der Demo. Zeile 5 ist der Host dc1 von oben; die Spalte «Parent» verweist auf das Blatt «Baremetals». Importvorlage mit den Demo-Daten herunterladen (Excel, 33 Blätter)

Was Nerd-IT für Ihre Instanz übernimmt

Sie dokumentieren, wir kümmern uns um Server, Datenbank, Zertifikate und Updates. Jede Organisation erhält eine eigene Installation mit eigener Datenbank, nichts wird zwischen Kunden geteilt.

Eigene Instanz
Unter ihre-firma.swark.nerdag.ch oder Ihrer eigenen Domain, mit eigenem TLS-Zertifikat.
Einrichtung und Import
Wir bauen Ihr Datenmodell auf, übernehmen bestehende Inventarlisten und richten die Benutzerkonten ein.
Updates
Neue swark-Versionen spielen wir nach einem Test auf einer Kopie Ihrer Daten ein.
Sicherung
Tägliche Sicherung von Datenbank und Inhalten, Wiederherstellung auf Anfrage.
Standort
Rechenzentrum von Hetzner in Falkenstein, Deutschland (EU). Betrieb und Ansprechperson: Nerd-IT in Buchs ZH.
Ausstieg
Datenbank-Export und Inhalte erhalten Sie jederzeit. swark ist Open Source (MIT), Sie können es selbst weiterbetreiben.

Probieren Sie swark mit den Daten der Lumen AG aus.

Die Lumen AG ist eine erfundene Versicherung mit echtem Datenmodell: Zonen, Hosts, Cluster, Software, Richtlinien, Findings und NIS2. Sie können alles ansehen und im Admin-Bereich auch ändern; jede Nacht um 03:30 Uhr wird die Demo zurückgesetzt.

Live-Demo öffnen

Preise

Monatlich, pro Organisation, keine Kosten pro Benutzer innerhalb des Pakets. Alle Preise in CHF, exklusive MWST.

Team

Für eine IT-Abteilung, die mit der Dokumentation anfangen will.

149CHF / Monat

  • Eigene swark-Instanz
  • Bis 10 Benutzerkonten
  • Updates und tägliche Sicherung
  • Support per E-Mail
Team anfragen

Einführung

Einmalig, damit die Dokumentation von Anfang an gefüllt ist.

ab2'900CHF einmalig

  • Workshop zu Zielen und Datenmodell
  • Übernahme Ihrer Inventarlisten
  • Zuordnung zu NIS2-Artikeln und Controls
  • Schulung für Ihr Team
Einführung anfragen

Gut zu wissen

Wer steht hinter swark?

swark (Swiss Architecture Knife) ist ein Open-Source-Projekt der dreitier GmbH aus Deutschland und steht unter der MIT-Lizenz. Nerd-IT ist ein unabhängiger Betreiber und nicht mit dreitier verbunden. Quellcode: github.com/swiss-architecture-knife.

Wie ausgereift ist swark?

Wir betreiben Version 0.2.1. Datenmodell, Excel-Import, die Frontend-Seiten und die Compliance-Funktionen sind nutzbar; einzelne Bereiche sind noch im Aufbau. Neue Versionen spielen wir ein, sobald sie auf einer Kopie Ihrer Daten sauber laufen. Am besten prüfen Sie den heutigen Stand direkt in der Demo.

Wo liegen unsere Daten?

Auf einem Server von Nerd-IT im Rechenzentrum von Hetzner in Falkenstein, Deutschland, also in der EU. Die Verbindung ist durchgehend per TLS verschlüsselt. Jede Instanz hat eine eigene Datenbank.

Können wir uns mit Microsoft Entra ID anmelden?

Noch nicht. swark 0.2.1 arbeitet mit lokalen Benutzerkonten. Anmeldung über OIDC oder Entra ID ist im swark-Projekt vorgesehen; sobald eine Version das unterstützt, richten wir es für Sie ein.

Können wir später selbst hosten?

Ja. Sie erhalten einen vollständigen Export von Datenbank und Inhalten. swark läuft als Docker-Container mit MariaDB; unsere Betriebsdokumentation beschreibt den Aufbau.

Was passiert mit Eingaben in der Demo?

Die Demo ist öffentlich und wird jede Nacht auf den Ausgangsstand zurückgesetzt. Bitte dort nichts Vertrauliches eintragen.

Eigene Instanz anfragen

Schreiben Sie uns, welches Paket Sie interessiert und wie viele Personen dokumentieren sollen. Sie erhalten innert eines Arbeitstags eine Offerte und auf Wunsch einen Termin für eine geführte Demo.

Ansprechperson
Nils Lappenbusch, Nerd-IT, Buchs ZH
Antwort
Innert eines Arbeitstags, mit Offerte

Öffnet Ihr E-Mail-Programm mit einer vorbereiteten Nachricht an mail@lappenbusch.ch. Es wird nichts automatisch gesendet.