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, wkstorage in wksqliteds so nameščeni in vklopljeni. Trezor se prijavi prek registra wkcore, vnose shranjuje prek wkstorage, vsako poizvedbo pa izvede wksqliteds; vsi trije so obvezni. Brez wksqliteds se trezor izklopi.
Prijavljeni ste kot superuser – zaslon je pridržan skrbnikom.
Vaš račun ima nastavljen drugi dejavnik. Ustvarjanje, zamenjava in brisanje ga zahtevajo v tekoči seji; brez njega predal ponudi le Dokaži zdaj.
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 je 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 je zapisana 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. Izberite ukaz Nov vnos; predal Ustvari ali zamenjaj vpraša:

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 je na seznamu s stanjem v redu. Sama vrednost nikjer ni vidna – tudi vam ne.
V nastavitvah vtičnika, ki ga uporablja, je zapisano 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 je nato 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 – stran paketa: vse vrste sklicev, zamenjava s predajo, potek.