Spremembe

Beta različica: Podatkovni prehod je objavljen kot beta različica. Funkcije, konfiguracija in vmesniki se lahko do prve izdane različice še spremenijo.

Spremembe za uporabnike, skrbnike in programe. Podatkovni prehod je objavljen kot predogled in še nima izdane različice, zato ta stran navaja datirane posodobitve predogleda in različice paketa specifikacije vmesnika Wkl.Data.Gateway.Contracts, ki ga uporabljajo programi in odjemalec .NET. Strani reference pri novosti v specifikaciji vmesnika navedejo različico, od katere velja (oznaka “od specifikacije vmesnika 0.x”).

• Neuspela posodobitev: Če se posodobitev prekine, prejšnja različica nato deluje kot prej: je registrirana ter ima svojo konfiguracijo, pravilo požarnega zidu in shrambo. Doslej sta ji v tem primeru manjkali konfiguracija in registracija, storitev pa se ni zagnala.
• Shramba za upravljanje: Nove namestitve ustvarijo shrambo kot dbgwsvc.db in datoteko dnevnikov kot dbgwsvc-logs.db; prej gateway.db in gateway-logs.db. Posodobitev obstoječi datoteki v podatkovni mapi preimenuje; če se posodobitev razveljavi, datoteki znova dobita prejšnji imeni. Shramba, ki je ročno nastavljena drugje (Gateway:Store:Path), obdrži svoje ime.
• Varnostne kopije: backup-store --to-folder in varnostna kopija iz aplikacije za upravljanje poimenujeta kopijo po shrambi, torej dbgwsvc-<čas>.db; varnostne kopije s prejšnjim imenom ostanejo veljavne.
• Pomožna skripta v programski mapi: dbgwsvc-Erster-Administrator.cmd in dbgwsvc-Zertifikat-LetsEncrypt.cmd, prej brez dbgwsvc-.
• Storitev WKL Database Update: Program se imenuje dbgwupd.exe, prej Wkl.Data.Update.exe; ukazi se glasijo na primer dbgwupd.exe status kunden. Storitev Windows obdrži ime Wkl.Data.Update in s tem račun NT SERVICE\Wkl.Data.Update; njegove prijave v podatkovne zbirke še naprej veljajo.

• Vgrajene e-poštne predloge: Tri vgrajene predloge imajo svetlo glavo z logotipom partnerja (src="cid:brand") in spodaj znak The White Knight Labs (src="cid:logo"); odjemalec priloži obe sliki. Skrbniška shramba ima s tem različico sheme 28: ob zagonu dobi novo besedilo vsaka vgrajena predloga, ki ima še doslej dobavljeno besedilo; predloga, ki jo je spremenil skrbnik, ostane nespremenjena.

• Omejitev zahtev: Kvota na klicatelja se obnavlja sproti (RateLimit:PerCaller na WindowSeconds, privzeto 1.200 na minuto, torej 20 na sekundo), namesto naenkrat ob koncu fiksnega obdobja; po premoru je naenkrat prostih do RateLimit:Burst zahtev (privzeto 600). Klicatelj, ki dela naprej, se upočasni na hitrost, namesto da bi bil do konca minute zavrnjen. Vsak 429 omejitve v Retry-After pove, kdaj bo naslednja zahteva sprejeta; gonilnik ODBC od različice 0.8.2 toliko počaka in bere naprej.
• Revizija: Gateway:AuditLog:Days je privzeto 365 dni (prej 90); to pokrije na primer šest mesecev, ki jih za varnostne dnevnike zahteva slovenski ZInfV-1. Ko datoteka dnevnikov doseže svojo velikost, prehod najprej odstrani najstarejše vnose; glejte Konfiguracija.
• Hramba in velikost datoteke v skrbništvu: Nastavitvi audit_days (1–3650 dni) in log_max_megabytes (64–65.536 MB) množice Settings imata prednost pred Gateway:AuditLog:Days in Gateway:Store:LogMaxMegabytes in veljata brez ponovnega zagona; vrednost zunaj meja je zavrnjena s sporočilom. ServiceStatus na novo navaja LogMaxMegabytes. Skrbniška shramba ima s tem različico sheme 27; ob zagonu se samodejno pretvori.
• GET /odata/v4 brez aliasa: Seznam aliasov znova pride s 200; prej je prehod odgovoril s 400 in v dnevnik zapisal izjemo.
• Programska datoteka dbgwsvc.exe: Program prehoda se imenuje dbgwsvc.exe (z dbgwsvc.dll) namesto Wkl.Data.Gateway.exe; z njim kličete vse ukaze, na primer dbgwsvc.exe init-admin. Posodobitev zamenja staro datoteko in pot v storitvi. Ime storitve, račun storitve, podatkovna mapa in vir dogodkov ostanejo Wkl.Data.Gateway.

• Preizkus povezave: Pri strežniku SQL Server na istem računalniku preizkus manjkajočo prijavo ali podatkovno zbirko zdaj zanesljivo javi kot tako (18456 oziroma 4060), ne več kot omrežno napako 233. Po 233 poskusi takoj znova in nato tretjič po 250 ms; strežnik, ki res ni dosegljiv, tako stane 250 ms več.
• Sporočila: Sporočila, napotki in izpis prehoda nemške preglase in ß zdaj pišejo kot take (“Schlüssel”, “lässt”, “für”) namesto “ae”, “oe”, “ue”, “ss”. Programi, ki primerjajo besedilo sporočila, naj vrednotijo kodo stanja HTTP ali polje code, ne besedila. Vrednosti revizijske sledi, kot sta “geaendert” in “geloescht”, ostanejo nespremenjene.

