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 sesijas krātuvē; kešatmiņa tiek atkārtoti izmantota ne ilgāk par 30 minūtēm |
| 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ā nesaglabā plūsmu saturu pakalpojumos 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 ierobežo skriptu pieprasījumus citām vietnēm, ja plūsmas izdevējs tos neatļauj ar CORS galvenēm. RSS Reader izmanto servera puses plūsmu pakalpojumu adresē vitextra.com: pārlūkprogramma nosūta plūsmu adreses, un pakalpojums lejupielādē un parsē plūsmas, atgriežot 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:
- konfigurētās plūsmu adreses tiek nosūtītas plūsmu pakalpojumam. Neizmantojiet adreses ar slepenām vērtībām, piemēram, personiskiem piekļuves tokeniem vai API atslēgām: tās būtu pieejamas pakalpojumam un ikvienam lapas lasītājam;
- 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; 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 saglabā plūsmu vienumus sesijas krātuvē, izmantojot plūsmu adrešu kopu kā atslēgu. Kamēr fonā tiek ielādēti jauni vienumi, tiek izmantota kešatmiņa, kas nav vecāka par 30 minūtēm. Šis termiņš ierobežo atkārtotu izmantošanu, nevis nosaka automātisku dzēšanu. Kešatmiņā ir plūsmu vienumi, nevis informācija par lietotāju. Tā pieder cilnes sesijai un var tikt atjaunota, atjaunojot pārlūkprogrammas sesiju. Pats plūsmu kešatmiņas mehānisms neizmanto lokālo krātuvi vai sīkfailus.
Tīmekļa daļa nereģistrē, kurus rakstus lietotājs atver. Pārlūkprogramma var saglabāt pārlūkošanas vēsturi un izmanto savu apmeklēto saišu statusu, lai blāvinātu atvērto rakstu virsrakstus.
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 atsevišķā dokumentā ar
DOMParser; skripti netiek izpildīti un tiek rādīts tikai vienkāršs teksts. Inerta parsēšana negarantē, ka netiks pieprasīti iegultie resursi; - attēls tiek iegūts no plūsmas multivides elementiem vai apraksta. Meklējot attēlu aprakstā, tīmekļa daļa izlaiž attēlus, kuru norādītais platums vai augstums nepārsniedz vienu pikseli; tas nebloķē visus izsekošanas attēlus. Izvēlētais attēls 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 Teams klienta uz vitextra.com, static.vitextra.com un vitextra-storage.azureedge.net. Ja plūsmu pakalpojums ir bloķēts, nevar ielādēt jaunus vienumus; ja nav iepriekš ielādētu datu, tiek parādīta kļūda. Produktu failu resursdatoru bloķēšana var traucēt tīmekļa daļas ielādi. Attēli tiek ielādēti no izdevēju resursdatoriem un var nebūt redzami, ja šie pieprasījumi ir bloķēti.
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.
- Izvēlieties HTTPS adreses gan plūsmām, gan attēliem. Pārlūkprogramma var pārveidot HTTP attēlu pieprasījumus par HTTPS vai bloķēt tos; drošai attēlošanai izmantojiet tiešas HTTPS attēlu adreses.
- 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, izrakstoties, notīriet pārlūkprogrammas vietņu datus. Cilnes aizvēršana vien negarantē datu dzēšanu, ja pārlūkprogramma var atjaunot sesiju.