Ievads

Tīmekļa daļa, kas ienes iekštīklā saturu no ārpuses, administratoram rada divus jautājumus: kas pamet nomnieku un kas ienāk. RSS Reader starp Vitextra produktiem ir neparasts ar to, ka tā saturs tiešām iet cauri Vitextra serverim — plūsmu pakalpojumam, kas lejupielādē plūsmas. Šajā rakstā ir precīzi norādīts, ko šis pieprasījums satur, ko tīmekļa daļai ir atļauts darīt jūsu nomniekā, kur atrodas tās konfigurācija, ko tā glabā pārlūkprogrammā un kā tā apstrādā HTML, ko izdevēji ievieto savās plūsmās.

Kopsavilkums administratoriem

JautājumsAtbilde
Kādas API atļaujas pieprasa pakotne?Nekādas
Vai tīmekļa daļa lasa SharePoint sarakstus, failus vai lietotāju profilus?Nē
Kas lejupielādē plūsmas?Vitextra plūsmu pakalpojums pēc pārlūkprogrammas pieprasījuma
Ko satur pieprasījums plūsmu pakalpojumam?Plūsmu adreses, nomnieka ID (Tenant ID), lietotāja objekta ID, vietnes adrese, produkts un tā versija
Vai Vitextra tiek sūtīts kāds jūsu nomnieka saturs?Nē
Kur tiek glabāta konfigurācija?Tīmekļa daļas rekvizītos lapā; Teams personiskajai programmai — Vitextra pakalpojumā jūsu nomniekam
Kas tiek glabāts pārlūkprogrammā?Pēdējie ielādētie plūsmu vienumi, līdz 30 minūtēm cilnes sesijā
Vai plūsmu HTML tiek izpildīts lapā?Nē — tas tiek parsēts inerti; tiek izmantots tikai vienkāršs teksts un attēlu adreses

Risinājuma atļaujas

RSS Reader ir SharePoint Framework tīmekļa daļa, kas tiek izvietota no lietotņu kataloga.

  • Pakotne nepieprasa nekādas API atļaujas. SharePoint administrēšanas centra lapā API piekļuve nekas neparādās, un tīmekļa daļa datu iegūšanai neizsauc ne Microsoft Graph, ne SharePoint REST API.
  • No lapas konteksta tā nolasa tikai to, kas ir katrai tīmekļa daļai: dizainu, valodu, vietnes adresi (licences pārbaudei un plūsmu pieprasījumam) un pierakstījušā lietotāja identitāti (objekta ID, tiem pašiem pieprasījumiem).
  • Tā neko neraksta SharePoint, OneDrive vai Microsoft Entra ID.

Kas vajadzīgs lietotājiem

UzdevumsNepieciešamā atļauja
Augšupielādēt pakotni lietotņu katalogā, pievienot to pakalpojumam TeamsSharePoint administrators vai lietotņu kataloga īpašnieks
Pievienot tīmekļa daļu lapai un konfigurēt plūsmasLapas rediģēšanas atļauja
Saglabāt Teams personiskās programmas noklusējuma konfigurācijuRediģēšanas atļauja lapā ar tīmekļa daļu
Lasīt plūsmas, pārslēgt avotus, filtrēt un meklētLapas lasīšanas atļauja

Kā tiek ielādētas plūsmas un kas tiek nosūtīts

Pārlūkprogrammas neļauj vienas tīmekļa vietnes skriptam lejupielādēt dokumentu no citas tīmekļa vietnes, ja vien šī vietne to neatļauj ar starpizcelsmes galvenēm; plūsmu izdevēji to gandrīz nekad nedara. Tāpēc RSS tīmekļa daļa, kas darbotos tikai pārlūkprogrammā, lielākajai daļai plūsmu neizdotos. RSS Reader to atrisina ar servera puses plūsmu pakalpojumu adresē vitextra.com: pārlūkprogramma nosūta tam plūsmu adrešu sarakstu, pakalpojums lejupielādē plūsmas no interneta, parsē tās un atgriež kanālus un vienumus kā strukturētus datus.

Katra ielāde un katra automātiskā atsvaidzināšana ir viens pieprasījums plūsmu pakalpojumam ar šādu saturu:

LauksVērtība
SourcesKonfigurēto plūsmu adreses
TenantIdJūsu Microsoft 365 nomnieka ID
UserIdPierakstījušā lietotāja objekta ID (GUID) pakalpojumā Microsoft Entra ID
SiteUrlVietnes adrese, kurā darbojas tīmekļa daļa
ProductId, ProductName, ProductVersionProdukta identifikators, iekšējais nosaukums un versija