• Površina OData pri branju brez $top upošteva Prefer: odata.maxpagesize=n: strani do MaxTop, potrjeno v Preference-Applied, naslednje strani kot doslej. Odjemalec, ki bere samo ključe, potrebuje desetino zahtev. Brez glave se nič ne spremeni.

• Obseg ključa množice upravljanja, razvrščen po ključu, se zdaj prebere v shrambi upravljanja. Primer je ChangeLog?$filter=Id le 62030&$orderby=Id desc. Prej je prehod za vsako okno prebral celotno tabelo. Pri 62.000 vnosih je to stalo približno 1,5 s na okno, najnovejših 1.000 vnosov prek gonilnika ODBC pa 3,4 s.
• Rezultat in vrstni red ostaneta enaka. Druge pogoje prehod kot doslej obdela v pomnilniku.

• Poizvedba po AuditEntries z Reason ne null (samo zavrnjene zahteve) zdaj omeji že datoteko dnevnika, tako kot doslej obdobje in oseba. Zgornja meja 20.000 vnosov na poizvedbo tako velja za zavrnitve; prej so lahko starejše zavrnitve manjkale, če so novejše odobrene zahteve zapolnile mejo (na primer pri zavrnitvah osebe z veliko zahtevami v skrbniški aplikaciji).

• Množica ServiceStatus upravljanja navede, kako daleč nazaj segajo dnevniki: AuditDays (hramba dnevnika dostopov), AuditOldestAt (najstarejši shranjeni dostop) in SignInEventDays (hramba dogodkov prijave). Aplikacija za upravljanje lahko z njimi navede obdobje strani z dnevnikom, namesto da piše “od zagona prehoda”.

• Vnos, katerega ključ vsebuje poševnico (na primer omrežni obseg 10.0.0.0/8 pravila za prijavo ali pot), je zdaj mogoče prebrati, spremeniti in odstraniti prek njegovega naslova. Poševnica prispe kodirana kot %2F; prehod vnosa doslej ni našel in je odgovoril z 404, kar je Access sporočil kot spor pri pisanju (napaka 3197). To velja za upravljanje in za podatkovni vmesnik. Vrednost, ki sama vsebuje znake %2F, ostane nespremenjena.

• Različica vrstice (Version) množice zajema le še vrednosti same vrstice. Števila in imena iz drugih množic (Persons.Rules, ClientRules.Holders, Person v PersonRules, PersonalKeys in SessionTokens, DataSource in Role dodelitev identitet) je ne spreminjajo več. Prej se je brisanje osebe takoj po brisanju njenih pravil v Accessu končalo s konfliktom pri pisanju (3197), prav tako urejanje, medtem ko je nekdo dodeljeval pravilo.

• Persons ima polji LastSignInAt in LastSignInMethod (zadnja uspešna prijava, samo za branje) ter LeftAt (izstop, nastavi ga skrbništvo). Z njimi je mogoče dokazati neuporabljene dostope in čas od izstopa do zaklepa. Skrbniška shramba za to dobi shemo 26.

• SessionTokens ima polji EndReason in EndedBy: kako se je seja drugega faktorja končala (končana v skrbništvu, oseba zaklenjena, ključ preklican, drugi faktor na novo nastavljen ali odstranjen, potekla) in kdo jo je končal. Ko skrbništvo zaklene osebo ali prekliče ključ, se seje te osebe oziroma tega ključa končajo v istem koraku. Seje se ne brišejo več, ko je drugi faktor na novo nastavljen ali odstranjen. Skrbniška shramba za to dobi shemo 25.

• AuditEntries ima dve novi polji: Target navede, kaj je zahteva naslovila (pot in poizvedba, na primer …/Vertraege(17) ali …?$filter=Nr eq 17), AccessRule pa pravilo dostopa, ki je dovolilo dostop do tabele ali pogleda, na katerega je prehod odgovoril, skupaj z njegovo različico. ClientRules v RuleVersion pokaže današnjo različico vsakega pravila. Obstoječa datoteka dnevnikov dobi oba stolpca ob zagonu; v starejših vnosih ostaneta prazna. Glejte Sledenje odločitvi o dostopu.

• Namestitveni program in paket MSI v mapo programa namestita sbom.cdx.json: kosovnico za programsko opremo (SBOM) v obliki CycloneDX 1.6 z vsako nameščeno datoteko in njeno kontrolno vsoto ter vsebovanimi komponentami tretjih oseb. Vsaka dobava jo vsebuje tudi kot Wkl.Data.Gateway-<različica>.sbom.cdx.json. Glejte Namestitveni paket.

• test-connection: Zavrnjena prijava v SQL Server v istem računalniku je včasih prispela kot 233 s failure: Network (“strežnika podatkovne zbirke ni bilo mogoče doseči”), čeprav je manjkala prijava ali podatkovna zbirka. Preizkus zdaj odpre povezavo brez bazena povezav in po 233 takoj še enkrat; nato sporoči Login (18456) ali Database (4060). Glejte Skrbniški vmesnik.

• Dnevnik dostopov (revizija) ostane tudi po ponovnem zagonu: s skrbniško shrambo ga prehod enkrat na minuto zapiše v datoteko dnevnikov in ga hrani Gateway:AuditLog:Days dni (privzeto 90). AuditEntries bere iz nje; doslej je hranil le zadnjih 10.000 vnosov od zagona. Glejte Gateway:AuditLog.
• Vsak dnevnik je mogoče izklopiti, privzeto so vsi vklopljeni: dnevnik dostopov z Gateway:AuditLog:Enabled, dnevnik sprememb z Gateway:Store:ChangeLog, dnevnik prijav in dnevnik obremenitve kot doslej z Gateway:SignInLog:Enabled in Gateway:LoadLog:Enabled.

