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ājums | Atbilde |
|---|---|
| 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
| Uzdevums | Nepieciešamā atļauja |
|---|---|
| Augšupielādēt pakotni lietotņu katalogā, pievienot to pakalpojumam Teams | SharePoint administrators vai lietotņu kataloga īpašnieks |
| Pievienot tīmekļa daļu lapai un konfigurēt plūsmas | Lapas rediģēšanas atļauja |
| Saglabāt Teams personiskās programmas noklusējuma konfigurāciju | Rediģēšanas atļauja lapā ar tīmekļa daļu |
| Lasīt plūsmas, pārslēgt avotus, filtrēt un meklēt | Lapas 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:
| Lauks | Vērtība |
|---|---|
| Sources | Konfigurēto plūsmu adreses |
| TenantId | Jūsu Microsoft 365 nomnieka ID |
| UserId | Pierakstījušā lietotāja objekta ID (GUID) pakalpojumā Microsoft Entra ID |
| SiteUrl | Vietnes adrese, kurā darbojas tīmekļa daļa |
| ProductId, ProductName, ProductVersion | Produkta 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ūks | Kas tiek sūtīts | Kurp |
|---|---|---|
| Plūsmu pakalpojums | Skatiet tabulu iepriekš | vitextra.com |
| Licences pārbaude | Nomnieka ID, lietotāja objekta ID, vietnes adrese, produkta identifikators, nosaukums un versija | vitextra.com |
| Teams personiskās programmas konfigurācija | Nolasīta katrā personiskās programmas ielādē; ierakstīta ar Saglabāt iestatījumus: iepriekš uzskaitītie konfigurācijas lauki | vitextra.com |
| Lietošanas telemetrija | Notikums, 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ļas | Azure Application Insights |
| Produkta faili | Parasts faila pieprasījums tīmekļa daļas skriptiem un ikonām | static.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
- 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.
- 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ķē.
- 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.
- 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.