Atbilde satur plūsmu vienumus — virsrakstus, saites, aprakstus, datumus, autorus, kategorijas un attēlu adreses — un to avotu sarakstu, kurus nevarēja lejupielādēt. Pakalpojums nesaņem un neatgriež nekādu jūsu nomnieka saturu; lietotājs tiek identificēts pēc GUID, nevis pēc vārda vai e-pasta adreses.

Trīs sekas:

  • jūsu konfigurētās plūsmu adreses ir zināmas plūsmu pakalpojumam. Neizmantojiet plūsmas, kuru adrese pati satur noslēpumu (personisku pilnvaru vai API atslēgu vaicājuma virknē): šādas plūsmas nav paredzētas koplietošanai ar jebkādu apkopotāju, un tās tā vai tā netiek atbalstītas, jo pakalpojums lejupielādē plūsmas anonīmi;
  • plūsmas, kas ir sasniedzamas tikai jūsu tīkla iekšienē, nevar parādīt;
  • pārlūkprogramma nekad nesavienojas ar izdevēju serveriem plūsmas dēļ. Tā savienojas ar tiem vienumu attēlu dēļ, ko pārlūkprogramma ielādē tieši, kā jebkuru attēlu tīmekļa lapā — izdevējs redz parastu lietotāja pārlūkprogrammas attēla pieprasījumu.

📝 Piezīme
Šo pieprasījumu apstrāde, ko veic Vitextra, ir aprakstīta dokumentā Konfidencialitātes politika. Pieprasījums pakalpojumam pasaka, ar kurām plūsmām lapa ir konfigurēta, nevis kurus rakstus lietotājs atver — saites uz rakstiem ved tieši pie izdevēja, un Vitextra netiek ziņots par nevienu klikšķi.

Kur tiek glabāta konfigurācija

SharePoint lapā konfigurācija — plūsmas ar to adresēm, nosaukumiem un secību, izkārtojums un slēdži — tiek glabāta tīmekļa daļas rekvizītos lapas iekšienē bibliotēkā Vietnes lapas. Ikviens, kurš var lasīt lapu, var izlasīt konfigurāciju (plūsmu adreses tā vai tā ir redzamas avotu cilnēs); lapas versijas saglabā iepriekšējās konfigurācijas.

Teams personiskajai programmai administrators saglabā konfigurāciju ar Saglabāt iestatījumus grupā Personiskā programma (Microsoft Teams). Šo konfigurāciju — tos pašus laukus bez tīmekļa daļas virsraksta — Vitextra pakalpojums glabā jūsu nomniekam un produktam, jo personiskajai programmai nav lapas, kurā to glabāt. To nolasa katra nomnieka lietotāja personiskā programma, un to pārraksta nākamā darbība Saglabāt iestatījumus. Tā satur tikai iestatījumus un plūsmu adreses, nekādus lietotāju datus.

Teams kanāla cilnē konfigurācija tiek glabāta kopā ar cilni, tāpat kā lapā.

Kas tiek glabāts pārlūkprogrammā

Pēc sekmīgas ielādes tīmekļa daļa ieraksta saņemtos vienumus pārlūkprogrammas sesijas krātuvē, izmantojot plūsmu adrešu kopu kā atslēgu, un izmanto tos līdz 30 minūtēm, lai nākamajā apmeklējumā uzreiz parādītu saturu, kamēr fonā tiek ielādēti jauni vienumi. Kešatmiņa satur plūsmu vienumus tādus, kādus atgriezis plūsmu pakalpojums, un neko par lietotāju; tā pieder pārlūkprogrammas cilnes sesijai un tiek noņemta, kad cilne tiek aizvērta. Tīmekļa daļa neizmanto lokālo krātuvi, sīkfailus vai citu pastāvīgu krātuvi.

Kurus rakstus lietotājs ir atvēris, nekur netiek reģistrēts. Jau atvērto virsrakstu blāvināšana balstās uz pārlūkprogrammas pašas apmeklēto saišu atmiņu, ko neviens skripts nevar nolasīt.

Kā tiek attēlots plūsmu saturs

Plūsmu vienumi satur izdevēja rakstītu HTML — aprakstus ar marķējumu, iegultus attēlus, dažkārt skriptus vai izsekošanas pikseļus. RSS Reader nekad neievieto šo HTML lapā:

  • apraksts tiek parsēts ar inertu parsētāju (DOMParser), kas neizpilda skriptus un neielādē iegultos resursus, un tiek attēlots tikai tā vienkāršais teksts;
  • vienuma attēls tiek ņemts no plūsmas multivides elementiem vai no apraksta pirmā attēla, un viena pikseļa attēli — tipiskie izsekošanas pikseļi — tiek izlaisti; attēls pēc tam tiek rādīts kā parasts <img> elements ar izdevēja adresi;
  • saites atver oriģinālo rakstu jaunā cilnē izdevēja vietnē; tīmekļa daļa nepievieno izsekošanas parametrus.