• Namestitveni program najprej odpre okno Izbira jezika (vnaprej je izbran jezik prikaza sistema Windows) in nato prikaže vse strani in sporočila v nemščini, angleščini ali slovenščini; doslej le v nemščini. Predlagano ime namestitve sledi jeziku; lastnosti in ukazna vrstica so enake. Glejte Namestitev podatkovnega prehoda.
• Paket MSI vsebuje iste tri jezike: pogovorna okna v nemščini, s TRANSFORMS=:1033 v angleščini, s TRANSFORMS=:1060 v slovenščini. Glejte Namestitveni paket.

• Lastni stavki: stolpec brez imena (SELECT COUNT(*) …, SELECT 1 …) ali z že uporabljenim imenom ima ime iz podatkovne zbirke še v label (prazno oziroma ponovljeno ime); name ostane ključ vrednosti v vrsticah (Column2, Nummer1). Gonilnik ODBC tako prikaže ista imena kot ODBC Driver 18. Glejte HTTP: specifikacija vmesnika.
• Ponudnik SQL Server 1.8.0 (zahteva specifikacijo ponudnika 1.7).

• Preverjeni stavki sprejmejo del datuma v DATEPART, DATEADD, DATEDIFF, DATENAME, DATETRUNC in DATE_BUCKET (DATEPART(month, Datum), DATEADD(day, 30, Datum)). Doslej jih je storitev zavračala z 403 (“Die Form 'IdentifierLiteral' …”), čeprav so funkcije dovoljene; prek gonilnika ODBC Driver 18 so delovali.

• hierarchyid, geography in geometry so zdaj v dokumentu metapodatkov in pri vsakem branju, kot binarna vrednost s shranjenimi bajti – istimi, kot jih vrne ODBC Driver 18. sql_variant je zapisan kot besedilo v obliki svojega osnovnega tipa. Doslej so ti stolpci manjkali, lasten stavek s takim stolpcem pa se je končal z 503. Glejte Časovne točke, števila in imena.
• OData: primerjavo v $filter ali razvrščanje v $orderby po stolpcu, ki ga SQL Server tako ne primerja ali razvršča (text, ntext, image, xml, prostorski tipi, sql_variant), storitev zavrne z 400. Doslej je podatkovna zbirka vrnila 422, pri sql_variant pa brez opozorila prazen odgovor.
• Lastni stavki: columns navaja ime tipa v podatkovni zbirki (storeType) in označi identitetni stolpec ("identity": true).

• Novo: storitev “WKL Database Update” z lastnim namestitvenim paketom Wkl.Data.Update-<različica>.msi. Podpisane pakete posodobitev podatkovnih zbirk namešča tam, kjer podatkovni prehod ne teče, po enakih pravilih kot modul za posodobitve. Brez connection.secret se prijavi s svojim računom Windows. Upravljate jo na strežniku z Wkl.Data.Update.exe v ukaznem pozivu s skrbniškimi pravicami; glejte Storitev WKL Database Update. Pošto poti email pošilja prek poštnega strežnika, ki ga določa mail v zaščiteni konfiguraciji, vedno šifrirano (TLS na vratih 465, sicer STARTTLS).
• Modul za posodobitve zdaj sprejme zaščitene konfiguracije, ki se začnejo z oznako vrstnega reda bajtov (UTF-8 z BOM, kot jih zapiše Windows PowerShell 5.1 z Set-Content -Encoding UTF8); doslej je podatkovno zbirko izločil kot “ni veljaven JSON”.

• Poskus, na katerega strežnik ne da berljivega odgovora (503), zdaj šteje kot neuspel poskus prijave SQL in njenega izvora. Če SQL Server teče na istem računalniku in je dosegljiv prek Shared Memory ali Named Pipes, je prva zavrnitev po nalaganju ponudnika prispela kot 503 namesto 401, čeprav je strežnik geslo preveril; taki poskusi so doslej ušli omejitvi 5 na prijavo in 20 na izvor v eni minuti.
• Ob dejanskem izpadu strežnika prehod po 5 poskusih ene prijave do konca minute odgovarja z 429 namesto 503.

• Zahteve, ki spreminjajo stanje (POST, PUT, PATCH, DELETE) in jih brskalnik pošlje v imenu drugega spletnega mesta, podatkovni prehod zavrne s kodo stanja 403 in kodo FORBIDDEN. Pri tem se ravna po glavi Sec-Fetch-Site brskalnika; če je ni, mora glava Origin navesti shemo, gostitelja in vrata zahteve. Doslej je lahko tuje spletno mesto take zahteve sprožilo s prijavo Windows ali zapomnjenim geslom, ki ju brskalnik pošlje sam.
• Programi, ki niso brskalniki (gonilnik ODBC, odjemalec .NET, Excel, Power BI, skripti), teh glav ne pošiljajo, zato sprememba nanje ne vpliva.
• Telo zahteve, ki spreminja stanje, mora nositi glavo Content-Type: application/json (naložene datoteke application/octet-stream); sicer prehod odgovori s kodo stanja 400 in kodo BAD_REQUEST. Izjema so možnosti poizvedbe v $query kot text/plain. Gonilnik, odjemalec .NET in skrbniška aplikacija jih že pošiljajo tako; skripti, ki pošljejo telo brez vrste (na primer curl -d brez -H), jo morajo dodati.

