Hitri začetek: shranjevanje prve skrivnosti in sklic nanjo

Najkrajša pot od „vtičnik je nameščen“ do „drug vtičnik dela s sklicem namesto z geslom“. Trije koraki, približno deset minut.

Predpogoji

wkvault, wkcore in wkstorage so nameščeni in vklopljeni. Trezor se prijavi prek registra wkcore, vnose pa shranjuje prek wkstorage; oboje je obvezno.
Prijavljeni ste kot superuser — zaslon je pridržan skrbnikom.
PHP 8.2 ali novejši.

Korak 1: odločite se o viru ključa — pred prvim vnosom

Skrbništvo → Nastavitve, razdelek wkvault, nastavitev keysource.

Vrednost	Kje leži ključ
`salt` (privzeto)	Izpeljan iz soli namestitve v `data/meta/`. Varnostna kopija podatkovnega imenika torej vsebuje ključ in šifrirane vrednosti.
`env`	V okoljski spremenljivki, poimenovani v `keysource_ref` — zunaj podatkovnega imenika in zunaj varnostne kopije wikija.
`file`	V datoteki s ključem, katere pot stoji v `keysource_ref`; smiselno zunaj korena spleta. Mora potovati z namestitvijo.

Poznejša sprememba je nenevarna — vsak vnos nosi prstni odtis ključa, s katerim je bil šifriran, in zaslon tedaj ponudi ponovno šifriranje. Zavestna izbira zdaj vam ta tek prihrani.

Korak 2: ustvarite vnos

Skrbništvo → Trezor, neposredno /doku.php?do=admin&page=wkvault. Razdelek Ustvari ali zamenjaj:

Polje	Kaj gre vanj
Oznaka	Ključ, na katerega kažejo sklici. Izberite obstojnega in govorečega, na primer `mail-smtp`.
Skrivnost	Vrednost. Pred shranjevanjem se šifrira.
Opis	Za tistega, ki bo seznam bral pozneje. Neobvezno.
Poteče, Zamenjaj vsakih … dni	Neobvezno; krmilita stanje, prikazano na seznamu.

Korak 3: sklicujte se nanjo iz drugega vtičnika

Povsod, kjer drug vtičnik zahteva geslo, namesto vrednosti vpišite:

vault:mail-smtp

Na voljo je pet vrst sklicev:

Sklic	Se razreši v
`vault:<oznaka>`	Vnos v tem trezorju.
`env:<IME>`	Okoljsko spremenljivko.
`file:<pot>`	Vsebino datoteke, samo pod nastavljenim korenom.
`enc:<vrednost>`	Vrednost, šifrirano na mestu, brez vnosa v trezorju.
`plain:<vrednost>`	Točno to, kar piše.

plain: obstaja, da je sklic vedno enoznačen. Brez njega bi se dobesedno geslo, ki bi po naključju vsebovalo dvopičje, bralo kot vrsta sklica.

Preverjanje rezultata

Vnos stoji na seznamu s stanjem v redu. Sama vrednost nikjer ni vidna — tudi vam ne.
V nastavitvah vtičnika, ki jo uporablja, stoji vault:mail-smtp in ne geslo.
Sprožite funkcijo, ki skrivnost potrebuje — pri wkmail denimo preizkusno sporočilo. V zapisu o dostopih na zaslonu trezorja nato stoji vrstica z izvajalcem, vnosom, opravilom in izidom. Zapis nikoli ne vsebuje vrednosti; prav v tem je njegov smisel.

Naslednji korak

wkmail — prvi smiseln uporabnik.
wkresource — katalog končnih točk, ki nosi samo sklic in nikoli vrednosti.
wkvault (v nemščini) — stran paketa: vse vrste sklicev, zamenjava s predajo, potek.