Nepareizi veidots vienums — trūkstoši elementi, bojāts marķējums — tiek rādīts ar tiem datiem, kas tam ir, un netraucē attēlot pārējos vienumus.

Pieprasījumi Vitextra pakalpojumiem

NolūksKas tiek sūtītsKurp
Plūsmu pakalpojumsSkatiet tabulu iepriekšvitextra.com
Licences pārbaudeNomnieka ID, lietotāja objekta ID, vietnes adrese, produkta identifikators, nosaukums un versijavitextra.com
Teams personiskās programmas konfigurācijaNolasīta katrā personiskās programmas ielādē; ierakstīta ar Saglabāt iestatījumus: iepriekš uzskaitītie konfigurācijas laukivitextra.com
Lietošanas telemetrijaNotikums, kad tīmekļa daļa tiek ielādēta: produkta nosaukums un versija, vietnes ID un adrese, lietotāja objekta ID, saskarnes valoda un tas, vai tīmekļa daļa darbojas Teams vidē; kļūdu tehniskās detaļasAzure Application Insights
Produkta failiParasts faila pieprasījums tīmekļa daļas skriptiem un ikonāmstatic.vitextra.com, vitextra-storage.azureedge.net

To pašu informāciju par visiem Vitextra produktiem skatiet rakstā KB10363. Kur Vitextra produkti glabā jūsu datus: konfidencialitāte, datu atrašanās vieta un VDAR.

Tīkla prasības

Atļaujiet izejošo HTTPS no lietotāju tīkla (un no Teams klienta) uz vitextra.com, static.vitextra.com un vitextra-storage.azureedge.net. Bez pirmā resursdatora tīmekļa daļa vienumu vietā rāda Diemžēl radās problēmas…; bez pārējiem diviem tā neielādējas vispār. Vienumu attēli tiek ielādēti no izdevēju resursdatoriem; ja jūsu starpniekserveris bloķē izdevēju, tā vienumi parādās bez attēliem.

Ieteikumi

  1. Izmantojiet to izdevēju plūsmas, kuriem jūsu organizācija uzticas, tāpat kā jebkuram ārējam saturam iekštīklā: virsraksti, teksti un attēli ir viņu, un tie mainās bez jūsu pārskatīšanas.
  2. Dodiet priekšroku HTTPS plūsmu adresēm ar HTTPS attēliem; attēlus, kas piegādāti caur HTTP, pārlūkprogramma HTTPS lapās bloķē.
  3. Nekonfigurējiet plūsmas, kuru adrese satur personisku pilnvaru; tās tiek koplietotas ar ikvienu, kurš var lasīt lapu, un ar plūsmu pakalpojumu.
  4. Koplietotos datoros notīriet pārlūkprogrammas vietnes datus pēc izrakstīšanās, kā jebkurai iekštīkla lapai; plūsmu kešatmiņa tā vai tā pazūd kopā ar cilni.

Izvēlētie raksti

Privātie prombūtnes veidi: ko kolēģi redz kalendārā

Kā darbojas privātie prombūtnes veidi Vitextra Absence & Coverage: kurš redz īsto veidu un dienu skaitu, kur pelēkais apzīmējums «Prombūtnē» tos aizstāj Team Absence Calendar un CSV eksportā, kuri veidi ir privāti pēc noklusējuma, kā mainīt iestatījumu un ko konfidencialitātes noteikums neaizsargā.

37 4 min
Smart Tiles: risinājuma pārskats

Kas ir Vitextra Smart Tiles tīmekļa daļa un ko tā piedāvā: navigācija ar elementiem (flīzēm) SharePoint Online lapās ar sešiem ikonu avotiem, dizaina un iepriekš definētām krāsām, fona attēliem, aprakstiem, lidojuma efektiem, mērķauditoriju, elementu importēšanu un eksportēšanu, kā arī 44 valodu atbalstu.

67 4 min
Kā pievienot un konfigurēt Vitextra Quick Poll tīmekļa daļu

Soli pa solim: kā pievienot Vitextra Quick Poll tīmekļa daļu SharePoint Online lapai, izveidot pirmo aptauju un konfigurēt tās izskatu, diagrammu un uzvedību rekvizītu panelī.

100 3 min

Kopīgot