• Modul za posodobitve namešča podpisane posodobitve v podatkovne zbirke, za katere ima mapa `Gateway:Updates` zaščiteno konfiguracijo: združljive pakete takoj ali po potrditvi, nezdružljive pa po napovedi delujočim aplikacijam, ko ne teče več nobena starejša različica.
• Novi skrbniški ukazi: update-databases, update-status, update-history, confirm-update, dismiss-update, retry-update, move-update-deadline, cancel-update-notice, upload-update (posodobitve podatkovnih zbirk).
• Nastavitve delovanja za posamezno podatkovno zbirko so shranjene v skrbniški shrambi (različica sheme 21) in se spreminjajo v množici UpdateSettings: potrditev za združljive in nezdružljive pakete, čas vnaprejšnje napovedi, časovno okno za odprte seje.
• Modul sporoči, kaj se zgodi s paketom, v dnevnik dogodkov (ID-ji dogodkov 4101–4106) in po želji v datoteko za vsak dan pod %ProgramData%\Wkl.Data.Gateway\logs\updates (sporočila); skrbniška shramba, različica sheme 22.
• Modul po želji sporoča tudi po pošti, prek poštnih nastavitev storitve (Gateway:Mail), prejemnikom podatkovne zbirke (NotifyEmail, NotifyEmailTo v UpdateSettings); skrbniška shramba, različica sheme 23.
• Modul po vsaki varnostni kopiji počisti stare kopije iste podatkovne zbirke (BackupKeepCount, BackupKeepDays v UpdateSettings), če doseže mapo varnostnih kopij (hramba varnostnih kopij); skrbniška shramba, različica sheme 24.
• setup-host (namestitveni paket) v podatkovni mapi ustvari mapo updates, ki jo spreminjajo samo skrbniki in sistem, račun storitve pa jo bere, in jo nastavi kot Gateway:Updates:Folder.

• setup-host --mode iis (namestitveni paket z GW_MODE=iis) nastavi AuthMode na PersonalKey. Doslej je bila prijava Windows vklopljena tudi za strežnikom IIS. Prijava Windows velja za povezavo, IIS z Application Request Routing pa svoje povezave do prehoda deli med uporabniki; zahteva ene osebe je tako lahko potekala s prijavo druge. Obstoječa namestitev za strežnikom IIS pri posodobitvi izgubi prijavo Windows; osebe se prijavijo z osebnim ključem.
• Če AuthMode vsebuje Windows in TrustedProxies navaja posredniški strežnik, prehod ob zagonu v dnevnik zapiše opozorilo.

• save-person pri obstoječi osebi spremeni samo navedeno. Doslej je ukaz brez --login odstranil prijavo SQL Server in brez --disabled osebo znova vklopil. Novo: --no-login, --no-rules in --enabled; brez --rule pravila ostanejo.
• save-person zavrne pravilo, ki ga ni v skrbniški shrambi, in navede obstoječa. Doslej oseba zaradi tipkarske napake ni dobila pravic, vsaka poznejša sprememba v skrbništvu pa se je končala z 422.
• init-admin uporabi samo pravilo, ki dovoljuje vse metode skrbništva, admin-status pa za skrbnike šteje samo osebe s takim pravilom.

• Vrednost stolpca decimal ali numeric z več kot 28 števkami, do 38 števk tipa decimal(38, s), se prebere in zapiše z vsemi števkami. Doslej se je branje takšne vrstice končalo z 503, pisanje pa je vrednost zavrnilo z 400; znesek z 29 števkami se je pri pisanju tiho zaokrožil na 28.

• Znesek, ki ga zahteva za pisanje v telesu pošlje v eksponentnem zapisu (1.2345678901234567890E2), pride v decimalni stolpec z vsemi števkami. Doslej je šel skozi število s plavajočo vejico in se je zaokrožil na 15 veljavnih mest (123.456789012346). Stolpci s plavajočo vejico in besedilni stolpci prejmejo enako vrednost kot doslej; argumenti procedure se še naprej vežejo kot float.

• test-connection odpre povezavo natanko enkrat. Doslej je gonilnik podatkovne zbirke po napaki, kot je 4060 (podatkovne zbirke ni mogoče odpreti), po 10 sekundah sam poskusil še enkrat, preizkus pa je sporočil izid tega drugega poskusa. To ni bil vedno odgovor strežnika: manjkajoča podatkovna zbirka se je občasno pokazala kot omrežna napaka 233 (failure Network namesto Database). Zdaj preizkus sporoči prvi odgovor, brez 10-sekundnega čakanja. Ponovni poskusi pri zahtevah za vir podatkov ostanejo nespremenjeni.

• Namestitveni program 1.0.8 se je po kliku Weiter (naprej) na strani Willkommen (dobrodošli) zaprl brez sporočila: v programu sta manjkali nemška in slovenska različica licenčnih pogojev. Od naslednjega namestitvenega programa so vključene vse tri različice.

• Podatkovni prehod se zdaj v vseh jezikih imenuje WKL Database Gateway. Tako je naveden v namestitvenem programu, v “Aplikacije in funkcije”, v meniju Start, kot prikazno ime storitve Windows, v lastnostih datotek ter v licenčnih pogojih, varnostnih informacijah in podatkih o proizvajalcu.
• Tehnično ime Wkl.Data.Gateway ostane: ime storitve, programske datoteke, paketi, mape in vir dogodkov se ne spremenijo. Skripti in sistemi za nadzor, ki uporabljajo ime storitve, delujejo naprej.

• GET /schema-state/{alias}/{izdelek} vrne stanje sheme podatkovne zbirke z različicami, da WKL Bootstrapper ponudi samo ustrezne različice aplikacije; prijava z Windows, brez prijave samo z Gateway:SchemaState:Anonymous. Glejte HTTP: specifikacija vmesnika.
• X-Wkl-Application: aplikacije sporočijo izdelek in različico; storitev si za vsak alias zapomni, katera različica je nazadnje poslala zahtevo. Glejte HTTP: specifikacija vmesnika.
• Priloženi ponudnik za SQL Server ima različico 1.3.0.

