Brzi početak: prva veza prema Azure DevOps

Najkraći put od „dodatak je instaliran“ do „veza javlja u redu, a nijedan token ne stoji u postavkama“. Četiri koraka, otprilike petnaest minuta.

Preduvjeti

wkdoado, wkdocore, wkdostorage i wkcore su instalirani i uključeni.
PHP proširenje curl postoji. Bez njega zaslon javlja da je konektor neaktivan.
DWDO projekt postoji — vidi brzi početak za wkdocore. Bez zapisa o projektu veza se ne može spremiti.
U tom projektu imate ulogu Održavatelj. Popis veza smije vidjeti i čitatelj, ali je ne može stvoriti.
Osobni pristupni token (PAT) organizacije, s najmanje mogućih ovlasti.
Mjesto za taj token: wkvault ili direktorij izvan korijena weba.

Korak 1: dopustite poslužitelj — prije toga ništa ne radi

Administracija → Postavke, odjeljak wkdoado, postavka ado_host_allow.

Popis je tvornički prazan, a prazno zabranjuje sve. Nije to filtar nad inače otvorenim klijentom, nego cjelokupno dopuštenje da se poziv uopće uputi.

Upišite točno ime poslužitelja, po retku ili odvojeno zarezom:

dev.azure.com

Bez zamjenskih znakova, bez uzoraka. Popis imenuje mjesta s kojima ovaj wiki smije razgovarati, a uzorak bi bio obećanje o mjestima koja nitko nije nabrojio.

Pokazuje li ime poslužitelja na povratnu ili privatnu adresu — kod vlastite instalacije redovit slučaj — postavite dodatno ado_allow_private = 1. Na ovoj je instalaciji ado_host_allow postavljen na devops.wvds.it, a ado_allow_private na 1.

Korak 2: pohranite token ondje gdje se na njega može uputiti

Nemojte token upisivati u postavke ovog dodatka. Polja za to namjerno nema.

Ili ga pohranite u trezor i uputite na njega (vault:ado-pat-acme), ili postavite ado_secret_root na direktorij izvan korijena weba i token ondje položite kao datoteku. I ta je postavka tvornički prazna te time posve isključuje reference na datoteke — zatvoreno u dvojbi, kao i popis dopuštenja.

Korak 3: stvorite vezu

Veza pripada točno jednom DWDO projektu i zato se ne postavlja u administraciji, nego na stranici projekta. Otvorite stranicu projekta i dodajte radnju:

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

Ispunite pod Dodaj vezu:

Polje	Što ide u njega
Ključ	Oznaka veze; `[A-Za-z0-9_-]`, najviše 64 znaka.
Naslov	Natpis na popisu.
Izvedba	`services` za uslugu `dev.azure.com`, `server` za vlastitu instalaciju.
Osnovni URL	Osnovna adresa poslužitelja.
Organizacija (services) / Collection (server)	Ovisno o izvedbi.
Verzija API-ja	Zadano `7.0`.

Odaberite Dodaj, a zatim u retku veze preko Postavi tajnu upišite referencu iz koraka 2.

Kod izvedbe server collection je obično već dio osnovnog URL-a. Ispunite li uz to i polje Collection (server), dodaje se drugi put i svaki poziv završava s HTTP 404. Imenujte collection samo na jednom mjestu.

Korak 4: testirajte

Odaberite Testiraj u retku veze.

Provjera rezultata

Stupac Stanje stoji na u redu. Kada test ne uspije, imenuje uzrok umjesto da izrekne jednu presudu — a uzroci doista traže različite odgovore:

Stanje	Značenje
poslužitelj blokiran	Nedostaje korak 1 ili se ime poslužitelja ne podudara točno.
nedostupno	DNS, put do njega, ili privatna adresa bez `ado_allow_private`.
TLS greška	Provjera certifikata nije uspjela. Provjera je uvijek uključena; za vlastito tijelo za izdavanje postoji `ado_ca_bundle`.
neovlašteno	Token je pogrešan, istekao ili nema potreban opseg.

Protuprovjera: u postavkama wkdoado nema tokena — samo referenca u vezi.

Sljedeći korak

wkdoadogit — učinite repozitorij te organizacije vidljivim u wikiju.
wkvault — stvorite unos u trezoru na koji referenca pokazuje.
wkdoado (njemački) — stranica paketa: klijent, zaštitni sloj i svih osam postavki, među njima granica ado_max_bytes koja velik rezultat skraćuje, a ne prenosi u tijeku.