Resource (wkresource)
Resource je imenik podatkov o povezavah za končne točke SSH, RDP, HTTPS, SQL, Azure DevOps in Git – gostitelj, vrata, mapa, ključne besede. Skrivnost za dostop je v vnosu samo kot sklic, nikoli kot vrednost; ta paket je nikoli ne razreši. Namenjen je upraviteljem, ki končne točke upravljajo na enem mestu, in paketom, ki povezavo poiščejo, ne da bi videli dostopne podatke.
Prvi koraki
Hitri začetek: katalogizacija prve končne točke – najkrajša pot do prvega rezultata, v dveh korakih.
Pogosta opravila
| Kaj želite | Za koga | Kje to naredite | Navodilo |
|---|---|---|---|
| vpisati ali spremeniti končno točko | upravitelji | Skrbništvo > Viri | Nastavitve |
| shraniti skrivnost, ne da bi bila tu | upravitelji | sklic na wkvault | Najprej meja |
| določiti, kdo sme videti imenik | upravitelji | Skrbništvo > Viri | Zaščita |
| preveriti, ali paket ustreza vaši vlogi | vsi | – | Ciljna skupina |
| vedeti, česa paket ne zmore | upravitelji | – | Meje |
Najprej meja
Meja je na začetku, ker je prav ona razlog, da lahko ta paket brez tveganja uporabljate skupaj z
wkvault.
- Ta paket nikoli ne razreši skrivnosti. Polje
secretRefse shrani in prikaže kot niz,
kakršen je (vault:mail-smtp, env:SMTP_PASS), in nobena vrstica tega paketa iz njega
nikoli ne naredi dostopnih podatkov, ki jih poimenuje. Ni ukaza »Pokaži«, ni »Poveži«, ni preizkusa povezave. * **Ta paket ne odpre nobene povezave.** Je oznaka, ne odjemalec. * Razreševanje sklica je naloga paketa ''wkvault'' in ga sproži paket, ki povezavo dejansko vzpostavi – ne ta.
Katalog tako ni drugo mesto, kjer bi lahko ušli dostopni podatki. Iz zbirke podatkov tega paketa je mogoče razbrati imena gostiteljev in vrata – in sklice, ki brez trezorja ne razkrijejo ničesar.
Ciljna skupina
Upravljavci namestitev DokuWiki, ki upravljajo več kot peščico končnih točk in jih želijo imeti na enem mestu, opisane, v mapah in s ključnimi besedami.
Odvisnosti
| Paket | Potreben? | Brez njega |
|---|---|---|
wkcore | da | Nič se ne razreši. |
wkstorage | da | Ni shrambe. |
wksqliteds | da | Katalog se izklopi: vsaka poizvedba teče prek tega paketa. |
wkvault | ne | Sklici ostanejo nizi – kar tu tako ali tako so. Trezor potrebuje šele porabnik, ki povezavo odpre. |
wkidentity | ne | Brez njega velja samo seznam dostopa DokuWiki; z njim ustvarjanje in spreminjanje zahtevata stopnjo AUTHENTICATED, brisanje MFA_ANY. |
wkfluentui | da | Zaslon pokaže le obvestilo, da gradnik vmesnika manjka. |
Zaščita
Od 8. avgusta 2026 je zavarovan prek Identity Plugin Contract v1, po istem dodajalnem vzorcu kot
wkvault: most do=wkresource_stepup s trdno določenim seznamom kategorij, kategoriji
create/update z najnižjo stopnjo AUTHENTICATED, delete z MFA_ANY – tako kot
brisanje v trezorju, ker izbrisan vnos nima zgodovine različic.
Preverjanje velja dodatno k seznamu dostopa DokuWiki, nikoli namesto njega. Če wkidentity ni
nameščen, se paket vede nespremenjeno – zavestna, dokumentirana meja, ne skrito vedenje.
Nastavitve
Ena nastavitev, v Splošnih nastavitvah pod wkresource:
| Ključ | Privzeto | Učinek |
|---|---|---|
log_keep_days | 365 | Koliko dni se hrani dnevnik dostopov. Starejše vrstice odstrani zagon čiščenja. Zagon je vezan na indekser wikija – na namestitvi z malo prometa se čisti redko, in hramba je tedaj dejansko daljša, kot pove vrednost. 0 ali manj čiščenje povsem izklopi. |
Drugega ni. Predvsem ni nastavitve, ki bi lahko vklopila razreševanje sklica na skrivnost – ta paket tega ne zmore, in to ni privzeta vrednost, temveč lastnost (glejte »Najprej meja«).
Meje in znane omejitve
- Čiščenje dnevnika dostopov je vezano na indekser wikija, tako kot pri trezorju: wiki z
malo prometa se čisti redko.
- Vnos nima zgodovine različic. Izbrisano je izbrisano – zato je brisanje za stopnjo višje od
spreminjanja.
Nadaljnje branje
Celoten tehnični opis je pri paketu samem: README.md, docs/api-reference.md in
docs/threat-model.md v mapi lib/plugins/wkresource/.
- wkvault – trezor, ki razreši sklice tega kataloga
- wkidentity – platforma za zagotovilo, prek katere je zavarovano brisanje