• Proizvajalec EMSR DATA, D.O.O. Lastnosti datotek, paket, namestitveni program in “Programi in funkcije” navajajo podjetje EMSR DATA, D.O.O. namesto “The White Knight Labs”, skupaj s kontaktom in spletnim mestom. Identifikatorji ostanejo enaki: ime storitve Windows Wkl.Data.Gateway, mapa programa, ID-ji paketov; posodobitev prepozna obstoječo namestitev.
• Nove datoteke v mapi programa. THIRD-PARTY-NOTICES.txt s komponentami tretjih oseb in njihovimi licencami, obvestila izvajalnih okolij .NET ter SECURITY.md (prijava ranljivosti, podprte različice) in MANUFACTURER.md (podatki o proizvajalcu), vsaka v angleščini, nemščini in slovenščini; glejte Namestitveni paket.
• Licenčni pogoji. Namestitveni program in paket pred namestitvijo prikažeta licenčne pogoje družbe EMSR DATA; nadaljevati je mogoče le s strinjanjem. V mapi programa in v vsakem paketu NuGet so kot LICENSE.md (zavezujoča, angleška), LICENSE.de.md in LICENSE.sl.md; glejte Namestitev podatkovnega prehoda.
• Podpisane vse lastne knjižnice. Poleg programa, paketa in namestitvenega programa je v dobavi zdaj podpisana tudi vsaka lastna knjižnica izdelka (Wkl.*.dll), vključno s ponudniki.

• $metadata skrbništva brez Aggregation.ApplySupported. Skrbništvo zavrne $apply, vendar ga je deklariralo. Gonilnik ODBC je zato MAX, SUM, COUNT(stolpec) in skupine (na primer iz DMax v Accessu) pošiljal kot zahteve, ki so se končale z 400. Zdaj jih gonilnik zavrne sam; DCount("*", …) šteje kot doslej. Kaj se šteje in kako preberete največjo vrednost: Štetje, največja vrednost in združevanje.

• Naroča in obnavlja obstoječi win-acme. Če računalnik že obnavlja z drugim win-acme (od različice 2.2.9 naprej), naročilo uporabi tega, njegovo opravilo pa ostane; starejša različica naročilo prekine s sporočilom. Pri odstranitvi gre opravilo win-acme le, če zaganja priloženi win-acme. Glejte Namestitveni paket.

• Nov korak “SQL Server” v namestitvenem programu. V podatkovno mapo zapiše skript za skrbnike podatkovnih zbirk (privzeto) ali takoj ustvari prijavo računa storitve in uporabnika v vsaki podatkovni zbirki, z računom Windows osebe, ki namešča. Kar obstaja, ostane nespremenjeno. Glejte Namestitev podatkovnega prehoda.
• Nov ukaz service-login za isto po namestitvi ter setup-host --sql-server oziroma lastnosti paketa GW_SQL_SERVER, GW_SQL_DATABASES in GW_SQL_ROLES za distribucijo programske opreme. Glejte Ukazi na strežniku.

• Odgovori brez Server: Kestrel. Prehod ne razkriva več programske opreme strežnika. Za IIS lastno glavo IIS odstrani nastavitev v IIS, glejte Delovanje prehoda za strežnikom IIS ali drugim posredniškim strežnikom.

• RuleVersion v SignInRules. Vsako shranjeno pravilo navaja različico, ki jo navajata dogodki prijave in explain-sign-in; “pravilo se je od takrat spremenilo” je tako vidno brez dodatnega klica.
• Nova množica SignInFileRules. Prikaže pravila prijave, ki so še v konfiguracijski datoteki, s skrbniško shrambo pa ne veljajo (InForce = false). Opis v skrbništvu.

• Novi pogoji pravila prijave. Operators/ExceptOperators (operaterji omrežja, na primer AS3320), Clients/ExceptClients (vrsta programa iz User-Agent, trditev odjemalca) in Hours/ExceptHours (časovna okna, na primer Mon-Fri 06:00-20:00); izjema sprejme Operators, Clients in Hours. Opis pod Po operaterju omrežja, programu in času.
• Lastna omrežja po imenu. From in ExceptFrom pravila ter From izjeme lahko navajajo ime lastnega omrežja iz Gateway:SignInLog:Networks.
• Signali z zanesljivostjo. Dogodek prijave v Signals navaja še operator, client in za vsak signal trust (observed, claimed, verified). explain-sign-in za vsak izvor sprejme operator, client in at.
• Shema skrbniške shrambe 20.

• Preizkus pravila. Pravilo prijave ima način: Enforce (privzeto) ali Report. Pravilo v preizkusu se oceni pri vsaki prijavi, a ne spremeni nobene odločitve; dogodek prijave zabeleži, kaj bi storilo. Shema skrbniške shrambe 19. Opis pod Preizkus pravila.
• Vrednotenje po pravilih. Nova množica SignInRuleReports za vsako pravilo v preizkusu in različico prešteje prijave, ki bi jih zadelo, s številom oseb in izvorov.
• explain-sign-in prikaže pravila v preizkusu ločeno pod tried.

• Odločilno pravilo v dogodku prijave. SignInEvents v Rules navede pravila prijave, na katerih je temeljila odločitev, z oznako in različico, tudi pravilo, ki ga je odpravila izjema, in spodnjo mejo skrbništva; Signals navede državo in stanje 2FA. Opis pod Podlaga odločitve.
• Zavrnilno pravilo v revizijski sledi. AuditEntries v SignInRule navede pravilo, ki je zahtevo zavrnilo; revizijska sled ga zapiše za razlogom.
• Različica v explain-sign-in. Pojasnilo pri vsakem pravilu navede id in version, tako da je mogoče prejšnji dogodek primerjati z današnjim pravilom.

