Avalik teadmusbaas

Avalik teadmusbaas (Public KB) on teie teadmusbaasi osa, mis on kättesaadav ilma sisselogimiseta otselingi, vidina või iframe'i kaudu. Siia satuvad artiklid, mille olete selgesõnaliselt avalikuks märkinud.

Milleks:

• Klientide iseteenindus — kliendid leiavad vastused ise, toe poole pöördumata
• SEO — avalikud artiklid indekseeritakse Google'is ja teistes otsimootorites
• Demo — potentsiaalsed kliendid loevad dokumentatsiooni enne ostu
• Partnerid — juurdepääs tehnilisele dokumentatsioonile ilma kontode loomiseta

#Kuidas artikkel muutub avalikuks

Avalikkus lülitatakse sisse kahe seadega — artikli tasemel ja organisatsiooni tasemel. Kuni mõlemad pole täidetud, anonüümsed külastajad artiklit ei näe.

„Avalikku ala“ kui tüüpi ei ole. Alad on ainult Ettevõtteülesed / Privaatsed. Artikkel ei muutu nähtavaks eriliisse alasse tõstmisega, vaid lipuga publish_state=public (ettevõtteüleses alas), kui organisatsiooni avalik režiim on sisse lülitatud.

See kahekordne kaitse on tagatis, et privaatne teave ei lipsaks kogemata välja. Väärtuse publish_state=public saab panna ainult ettevõtteüleses alas; privaatses on see valik blokeeritud.

#publish_state olekud (ADR 0029)

LiKE kasutab välja publish_state (asendab varasema välja visibility). Neli olekut:

Liideses on oleku värv näidatud punktnäidikuga:

Samad märgised on näha artiklite loendis jaotises Artiklite haldamine.

#Virtuaalne ala __public__

Kui anonüümne kasutaja avab avaliku teadmusbaasi otselingi või vidina kaudu, ei asu ta tehniliselt üheski teie alas. Selle asemel kasutab LiKE virtuaalset „ala“ __public__ — märgendväärtust, mis:

• Ei eksisteeri andmebaasis päris alana (tüüp public on legacy ja migreeritud väärtusele corporate)
• Hõlmab artikleid, mis on avalikud ise või pärivad avalikkuse avalikult kaustalt
• Kasutatakse anonüümse kasutaja RAG-otsingu filtreerimiseks
• Alade vahetajas kuvatakse kui „ Avalikud artiklid“ (kui kasutajal on ka privaatseid alasid)

Kui olete sisse loginud liige, lülituge alade vahetajas alale __public__, et näha täpselt sama artiklite komplekti, mida näeb anonüümne külastaja — see on mugav kontrollimaks, „mida ma kogemata avaldasin“.

#Seadistamine (samm-sammult)

#1. samm — paigutage artiklid ettevõtteülesesse alasse

Väljapoole saab avaldada ainult ettevõtteülesest alast (privaatses on avaldamine blokeeritud). Kui artiklid on teises alas, teisaldage need ettevõtteülesesse: ükshaaval artikli kontekstimenüüst → Teisalda, või hulgi (märkeruudud → Teisalda). Alade tüübid on Ettevõtteülene ja Privaatne; eraldi „isiklikku“ tüüpi ei ole: ala jääb isiklikuks seni, kuni te pole kedagi kutsunud.

#2. samm — tehke artiklid avalikuks

Viige vajalikud artiklid olekusse publish_state = public (vt Artiklite haldamine):

• Hulgi — märkige märkeruutudega → gloobusenupp () tegevuspaneelil → Avalik
• Üks artikkel — menüü „⋮“ → „Nähtavus: …“ → Avalik; vaates „Puu“ — kontekstimenüü → „Tee avalikuks“
• Redaktoris — juurdepääsumärgis artikli pealkirja kõrval

Pärast seda muutub olekunäidik roheliseks ja ilmub märgis Avalik. Kui artiklis on isikuandmeid, avaneb kinnitusaken — vt jaotist „Isikuandmete kontroll avaldamisel“ allpool.

#3. samm — lülitage sisse organisatsiooni avalik režiim

Seaded → Organisatsioon → Juurdepääsurežiim → valige „Avalik“.

• Avalik — anonüümsed kasutajad näevad avalikul aadressil artikleid, mis on märgitud avalikuks; privaatsed alad jäävad kättesaadavaks ainult kutse alusel.
• Ettevõttesisene — kõik on kättesaadav ainult sisse loginud liikmetele; välised kasutajad ilma sisselogimiseta ei näe midagi, isegi mitte avalikuks märgitud artikleid.

Ilma sisselülitatud režiimita „Avalik“ on avalik aadress suletud — see samm on kohustuslik.

