Hitri začetek: prva povezava z Azure DevOps

Najkrajša pot od „vtičnik je nameščen“ do „povezava javlja v redu, v nastavitvah pa ni nobenega žetona“. Štirje koraki, približno petnajst minut.

Predpogoji

wkdoado, wkdocore, wkdostorage in wkcore so nameščeni in vklopljeni.
Razširitev PHP curl je na voljo. Brez nje zaslon javi, da je povezovalnik nedejaven.
Projekt DWDO obstaja — glejte hitri začetek za wkdocore. Brez zapisa o projektu povezave ni mogoče shraniti.
V tem projektu imate vlogo Vzdrževalec. Seznam povezav sme videti tudi bralec, ustvariti pa je ne more.
Osebni dostopni žeton (PAT) organizacije, z najmanjšim možnim obsegom.
Mesto za ta žeton: wkvault ali imenik zunaj korena spleta.

Korak 1: dovolite gostitelja — pred tem ne deluje nič

Skrbništvo → Nastavitve, razdelek wkdoado, nastavitev ado_host_allow.

Seznam je tovarniško prazen, prazno pa prepoveduje vse. To ni filter nad sicer odprtim odjemalcem, temveč celotno dovoljenje, da se klic sploh pošlje.

Vpišite točno ime gostitelja, po eno na vrstico ali ločeno z vejico:

dev.azure.com

Brez nadomestnih znakov, brez vzorcev. Seznam poimenuje mesta, s katerimi ta wiki sme govoriti, vzorec pa bi bil obljuba o mestih, ki jih nihče ni naštel.

Če ime gostitelja kaže na povratni ali zasebni naslov — pri lastni namestitvi običajno — nastavite še ado_allow_private = 1. Na tej namestitvi je ado_host_allow nastavljen na devops.wvds.it, ado_allow_private pa na 1.

Korak 2: žeton shranite tja, kjer se je nanj mogoče sklicevati

Žetona ne vpisujte v nastavitve tega vtičnika. Polja za to namenoma ni.

Ali ga shranite v trezor in se sklicujte nanj (vault:ado-pat-acme), ali pa ado_secret_root nastavite na imenik zunaj korena spleta in žeton tja položite kot datoteko. Tudi ta nastavitev je tovarniško prazna in s tem povsem izklopi sklice na datoteke — v dvomu zaprto, tako kot seznam dovoljenj.

Korak 3: ustvarite povezavo

Povezava pripada natanko enemu projektu DWDO in se zato ne nastavlja v skrbništvu, temveč na strani projekta. Odprite stran projekta in dodajte dejanje:

/doku.php?id=sl:projects:acme:start&do=wkdoado

Izpolnite pod Dodaj povezavo:

Polje	Kaj gre vanj
Ključ	Oznaka povezave; `[A-Za-z0-9_-]`, največ 64 znakov.
Naslov	Napis na seznamu.
Namestitev	`services` za storitev `dev.azure.com`, `server` za lastno namestitev.
Osnovni URL	Osnovni naslov strežnika.
Organizacija (services) / Collection (server)	Glede na namestitev.
Različica API	Privzeto `7.0`.

Izberite Dodaj, nato pa v vrstici povezave prek Nastavi skrivnost vnesite sklic iz koraka 2.

Pri namestitvi server je collection običajno že del osnovnega URL. Če izpolnite še polje Collection (server), se doda drugič in vsak klic se konča s HTTP 404. Collection poimenujte samo na enem mestu.

Korak 4: preizkusite

Izberite Preizkusi v vrstici povezave.

Preverjanje rezultata

Stolpec Stanje je na v redu. Kadar preizkus ne uspe, poimenuje vzrok, namesto da bi izrekel eno samo sodbo — in vzroki res terjajo različne odgovore:

Stanje	Pomen
gostitelj blokiran	Manjka korak 1 ali se ime gostitelja ne ujema natančno.
nedosegljivo	DNS, pot do njega ali zasebni naslov brez `ado_allow_private`.
napaka TLS	Preverjanje potrdila ni uspelo. Preverjanje je vedno vklopljeno; za lasten overitelj obstaja `ado_ca_bundle`.
nepooblaščeno	Žeton je napačen, potekel ali nima potrebnega obsega.

Protipreverba: v nastavitvah wkdoado ni nobenega žetona — samo sklic v povezavi.

Naslednji korak

wkdoadogit — repozitorij te organizacije naredite viden v wikiju.
wkvault — ustvarite vnos v trezorju, na katerega sklic kaže.
wkdoado (v nemščini) — stran paketa: odjemalec, zaščitna plast in vseh osem nastavitev, med njimi meja ado_max_bytes, ki velik rezultat skrajša in ne prenaša v toku.