• Ponudniki v skrbništvu. Množica DataSources bere in piše Provider, ProviderVersion in ProviderOptions kot konfiguracijska datoteka (skrbniška shramba, shema 18). Novi množici Providers in ProviderProperties kažeta nameščene pakete ponudnikov in lastnosti, ki jih vsak opiše za svojo povezavo.
• Povezava kot lastnosti. Namesto niza sprejme DataSources povezavo kot ConnectionProperties; ponudnik iz njih sestavi in preveri niz. Pri branju se lastnosti pojavijo brez gesla; geslo, ki pri spreminjanju manjka, ostane. Opis v lastnostih povezave ponudnika.
• Preizkus povezave z vrsto napake. Ob napaki test-connection navede številko podatkovne zbirke (number) in vrsto, neodvisno od jezika strežnika (failure: Login, Database, Permission, Network, Timeout, Unreadable, Configuration, Other), glejte preizkus povezave in račun storitve.
• Račun storitve. Nov ukaz GET /admin/v1/service-account: račun, s katerim se viri podatkov s prijavo Windows prijavijo v podatkovno zbirko, kot ga vidi SQL Server na istem in na drugem računalniku. Namestitev opiše, kaj SQL Server potrebuje za ta račun.
• Specifikacija vmesnika ponudnika 1.3. Neobvezen opis lastnosti povezave in vrsta napake preizkusa povezave; ponudnik, zgrajen za različico 1.2, se še vedno naloži. Priloženi ponudnik za SQL Server ima različico 1.2.0.
• Popravek namestitvenega programa: ime namestitve. Namestitveni program vpisanega imena namestitve ni posredoval namestitvenemu paketu; prehod je namesto tega dobil predlog “Datendienst (ime računalnika)”, ki ga je prikazala tudi aplikacija za preverjanje pristnosti. Od namestitvenega programa 1.0.7 dalje vpisano ime pride do prehoda. Pri že nameščeni različici ga popravite v skrbništvu z nastavitvijo installation_name (glejte Skrbništvo); novo ime velja, kadar oseba pozneje nastavi 2FA.

• Lastna datoteka dnevnikov. Dnevnik prijav in dnevnik obremenitve sta v datoteki dnevnikov poleg skrbniške shrambe (gateway-logs.db), omejeni z Gateway:Store:LogMaxMegabytes (privzeto 4096 MB); najprej se izbrišejo najstarejši vnosi. Ob prvem zagonu prehod obstoječe dnevnike preseli iz shrambe vanjo (shramba shema 17). Osebe so tam navedene z oznako; preimenovanje ohrani zgodovino.
• Posamezni dogodki brez starostne meje. Gateway:SignInLog:EventDays ne briše več ničesar; določa le, koliko nazaj bereta SignInOrigins in SignInEvents brez lastnega časovnega pogoja. SignInEvents pogoje za Person, At in Id upošteva že pri branju datoteke dnevnikov; meja 20.000 na zahtevo velja za ujemajoče se dogodke.
• Pravila prijave s spominom. Deset pravil vsako prijavo primerja s prejšnjimi 90 dnevi in ugotovitve s trajnim Id shrani v novo množico `SignInFindings`; “od zadnjega pogleda” je Id gt x. Brez pravice sign-in-events ostanejo oseba, ključ in primerjalne vrednosti prazni.
• Sporočanje ugotovitev. Ugotovitve stopnje act se zapišejo kot opozorila v dnevnik prehoda in se z Gateway:SignInLog:Alerts:Recipients takoj pošljejo po pošti, ugotovitve stopnje ask pa enkrat na dan zbrano. Nov razdelek `Gateway:Mail`.
• Profil prijav. Nov ukaz `sign-in-profile`: kaj je za osebo običajno v 90, 180, 365 ali več dneh.
• Shranjeni namigi o obremenitvi. Nova množica LoadFindings s trajnim Id, ki se vsako uro polni iz namigov LoadAdvice.
• Varnostna kopija. backup-store kopira tudi datoteko dnevnikov (…-logs.db poleg kopije shrambe); odgovor ukaza HTTP navede še logFile in logBytes.

• Izbris osebe s sledmi je zavrnjen. Če ima oseba osebni ključ ali sejo, vnose v dnevniku prijav ali dnevniku obremenitve ali je sama zapisala spremembe, DELETE na Persons vrne 422; osebo je mogoče le onemogočiti (Enabled = false). Tako je vnose v dnevnikih še naprej mogoče pripisati osebi. Glejte Hramba in brisanje.

• Pravila po državi. Pravila prijave navajajo države (Countries, ExceptCountries, kode po ISO 3166-1 alpha-2), na primer “dostop do podatkov samo iz Nemčije”. Državo prehod prebere iz geolokacijske zbirke dnevnika prijav. Prijava iz države, ki je ni mogoče ugotoviti, spada v obseg pravila; lastna omrežja izvzemite z njihovimi naslovi. Glejte pravilnik prijave.
• Časovno omejene izjeme. Exceptions izvzame zahteve, ki hkrati izpolnjujejo vse značilnosti (osebe, skupine Windows, države, omrežja), do konca v UTC – na primer dostop osebe za dva tedna tudi s Tajske. Potek izjeme je zapisan v dnevniku sprememb (exception-lapsed).
• Skrbniški vmesnik. Novi množici SignInRuleExceptions in SignInRuleExceptionItems, novi značilnosti country in except_country; save-sign-in-rule sprejme countries, exceptCountries in exceptions; explain-sign-in navede državo in izjemo, ki izvzame, ter za vsak izvor sprejme državo. Nov razlog deniedByCountry v dnevniku prijav.
• Skrbniška shramba shema 16. Prehod shrambo ob prvem zagonu preuredi, pred tem pa naredi njeno varnostno kopijo.

