Pārskats
Daudzi SharePoint Framework risinājumi deklarē Microsoft Graph atļaujas, kuras nomnieka administratoram jāapstiprina SharePoint administrēšanas centra lapā API piekļuve (API access). Discussions nav viens no tiem. Pakotne nedeklarē nevienu API atļauju pieprasījumu, nereģistrē nevienu lietotni Microsoft Entra ID un nerāda piekrišanas uzvedni ne lietotājiem, ne administratoriem. Viss, ko dara tīmekļa daļas — dēļu, tēmu, atbilžu, abonementu, pielikumu un attēlu lasīšana un rakstīšana, cilvēku meklēšana @pieminējumiem —, notiek ar tās vietnes SharePoint REST API starpniecību, kurā atrodas dēlis, pierakstījušā lietotāja vārdā.
Šajā rakstā šis fakts ir fiksēts drošības pārbaudei, paskaidrots, ko administrators instalēšanas laikā redz un neredz, un uzskaitītas tās nedaudzās lietas, kas tomēr atstāj nomnieku.
Kopsavilkums pārbaudītājiem
| Jautājums | Atbilde |
|---|---|
| Pakotnes pieprasītās Microsoft Graph atļaujas? | Nav |
| Citas API atļaujas (Azure DevOps, pielāgotas API)? | Nav |
| Ieraksti lapā API piekļuve pēc izvietošanas? | Nav — nav ko apstiprināt vai noraidīt |
| Sava Microsoft Entra lietotnes reģistrācija vai pakalpojuma pamatdaļa? | Nav |
| Administratora vai lietotāja piekrišanas uzvednes? | Nav |
| Identitāte, kas tiek izmantota piekļuvei datiem? | Pierakstījies lietotājs, katrā pieprasījumā |
| Izsauktās API? | Tikai pašreizējās vietnes SharePoint REST API |
| Lietojumprogrammas (app-only) atļaujas, pakalpojumu konti, saglabāti akreditācijas dati? | Nav |
| Saturs, kas tiek sūtīts Vitextra vai trešajām pusēm? | Nav; tikai licences pārbaude un lietošanas telemetrija ar tehniskiem identifikatoriem |
| Vai vietnē nepieciešams pielāgots skripts? | Nē |
Ko risinājums izsauc
Tīmekļa daļas izmanto SharePoint Framework HTTP klientu, kas katru pieprasījumu sūta ar pašreizējā lietotāja identitāti. SharePoint katram izsaukumam piemēro lietotāja atļaujas tieši tāpat kā sarakstu skatiem sadaļā Vietnes saturs (Site contents). Tiek izmantoti šādi galapunkti:
- Pašreizējās vietnes saraksti un saraksta elementi — lai atrastu Discussions sarakstus pēc to marķieru kolonnām, izveidotu tos pirmajā lietošanas reizē (šai vienai darbībai nepieciešama atļauja Pārvaldīt sarakstus) un lasītu un rakstītu dēļus, tēmas, atbildes, abonementus, Like atzīmes, ziņojumus un apstiprināšanas statusus.
- Saraksta elementu pielikumi — faili, kas pievienoti tēmām un atbildēm.
- Dokumentu bibliotēkas
Discussions Assetsfaili un mapes — bagātinātā teksta redaktora iekļautie attēli. - SharePoint cilvēku atlasītāja pakalpojums — ieteikumi, kas tiek rādīti pēc
@ievadīšanas, un izvēlētās personas sasaiste ar vietnes lietotāju. Tas ir tas pats pakalpojums, ko izmanto standarta SharePoint cilvēku atlasītājs; tas neizsauc Microsoft Graph. - Vietnes lietotāju informācijas saraksts — autoru vārdi un pašreizējā lietotāja id.
Neviens pieprasījums nenonāk Microsoft Graph, Exchange, Teams vai kādā citā Microsoft 365 pakalpojumā, un tīmekļa daļa nesūta e-pastu. Pilns sarakstu un kolonnu saraksts ir rakstā KB10411. Kur Discussions glabā jūsu datus: saraksti, kolonnas un konfidencialitāte.
📝 Piezīme
Tā kā tiek piemērotas lietotāja paša atļaujas, tīmekļa daļa nevar nevienam parādīt vairāk, nekā SharePoint viņam rādītu sarakstos: lasītāji redz apstiprinātās tēmas, moderatori — gaidošās, viesi — to, ko atļauj viņu vietnes atļaujas. Lomu modelis ir aprakstīts rakstā KB10408. Atļaujas Discussions: kas var lasīt, rakstīt un moderēt.
Ko administrators redz instalēšanas laikā
1. Pakotne vitextra.discussions.sppkg tiek augšupielādēta nomnieka lietotņu katalogā (vai vietņu kolekcijas lietotņu katalogā) un iespējota ar Iespējot lietotni (Enable app). Dialoglodziņā norādīts domēns, no kura tiek ielādēti skripti, un piedāvāts Pievienot visām vietnēm (Add to all sites); tajā nav atļauju sadaļas, jo pakotne nevienu nedeklarē.

