Avvio rapido: catalogare il primo endpoint

Il percorso più breve da «il plugin è installato» a «un endpoint compare in un elenco consultabile con host, porta, cartella ed etichette». Due passi, circa cinque minuti.

Prerequisiti

wkresource, wkcore e wkstorage sono installati e attivati. Gli ultimi due sono obbligatori e non facoltativi.
Siete autenticati come superuser — la schermata è riservata agli amministratori.
Facoltativo: wkvault. Con esso la sintassi di un riferimento vault: viene verificata al salvataggio; senza, il riferimento viene conservato non verificato.

Questo plugin è un'etichetta, non un client. Non risolve alcun segreto e non apre alcuna connessione — nessuna sessione SSH, nessuna query SQL, nessuna chiamata Azure DevOps. Per questo non esistono, deliberatamente, né mostra, né connetti, né prova la connessione. Chi se li aspetta sta guardando il plugin sbagliato.

Passo 1: aprire la schermata e scegliere il tipo

Amministrazione → Risorse, direttamente /doku.php?do=admin&page=wkresource.

Sotto Nuova risorsa scegliere un Tipo e poi Continua. Sono disponibili SSH, RDP, HTTPS, SQL, Azure DevOps e Git. Il tipo determina quali campi compaiono in seguito e non è più modificabile: una voce del tipo sbagliato si cancella e si ricrea.

Passo 2: compilare la voce

Campo	Che cosa vi va
Id	La chiave della voce.
Nome	L'etichetta nell'elenco.
Cartella	La classificazione con cui l'elenco può essere filtrato.
Etichette	Separate da virgola.
Host, porta e gli altri campi del tipo	I dati di connessione.
Riferimento al segreto	Un riferimento, mai il segreto stesso: `vault:<id>`, `env:<NOME>`, `file:<percorso>`, `enc:<valore>` oppure `plain:<valore>`. Lasciare vuoto se questa risorsa non ne ha bisogno.

Scegliere Salva.

Verifica del risultato

La voce compare nella tabella Voci con nome, tipo, cartella, etichette, riferimento al segreto e data di modifica.
Nella colonna Riferimento al segreto compare la stringa del riferimento stessa, per esempio vault:mail-smtp — e non il valore. Da questo elenco non c'è alcuna via verso il valore; risolverlo è compito di wkvault, chiamato dal plugin che apre davvero la connessione.
Il filtro per Tipo, Cartella ed Etichetta restringe l'elenco.

Passo successivo

wkvault — creare la voce a cui il riferimento punta.
wkresource (in tedesco) — la pagina del pacchetto: i campi per tipo e la delimitazione rispetto a wkvault.