• Dnevnik obremenitve. Prehod za vsako obliko zahteve – zahtevo brez njenih vrednosti – beleži, kako pogosto je prišla, koliko časa je potrebovala v prehodu in v podatkovni zbirki, koliko vrstic in bajtov je vrnila in kako pogosto ni uspela. Nove množice LoadShapes, LoadHours, SlowRequests, LoadAdvice in, le z novo pravico load-persons, LoadPersons. Nastavitve pod `Gateway:LoadLog`. Glejte Ugotavljanje, kaj obremenjuje prehod in podatkovno zbirko.
• Namigi z ukrepi. LoadAdvice navaja oblike, ki obremenjujejo podatkovno zbirko ne glede na podatke: cele tabele brez filtra, filtre brez indeksa, globoko listanje, draga skupna števila in vsote, drage lastne stavke in zelo pogosto samodejno osveževanje.
• Obremenitev za proizvajalca. export-load (skrbniški ukaz in ukaz na strežniku) zapiše oblike, urne vrednosti in namige kot datoteko JSON, brez oseb, izvora in vrednosti.
• Iskanje oblike v SQL Serverju. Ustvarjeni in preverjeni stavki za prvo ključno besedo vsebujejo komentar /* wkl:<oznaka oblike> */, viden v predpomnilniku načrtov, v Query Store in v Extended Events; povezave se predstavijo kot Wkl.Data.Gateway, razen če niz povezave nastavi lastno Application Name.
• Specifikacija vmesnika ponudnika 1.2, ponudnik za SQL Server 1.1.0. Ponudnik prejme oznako (ExecutionLimits.Marker), prehod pa prebere nazadnje ustvarjeni stavek (IDataSession.LastStatementText). Oboje je dopolnitev; ponudnik, zgrajen za različico 1.0 ali 1.1, deluje nespremenjeno, le brez označevanja.
• Skrbniška shramba shema 15. Prehod starejšo shrambo ob prvem zagonu nadgradi; varnostna kopija nastane kot pri vsaki nadgradnji.

• Dnevnik prijav. Prehod vsako odločitev o prijavi s postopkom, izidom, razlogom, osebo in izvorom zabeleži v skrbniški shrambi in jo ovrednoti: porazdelitev po urah in dnevih v tednu v strežniškem času, izvor po lastnem omrežju, državi in operaterju omrežja ter namige na vzorce napadov. Nove množice SignInHours, SignInOrigins, SignInEvents, SignInAdvice; posamezni dogodki le z novo pravico sign-in-events. Glejte Preverjanje vzorcev prijav in njihovega izvora.
• Geolokacijska zbirka brez povezave navzven. Prehod naslove geografsko umesti s pomočjo datotek na strežniku (DB-IP Lite ali MaxMind GeoLite2). Prenese jih sam (update-geoip, tudi redno), jih sprejme od odjemalca (upload-geoip) ali uvozi na strežniku (import-geoip). Nove množice GeoIpFiles, GeoIpSource, ukaz set-geoip-source, nastavitve `Gateway:SignInLog`.
• “Zavrnjeno” v stanju prehoda brez pozivov. DeniedLastFiveMinutes je štel tudi odgovor 401 na zahtevo brez prijavnih podatkov, s katero se začne vsaka prijava Windows. Okolje s prijavo Windows je zato ves čas kazalo zavrnitve, čeprav ni bilo zavrnjeno nič.
• Razlog unprotected. Prijava SQL Server, koda 2FA ali zahteva za skrbništvo ali samopostrežbo prek nezaščitene povezave zdaj dobi ta razlog (prej brez razloga) in se pojavi v dnevniku prijav.
• Skrbniška shramba shema 14. Prehod starejšo shrambo pretvori ob prvem zagonu; varnostna kopija nastane kot pri vsaki pretvorbi.

• Zaščita pred ponovitvijo pod preimenovano glavo ključa. Z lastno nastavitvijo Gateway:Security:ApiKeyHeader prehod pri Idempotency-Key klicateljev ni razlikoval: drug klicatelj z enakim Idempotency-Key, naslovom in telesom je lahko prejel shranjen odgovor drugega klicatelja. Zdaj vsak shranjen odgovor pripada svojemu klicatelju.
• Stolpci nepodprtih tipov ne sprejemajo več vrednosti. sql_variant, hierarchyid, vector in tipi CLR manjkajo v $metadata, pri pisanju pa so sprejemali vrednosti. Zdaj prehod odgovori z 400 kot pri neznanem polju.
• Prijavo SQL Server s skrbniško shrambo je mogoče nastaviti v poljubnem vrstnem redu. Prehod se zažene s SqlLogin v AuthMode tudi preden vir podatkov dopusti prijave SQL Server in obstaja preslikava; do takrat v dnevnik zapiše opozorilo, ki napoti na skrbništvo, prijava z imenom in geslom pa se konča z 401. Glejte Nastavitev prijave z računom SQL Server.
• Naslovi v odgovorih za posredniškim strežnikom. Od zaupanja vrednega posredniškega strežnika prehod za absolutne naslove v svojih odgovorih (dokument storitve, naslednje strani, Location, enkratne povezave) prevzame X-Forwarded-Proto in X-Forwarded-Host; predloga IIS nastavi obe glavi. Glejte Delovanje prehoda za strežnikom IIS ali drugim posredniškim strežnikom.
• Prvi skrbnik z računom Windows. init-admin --windows zdaj račun preslika na pravilo za skrbništvo. Prej prijava z Windows ni dobila pravic: z --no-key je nastal skrbnik, ki se ni mogel prijaviti, admin-status pa ga je kljub temu štel za skrbnika, ki lahko upravlja. Mirujoči ključi na zahtevo se v admin-status prav tako ne štejejo več.
• Spreminjanje dostopa. Ko se setup-host izvede nad obstoječo skrbniško shrambo, opozori, da pravila prijave novega dostopa tam ne veljajo. Brez vpisanih omrežij podjetja pravilo požarnega zidu zdaj dopušča le lokalno podomrežje namesto vsakega omrežja.