Avalik režiim töötab ainult pakettides, kus see sisaldub. Kui avalikku juurdepääsu paketis pole, on nupp „Avalik“ kättesaamatu koos vihjega „Avalik juurdepääs ei kuulu paketti: anonüümsed külastajad portaali ei näe.“ Paketi alandamisel sulgub portaal anonüümsetele ise ja sobivale paketile naastes avaneb uuesti — valitud režiimi ei lähtestata.

#4. samm — avalik aadress ja kanalid

Valmis avalikku baasi avatakse kolmel viisil:

• Avalik portaal — teie aadressi juur https://<teie-slug>.lynkora.pro: otsing, AI-vastused ja artiklite lugemine ilma sisselogimiseta. Üksik artikkel on lingil /kb/<artikli-slug>.
• JS-vidin — lisatakse teie veebilehele; vidina kood võetakse jaotisest Integratsioonid → Kanalid (kaart „JS Widget“).
• iframe — täieliku otsinguliidese lisamine lehele.

Eraldi vahekaarti „Avalik teadmusbaas“ seadetes enam ei ole (ADR 0029): avalikkuse määrab nüüd artikli lipp + organisatsiooni režiim, mitte allikate valge nimekiri. Vidinaid hallatakse jaotises Integratsioonid → Kanalid.

#Isikuandmete kontroll avaldamisel

Artikli avalikuks muutmisel kontrollib LiKE selle automaatselt isikuandmete suhtes. Kui neid leitakse, peatatakse avaldamine ja avaneb aken „Tuvastati isikuandmed“ — enne kui artikkel muutub kõigile ilma sisselogimiseta kättesaadavaks.

Millal käivitub: kui artikkel muutub anonüümselt kättesaadavaks — olekuga public või inherit kaudu avaliku kausta sees. Olekute internal ja draft puhul kontrolli ei tehta. Töötab kõigil teedel, mitte ainult nupul „Avalda“: juurdepääsumärgis redaktoris, „Tee avalikuks“ loendis ja puus, nähtavuse hulgimuutmine, kausta avaldamine (sealhulgas koos sisuga), artikli või kausta teisaldamine avalikku kausta, kopeerimine, prügikastist taastamine ja artikli sisselülitamine.

Mida tuvastatakse (determineeritult, mustrite järgi):

• E-posti aadress
• Telefon
• Maksekaart (kontroll Luhni algoritmiga)
• IBAN (kontroll kontrollsumma järgi)
• IP-aadress
• Sünnikuupäev

Eriliigilisi andmeid (tervis, biomeetria jm, GDPR art. 9) ei tuvastata veel automaatselt — aknas näidatakse ainult hoiatust suurema vastutuse kohta nende avaldamisel.

Artiklite rühma kohta küsitakse üks kord. Nähtavuse hulgimuutmine, kausta avaldamine, teisaldamine ja taastamine näitavad üht akent „Isikuandmed avaldatavates artiklites“: kokkuvõte andmetüüpide kaupa (mitu esinemist ja mitmes artiklis), artiklite loend koos nimeotsinguga, „Märgi kõik“ / „Eemalda kõik“ ja märgitute loendur.

• Avaldatakse märgitud artiklid. Avamisel on märgitud kõik — eemaldage märge nendelt, mida avaldada ei ole vaja: need jäävad sisemiseks ega järgne kaustale.
• Nupud on „Avalda N“ ja „Tühista“. Tühistamisel ei juhtu midagi ja LiKE ütleb seda otse.
• Rühmaaknas antud kinnitus kirjutatakse logisse iga artikli kohta eraldi.

Veebisaidi ühendaja toodud artiklid ei vaja ükshaaval kinnitamist: ühendamisel kinnitab omanik õigused saidile ja sealt pärit isikuandmete avaldamise seaduslikkuse. Ühendage sait uuesti vastusega „Sisemistena“ — nõusolek eemaldatakse ja kontroll töötab taas tavapäraselt.

Taustatoimingud — ühendaja sünkroonimine, import, struktuuri ümberehitus — ei saa kelleltki küsida, seetõttu nad kinnitamata isikuandmetega artiklit ei avalda: see jääb sisemiseks ja logisse tekib selle kohta kirje. Avaldada saab selle käsitsi, läbides tavalise kontrolli.

Kuidas ühe artikli aken välja näeb:

• Pealkiri „Tuvastati isikuandmed“ ja leitud tüüpide loend koos arvuga (kokku kõigi avaldatavate artiklite kohta).
• Kohustuslik kinnitav märkeruut: tööriist aitab isikuandmeid tuvastada, kuid ei taga täielikkust; vastutus avaldamise seaduslikkuse ning aluste ja nõusolekute olemasolu eest lasub teil kui andmete vastutaval töötlejal.
• Nupud „Tühista“ ja „Avalda“ (viimane on aktiivne alles pärast märkeruudu märkimist).

