Schnelleinstieg: Den ersten Endpunkt katalogisieren

Der kürzeste Weg von „Plugin ist installiert“ zu „ein Endpunkt steht mit Host, Port, Ordner und Schlagwörtern in einer durchsuchbaren Liste“. Zwei Schritte, etwa fünf Minuten.

Voraussetzungen

wkresource, wkcore und wkstorage sind installiert und aktiviert. Die beiden letzten sind erforderlich, nicht optional.
Sie sind als Superuser angemeldet — der Bildschirm ist Administratoren vorbehalten.
Freiwillig: wkvault. Damit wird die Schreibweise eines vault:-Verweises beim Speichern geprüft; ohne wkvault wird der Verweis ungeprüft übernommen.

Dieses Plugin ist ein Etikett, kein Programm. Es löst kein Geheimnis auf und öffnet keine Verbindung — keine SSH-Sitzung, keine Datenbankabfrage, keinen Azure-DevOps-Aufruf. Es gibt darum bewusst weder eine Schaltfläche Anzeigen noch Verbinden noch Verbindung testen. Wer das erwartet, sucht das falsche Plugin.

Schritt 1: Den Bildschirm öffnen und die Art wählen

Administration → Ressourcen, direkt /doku.php?do=admin&page=wkresource.

Wählen Sie unter Neue Ressource eine Art und dann Weiter. Zur Wahl stehen SSH, RDP, HTTPS, SQL, Azure DevOps und Git. Die Art bestimmt, welche Felder danach erscheinen, und lässt sich später nicht mehr ändern — ein Eintrag der falschen Art wird gelöscht und neu angelegt.

Schritt 2: Den Eintrag ausfüllen

Feld	Was hinein gehört
Id	Der Schlüssel des Eintrags.
Name	Die Beschriftung in der Liste.
Ordner	Die Einordnung, nach der die Liste gefiltert werden kann.
Schlagwörter	Durch Komma getrennt.
Host, Port und die weiteren Felder der Art	Die Verbindungsangaben.
Geheimnis-Verweis	Ein Verweis, nie das Geheimnis selbst: `vault:<id>`, `env:<NAME>`, `file:<pfad>`, `enc:<wert>` oder `plain:<wert>`. Leer lassen, wenn diese Ressource keines braucht.

Wählen Sie Speichern.

Ergebnis prüfen

Der Eintrag steht in der Tabelle Einträge mit Name, Art, Ordner, Schlagwörtern, Geheimnis-Verweis und Änderungszeitpunkt.
In der Spalte Geheimnis-Verweis steht die Verweiszeichenkette selbst, zum Beispiel vault:smtp-postfach — und nicht der Wert. Es gibt keinen Weg, aus dieser Liste an den Wert zu kommen; das Auflösen ist Sache von wkvault, aufgerufen von dem Plugin, das die Verbindung tatsächlich öffnet.
Der Filter über Art, Ordner und Schlagwort grenzt die Liste ein.

Nächster Schritt

wkresource — Referenz: die Felder je Art und die Abgrenzung zu wkvault.
wkvault — den Eintrag anlegen, auf den der Verweis zeigt.