• Okno ni nikoli večje od Limits:MaxRows (tudi za posamezen objekt). Prej se je stran OData pri manjšem MaxRows končala brez @odata.nextLink in brez oznake; Access, Excel in Power BI so del vrstic videli kot celoten rezultat.
• Stolpci neponujenih tipov (geopodatki, hierarchyid, sql_variant, json, vector, tipi CLR) zdaj manjkajo tudi pri branju brez seznama polj in pri ponovnem branju po pisanju. Prej je pisanje v tabelo s stolpcem geography vrnilo 503, čeprav je bil zapis shranjen, lastni vmesnik HTTP brez seznama polj pa je vrnil sql_variant neobdelan. Kdor je te vrednosti bral prek lastnega vmesnika HTTP brez seznama polj, jih ne dobi več.

Novo: Varnostni model in meje zaupanja, Standardi in specifikacije. Popravljeno: oseba z osebnim ključem brez prijave SQL Server tudi pri aliasu s Persons: Impersonate deluje s prijavo aliasa (ni 403); wkl.person prehod nastavi samo za osebne ključe in izbrane identitete; DenyImpersonate ne velja za prijavo prek HTTP Basic; prek OData se časovna točka z zamikom pretvori v UTC, namesto da bi bila zavrnjena; 503 po zahtevi za pisanje pomeni “izid neznan”; /health/ready odgovori z 200 tudi brez aliasa. Vedenje prehoda je nespremenjeno.

Klicatelji brez pravice sql lahko na POST /api/v1/cf/{alias}/sql.json pošiljajo stavke, ki jih prehod preveri: spoje, podpoizvedbe, UNION, funkcije, CASE, vzorce LIKE z _ in […], množične spremembe in klic procedure – nad natanko tistimi objekti in z natanko tistimi metodami, ki jih omogočajo njihova pravila. Več stavkov v enem paketu je dovoljenih; vsak se preveri posebej. Tako se prek gonilnika ODBC izvajajo poizvedbe, ki jih Access pošilja prek povezanih tabel, tudi brez pravice sql. Novo v konfiguraciji: AllowCheckedStatements za vsak vir podatkov (privzeto true); skrbniška shramba se ob zagonu nadgradi na shemo 13 in privzeto vrednost prevzame za vse obstoječe vire podatkov. Dokument metapodatkov naslov (Store.PassThrough) zdaj navaja tudi za te klicatelje. Specifikacija vmesnika ponudnika 1.1: IDataSource.CheckStatement, zmožnost CheckedStatements; priloženi ponudnik sqlserver zahteva specifikacijo vmesnika 1.1.

Na istem naslovu novo: izhodni parametri in vrednost RETURN (outputs v zahtevi in odgovoru), vsi nizi rezultatov (results za prvim) in opis stavka, ne da bi se izvedel ("describe": true), glejte Izhodni parametri, več nizov rezultatov, opisovanje. Odgovori brez teh polj ostanejo nespremenjeni. Specifikacija vmesnika ponudnika 1.1: zmožnosti StatementOutputs in StatementDescription.

Prehod se s podatkovnimi zbirkami povezuje prek ponudnikov, ki jih je mogoče naložiti naknadno. Priložen je ponudnik sqlserver (mapa providers/sqlserver/1.0.0 poleg programa); odgovori klicateljem ostanejo nespremenjeni. Novo v konfiguraciji: Provider, ProviderVersion, ProviderOptions za vsak vir podatkov in Gateway:Providers:Path, glejte Konfiguracija prehoda. Dialect: mssql še naprej velja. Če viru podatkov manjka zmožnost, prehod zahtevo zavrne z 400, še preden se obrne na podatkovno zbirko.

Priročnik za skrbnike aplikacije za upravljanje in referenčni priročnik razreda VBA DbGwClient zdaj spadata v dokumentacijo aplikacije za upravljanje (lastno skladišče Wkl.Data.Gateway.Access). Naloge na strežniku – namestitev, prvi skrbnik, varnostno kopiranje, glavni ključ, dostop v sili – so tukaj v novem področju Obratovanje.

• Vabila po pošti: predloge sporočil v množici MailTemplates (tri vgrajene), e-poštni naslov pri osebi (Email) in enkratne povezave po pošti ("delivery": "mail" pri issue-key in enroll-totp), ki preživijo ponovni zagon in ne hranijo ključev; nastavitev mail_link_hours, konfiguracija Gateway:Store:MailLinkHours. Glejte Enkratna povezava po pošti.
• Shramba starejše različice se ob zagonu nadgradi (pred tem varnostna kopija .v11-…bak).

• Nova vrsta napake DATABASE_UNREADABLE (503): SQL Server je dosegljiv, vendar podatkovne zbirke aliasa ne more brati (izgubljen pogon, brez povezave, sumljiva, v obnovi). Ni začasna napaka. Prej je bil odgovor UNAVAILABLE; klicatelj, ki kode ne pozna, še naprej bere 503.

• Odgovori z napako vsebujejo sporočila SQL Serverja (details: številka, SQLSTATE, resnost, besedilo, released). Številka, SQLSTATE in resnost vedno prispejo kot pri neposredni povezavi; besedilo prehod zadrži (released: false), če navaja objekt, ki ga klicatelj ne doseže, ali če lahko pri prijavi vira podatkov navede podatkovno vrednost (na primer podvojen ključ ali predolgo vrednost). Glejte Oblika napak.

• Filtri lahko polje primerjajo z drugim poljem (GatewayFilter.FieldComparison).

• Nova vrsta napake TIMEOUT (504): stavek je presegel časovno omejitev prehoda. Prej je bil odgovor UNAVAILABLE (503).

• Preverjanje pripadnosti množici sme vsebovati do 20.000 vrednosti (prej 1.000).

• Prva različica.