2. Lapa API piekļuve (SharePoint administrēšanas centrs → Papildu → API piekļuve) nemainās: cilnē Neizskatītie pieprasījumi (Pending requests) neparādās neviens pieprasījums no Vitextra Discussions, un nekas nav jāapstiprina. Ja jūsu organizācija uztur apstiprināto API atļauju reģistru, ieraksts par Discussions ir vienkārši "netiek pieprasītas".
3. Tīmekļa daļa tiek pievienota lapai tāpat kā jebkura cita, un pirmais lietotājs ar Pārvaldīt sarakstus izveido dēli. Lietotāji nekad neredz piekrišanas dialoglodziņu.
Instalēšanas un atjaunināšanas soļi ir tādi paši kā katram Vitextra produktam: KB10035. Kā instalēt Vitextra produktu pakalpojumā SharePoint Online, KB10050. Kā atjaunināt Vitextra SPFx risinājumu pakalpojumā SharePoint Online un KB10361. Nomnieka lietotņu katalogs vai vietņu kolekcijas lietotņu katalogs: kur izvietot Vitextra lietotnes. Vispārīgā procedūra pakotnēm, kas atļaujas pieprasa, ir rakstā KB10360. Kā apstiprināt Microsoft Graph API atļaujas Vitextra risinājumiem SharePoint administrēšanas centrā; Discussions gadījumā šis raksts nav nepieciešams.
❗ Svarīgi
Ja pēc atjaunināšanas lapā API piekļuve kādreiz parādās pieprasījums no Vitextra Discussions, to deklarē jauna versija, un šīs versijas laidiena piezīmēs tas būs norādīts. Versija 26.10.2 nedeklarē nevienu.
Microsoft Teams lietotne
Teams lietotnes pakotne, ko lietotņu katalogs ģenerē cilnei un personiskajai lietotnei, arī nedeklarē Microsoft Graph tvērumus. Tās manifests atsaucas tikai uz pašu SharePoint Online — standarta mehānismu, ar kuru SPFx cilne pierakstina lietotāju komandas vietnē — un uz ierastajiem SharePoint un Microsoft 365 pierakstīšanās domēniem. Tāpēc Teams administrēšanas centrā lietotnei nav piešķiramu API atļauju. Kā pievienot lietotni Teams, aprakstīts rakstā KB10393. Kā pievienot Discussions pakalpojumam Microsoft Teams.
Kas atstāj nomnieku
| Nolūks | Kas tiek sūtīts | Kurp |
|---|---|---|
| Produkta faili | Parasts pārlūkprogrammas pieprasījums pēc tīmekļa daļu skriptiem un ikonām | static.vitextra.com |
| Licences pārbaude | Nomnieka ID, lietotāja objekta ID, vietnes adrese un produkta identifikators, nosaukums un versija | vitextra.com |
| Lietošanas telemetrija | Notikums, kad tīmekļa daļa tiek ielādēta (produkts un versija, vietnes ID un adrese, lietotāja objekta ID, saskarnes valoda, vai tā darbojas Teams), un kļūdu tehniskās detaļas | Azure Application Insights |
Neviena tēma, atbilde, pielikums, attēls, abonements vai lietotāju saraksts netiek sūtīts Vitextra vai kādai trešajai pusei. Pārskats par visiem Vitextra produktiem, ieskaitot datu atrašanās vietu un VDAR, ir rakstā KB10363. Kur Vitextra produkti glabā jūsu datus: konfidencialitāte, datu atrašanās vieta un VDAR.
Kur atrodas e-pasta atļauja
Discussions apzināti nesūta e-pastu, tāpēc tam nav nepieciešams Mail.Send vai lietojumprogrammas atļauja sūtīt pastkastes vārdā. Tīmekļa daļa uztur sarakstu Discussions Subscriptions un kolonnu Mentions; piegāde ir Power Automate plūsmas uzdevums, kuru vietnes īpašnieks iestata savā vidē. Šī plūsma izmanto tās personas savienojumus, kura to izveido — SharePoint savienojumu sarakstu lasīšanai un Office 365 Outlook (vai koplietojamās pastkastes) savienojumu sūtīšanai —, un piekrišana šiem savienojumiem tiek dota Power Automate saskaņā ar pārvaldību, ko jūsu organizācija jau piemēro plūsmām. Līgums starp sarakstiem un plūsmu ir aprakstīts rakstā KB10414. Kā darbojas paziņojumi Discussions: abonementi, pieminējumi un Power Automate.
💡 Padoms
Drošības anketai: "Risinājums ir SharePoint Framework pakotne, kas nedeklarē API atļauju pieprasījumus, kurai nav savas Entra ID lietotnes, kas izsauc tikai mitinātājvietnes SharePoint REST API ar pierakstījušā lietotāja deleģēto identitāti, glabā visu saturu šīs vietnes sarakstos un sūta piegādātājam tikai licences un telemetrijas identifikatorus." Katru apgalvojumu var pārbaudīt lietotņu katalogā, lapā API piekļuve un pārlūkprogrammas tīkla izsekošanā.