Pärast kinnitamist: artikkel avaldatakse ja kinnituse fakt salvestatakse auditi logisse (pii_public_ack) koos leitud andmetüüpidega — ilma isikuandmete teksti salvestamata (privaatsus kavandamise kaudu). Kinnitus on seotud artikli praeguse versiooniga: kui teksti pärast seda muuta, tuleb uuesti kinnitada.

Kes saab kinnitada: samad rollid, kes avaldavad — Toimetaja ja kõrgem artikli alas. Organisatsiooni omanik alati; organisatsiooni administraator ettevõtteülestes alades ja privaatsetes, kus ta on liige Toimetaja või Administraatori rolliga. Allika kõigi artiklite hulgiavaldamine — ainult Omanik/Administraator.

#Vidinad avaliku teadmusbaasi jaoks (kaks autentimisrežiimi, ADR 0032)

LiKE toetab vidinate kahte autentimisrežiimi — valitakse vidina loomisel jaotises Integratsioonid → Kanalid → JS Widget:

#Režiim 1 — lubatud aadressid (avalike veebilehtede jaoks)

Vidin, mis lisatakse ettevõtte avalikule veebilehele (maandumisleht, turunduslehed, abikeskus). Autentimist ei nõuta — vidin on kättesaadav igale külastajale.

Kaitse kuritarvituse eest:

• Veebilehe aadressid — kus vidin töötab. Näiteks yoursite.com, docs.yoursite.com (skeemita aadress saab https://). Tärni ei aktsepteerita; muudelt aadressidelt päringud lükatakse tagasi.
• Avalik katusala — vidinal on juurdepääs ainult alale __public__ ja konkreetsetele selle ala kogudele, mis loomisel määrati.
• Päringusageduse piirang api-võtmele — kaitse robotite eest.

#Režiim 2 — seansi JWT (autentimisega ettevõttesisese veebilehe jaoks)

Vidin, mis lisatakse ettevõtte siseportaali, kus kasutajad on juba autenditud. Vidin võtab vastu seansi JWT ja näeb täpselt seda, mida näeb see kasutaja.

Kasutus:

• Vidin ettevõtte sisevõrgus → iga töötaja näeb oma alasid
• Manustamine SaaS-rakendusse (näiteks CRM-i) — kasutaja näeb oma rolli dokumentatsiooni

#Mitu vidinat ühe organisatsiooni kohta (ADR 0029 etapp 4)

Organisatsioonis saab luua mitu vidinat eri ulatusega:

• Üks avalik, turunduslehe jaoks (lubatud aadressid)
• Teine ettevõttesisene, sisevõrgu jaoks (seansi JWT)
• Kolmas konkreetse kogu jaoks (näiteks ainult KKK tugikeskuse jaoks)

Igal vidinal on oma api-võti, ulatus ja autentimisrežiim. Üksikasjad: Integratsioonid ja API ja vidin.

#Mida näevad anonüümsed külastajad

Anonüümne otsing kasutab vaikimisi kliendi sõrmejälje küpsist päringusageduse piiramiseks, kuid ei seo päringut kasutajakontoga.

#Üksikute kogude peitmine

Ettevõtteüleses alas ei pea kõik kogud tingimata anonüümsetele nähtavad olema. Konkreetseid kogusid saab peita:

1. Kogu kontekstimenüü → „Tee avalikuks“ / „Tee sisemiseks“
2. Kogu olek:
   • inherit — järgib lähimat ülemist kausta, millel on selge olek; kui sellist pole — sisemine (vaikimisi)
   • internal — peidetud anonüümsete eest, nähtav meeskonnale
   • public — selgesõnaliselt avalik (ainult ettevõtteüleses alas, muidu blokeeritud)

See annab paindlikkuse: näiteks ettevõtteüleses alas „Dokumentatsioon“ võib hoida mustandeid kogus Internal Drafts olekuga publish_state=internal — need on väljapoole nähtamatud, kuid teie toimetajatele kättesaadavad.

#Lisamine veebilehele

Avalikku teadmusbaasi saab veebilehega siduda kolmel viisil:

Üksikasjad iga viisi kohta: API ja vidin ja Integratsioonid.

#White-label ja oma domeen

Avalik teadmusbaas on kättesaadav vaikeaadressil slug.lynkora.pro. Portaali laiendatud võimalused — white-label (ilma LiKE brändinguta) ja oma domeeni ühendamine (Seaded → Domeen; arendamisel) — sisalduvad pakettides, kus white-label on sisse lülitatud. Eraldi tasulist lisamoodulit selleks ei ole.

Millised võimalused millistes pakettides saadaval on ja mis hinnaga — vaadake lehelt Hinnad ja oma halduspaneelist.