Pārskats

Vairākas Vitextra tīmekļa daļas lasa datus, kas atrodas ārpus SharePoint vietnes: lietotāju profilus un vadītāju hierarhiju pakalpojumā Microsoft Entra ID, klātbūtnes statusu pakalpojumā Microsoft Teams, kalendārus, uzdevumus pakalpojumos Planner un To Do, failus pakalpojumā OneDrive. SharePoint Framework (SPFx) risinājumi šiem datiem piekļūst caur Microsoft Graph, un nomnieka administratoram tas vienreiz jāatļauj.

Mehānisms ir vienāds visiem SPFx risinājumiem: risinājuma pakotne deklarē nepieciešamās atļaujas, SharePoint pārvērš šo deklarāciju atļauju pieprasījumos, kad pakotne tiek izvietota lietotņu katalogā, un pieprasījumi gaida SharePoint administrēšanas centra lapā API piekļuve, līdz administrators tos apstiprina vai noraida.

Šajā rakstā ir paskaidrots, kuri Vitextra produkti pieprasa atļaujas un kāpēc, kā apstiprināt pieprasījumus, kā tos vēlāk pārskatīt un atsaukt un ko jūs redzat tīmekļa daļās, ja atļaujas trūkst. Raksts ir paredzēts SharePoint un globālajiem administratoriem, kuri instalē Vitextra produktus, un drošības speciālistiem, kuri pārskata šādus pieprasījumus.

📝 Piezīme
Rakstā ir aplūkoti tikai SPFx risinājumu API piekļuves pieprasījumi. Pašas pakotnes instalēšana ir aprakstīta rakstā KB10035. Kā instalēt Vitextra produktu pakalpojumā SharePoint Online.

Kas tiek pieprasīts un kāpēc

Tālāk uzskaitītās atļaujas ir deleģētas: tīmekļa daļas izsauc Microsoft Graph pierakstījušā lietotāja vārdā. Faktiskā piekļuve ir atkarīga gan no piešķirtajiem tvērumiem, gan no lietotāja atļaujām. Tas nenozīmē, ka Graph rezultāti precīzi sakrīt ar Outlook vai Teams rādīto. Microsoft Graph

Tabulā ir uzskaitītas atļaujas, ko deklarē to produktu pašreizējās versijas, kuri izmanto Microsoft Graph.

ProduktsAPIAtļaujasIzmantojums
Employee DirectoryMicrosoft GraphUser.Read.All, Directory.Read.All, People.Read, Presence.Read.All, Calendars.ReadLietotāju profilu, nodaļu un vadītāju lasīšana; saistītās personas; Teams klātbūtnes statuss; aizņemtības statuss pieejamības indikatoram
Employee DetailsMicrosoft GraphUser.Read.All, User.ReadWrite, People.Read.All, Presence.Read.All, Files.Read.All, Sites.Read.All, Calendars.Read.SharedProfilu lasīšana; iespēja lietotājam rediģēt sava profila laukus; saistītās personas; klātbūtnes statuss; dokumenti un vietnes, ar kurām persona nesen strādājusi (Microsoft Graph ieskati); kolēģu aizņemtības statuss darba laikam un pieejamībai
Organizational ChartMicrosoft GraphUser.Read.All, Directory.Read.All, Presence.Read.AllPakļautības hierarhijas veidošana pēc atribūta Vadītājs; nodaļa un amats; Teams klātbūtnes statuss
Absence & CoverageMicrosoft GraphUser.Read.AllDarbinieku, viņu vadītāju un tiešo padoto noteikšana pieprasījumiem, apstiprinājumiem un aizvietošanai
My TasksMicrosoft GraphUser.Read, User.ReadBasic.All, Tasks.ReadWriteUzdevumi no Planner, To Do un atzīmētajiem e-pasta ziņojumiem; uzdevumu autoru vārdi
My TasksAzure DevOpsuser_impersonationAvots Azure DevOps un tīmekļa daļa Azure DevOps Query
Password VaultMicrosoft GraphFiles.ReadWrite.AppFolderŠifrētā seifa glabāšana lietotāja OneDrive lietojumprogrammas mapē

Produkti, kas strādā tikai ar pašreizējo vietni - Announcements Carousel, List Filter Online, QR Code Generator, Questions & Answers, Quick Poll, RSS Reader, Smart Search un Smart Tiles -, nepieprasa nekādas API atļaujas. Lapā API piekļuve par tiem nekas neparādās.

📝 Piezīme
Atļaujas nosaukums, piemēram, Tasks.ReadWrite vai User.ReadWrite, ir Microsoft Graph tvēruma nosaukums, kas var būt plašāks par to, ko produkts ar to dara. My Tasks uzdevumus tikai lasa; Employee Details raksta tikai pierakstījušā lietotāja profila laukus. Katra atļauja ir sīkāk paskaidrota produktu rakstos: KB10235. Organizational Chart nepieciešamās Microsoft Graph atļaujas, KB10303. My Tasks: nepieciešamās atļaujas, konfidencialitāte un drošība.

No kurienes rodas pieprasījumi

Atļaujas pieprasījums tiek izveidots, kad .sppkg pakotne tiek izvietota nomnieka lietotņu katalogā. Pieprasījumi pieder pakotnei, nevis atsevišķām tīmekļa daļām, tāpēc risinājums, kurā ir divas tīmekļa daļas, rāda vienu pieprasījumu kopu, un atļauja, kas nepieciešama tikai neobligātai funkcijai (piemēram, My Tasks avotam Azure DevOps), tiek pieprasīta kopā ar pārējām.

Pārvaldības ziņā ir svarīgi divi punkti.

  • Apstiprinājums attiecas uz visu nomnieku. SharePoint piešķir atļauju vienai Microsoft Entra ID lietojumprogrammai, ko tas izmanto visiem SPFx risinājumiem, - SharePoint Online Web Client Extensibility (agrāk: SharePoint Online Client Extensibility Web Application Principal). Kad User.Read.All ir apstiprināta produktam Employee Directory, to pašu piešķīrumu izmanto Organizational Chart un jebkurš cits SPFx risinājums nomniekā, kas to pieprasa. Tā darbojas SharePoint Framework; tas nav Vitextra projektēšanas lēmums.
  • Izvietošana nav atkarīga no apstiprinājuma. Vitextra produktu var izvietot, pievienot vietnēm un ievietot lapās, kamēr tā pieprasījumi vēl gaida apstiprinājumu vai pat ir noraidīti. Nedarbojas tikai tās funkcijas, kas ir atkarīgas no trūkstošās atļaujas.

Priekšnosacījumi

  • Vitextra pakotne ir augšupielādēta nomnieka lietotņu katalogā un izvietota (Iespējot lietotni).
  • Lai apstiprinātu Microsoft Graph un citu Microsoft API atļaujas, pierakstieties ar globālā administratora lomu. Nomniekā reģistrētām trešo pušu API pietiek ar lietojumprogrammu administratora lomu. Ar SharePoint administratora lomu vien Microsoft Graph atļaujas apstiprināt nevar. Microsoft

❗ Svarīgi
Lapā API piekļuve tiek rādīti to pakotņu pieprasījumi, kas izvietotas nomnieka lietotņu katalogā. Ja vēlaties izvietot Vitextra produktus no vietņu kolekcijas lietotņu kataloga, vispirms izvietojiet pakotni nomnieka lietotņu katalogā un apstipriniet pieprasījumus tur; apstiprinātās atļaujas attiecas uz visu nomnieku un pēc tam ir pieejamas arī kopijai vietņu kolekcijas lietotņu katalogā.

Pieprasījumu apstiprināšana

1. Atveriet Microsoft 365 administrēšanas centru un pārejiet uz SharePoint administrēšanas centru.

2. Kreisajā navigācijā izvērsiet Papildu (Advanced) un atlasiet API piekļuve.

API piekļuves pieprasījumi

API piekļuves pieprasījumi

3. Cilnē Gaidošie pieprasījumi (Pending requests) atrodiet Vitextra pakotnes pieprasījumus. Katrā rindā ir redzams pakotnes nosaukums (piemēram, Vitextra Employee Directory), API (Microsoft Graph vai Azure DevOps) un atļauja.

4. Atlasiet pieprasījumu un noklikšķiniet uz Apstiprināt. Izlasiet aprakstu panelī un apstipriniet ar Apstiprināt.

API piekļuves pieprasījuma apstiprināšana

API piekļuves pieprasījuma apstiprināšana

5. Atkārtojiet to katram pakotnes pieprasījumam. Atļauja, kas jau ir apstiprināta citam risinājumam, vairs neparādās: SharePoint izmanto esošo piešķīrumu.

6. Pārslēdzieties uz cilni Apstiprinātie pieprasījumi (Approved requests) un pārbaudiet, vai tajā ir uzskaitītas visas pakotnes atļaujas.

Apstiprinātie pieprasījumi

Apstiprinātie pieprasījumi

Lietotāji piekrišanas uzvedni neredz: pēc apstiprināšanas tīmekļa daļas darbojas visiem nomnieka lietotājiem. Piešķīrums parasti stājas spēkā dažu minūšu laikā; ja tīmekļa daļa joprojām ziņo par trūkstošu atļauju, ielādējiet lapu atkārtoti vai izrakstieties un pierakstieties vēlreiz, lai saņemtu jaunu marķieri.

💡 Padoms
Pieprasījumus var apstiprināt uzreiz visus ar SharePoint Online Management Shell: Get-SPOTenantServicePrincipalPermissionRequests parāda gaidošos pieprasījumus, un Approve-SPOTenantServicePrincipalPermissionRequest -RequestId <id> apstiprina vienu no tiem. Tas ir ērti, ja vienlaikus ieviešat vairākus Vitextra produktus.

Tikai daļas atļauju apstiprināšana

Jūs varat apstiprināt dažus pieprasījumus un noraidīt citus. Tīmekļa daļa turpina darboties, un tiek ietekmēta tikai attiecīgā funkcija:

  • noraidīta Presence.Read.All - Employee Directory, Employee Details un Organizational Chart rāda cilvēkus bez Teams klātbūtnes indikatora;
  • noraidīta Calendars.Read / Calendars.Read.Shared - netiek rādīta informācija par pieejamību un darba laiku;
  • noraidīta Files.Read.All / Sites.Read.All - Employee Details nerāda nesen izmantotos failus un vietnes;
  • noraidīta user_impersonation (Azure DevOps) - My Tasks avots Azure DevOps un tīmekļa daļa Azure DevOps Query nevar pierakstīties pakalpojumā Azure DevOps.

Ja tiek noraidīta produkta pamatatļauja (User.Read.All uz cilvēkiem orientētajiem produktiem, Tasks.ReadWrite produktam My Tasks, Files.ReadWrite.AppFolder produktam Password Vault), tīmekļa daļa paliek bez datiem.

Ko lietotāji redz, ja atļaujas trūkst

SimptomsIespējamais cēlonis
Tīmekļa daļa rāda kļūdu par liegtu piekļuvi, nepietiekamām tiesībām vai trūkstošu piekrišanuPamatatļauja gaida apstiprinājumu vai ir noraidīta
Darbinieki ir uzskaitīti, bet trūkst krāsainā klātbūtnes punktaPresence.Read.All nav apstiprināta
Organizācijas shēma ir tukša vai rāda tikai pašreizējo lietotājuUser.Read.All vai Directory.Read.All nav apstiprināta
My Tasks nerāda neko no Planner, To Do un Outlook, bet SharePoint avots darbojasTasks.ReadWrite nav apstiprināta
Viss darbojās, bet pēc atjaunināšanas viena funkcija pārstāja darbotiesJaunā versija pieprasa papildu atļauju, kas vēl gaida apstiprinājumu

Atveriet lapu API piekļuve un salīdziniet cilnes Gaidošie pieprasījumi un Apstiprinātie pieprasījumi ar tabulu šī raksta sākumā.

Atjauninājumi un jaunas atļaujas

Kad augšupielādējat jaunu pakotnes versiju (skatiet KB10050. Kā atjaunināt Vitextra SPFx risinājumu pakalpojumā SharePoint Online), agrāk apstiprinātās atļaujas paliek apstiprinātas. Ja jaunā versija deklarē atļauju, kuras iepriekšējā versijā nebija, jaunais pieprasījums parādās cilnē Gaidošie pieprasījumi, un tas jāapstiprina tāpat. Vitextra šādas izmaiņas norāda produkta laidiena piezīmēs.

Atļauju pārskatīšana un atsaukšana

Tā kā piešķīrumus kopīgi izmanto visi SPFx risinājumi, Vitextra produkta noņemšana neatsauc tā pieprasītās atļaujas. Lai atsauktu atļauju:

  1. Atveriet API piekļuve un pārslēdzieties uz cilni Apstiprinātie pieprasījumi.
  2. Atlasiet atļauju un noklikšķiniet uz Noņemt piekļuvi (Remove access).
  3. Apstipriniet.

Apstiprinātas atļaujas noņemšana

Apstiprinātas atļaujas noņemšana

❗ Svarīgi
Pirms noņemat atļauju, pārbaudiet, vai no tās nav atkarīgs cits nomnieka risinājums - tajā pašā cilnē parādās jūsu pašu SPFx tīmekļa daļas, citu ražotāju produkti un Microsoft iepriekš autorizētās atļaujas. Ja noņemsiet atļauju, ko izmanto cits risinājums, tas nekavējoties pārstās darboties.

Noraidīts pieprasījums tiek noņemts no API piekļuves lapas un nepaliek cilnē Gaidošie pieprasījumi. Lai atļauju pieprasītu vēlreiz, izstrādātājam jāiesniedz jauns pieprasījums tam pašam resursam un tvērumam. Microsoft

Drošības piezīmes pārskatītājiem

  • Katrs Microsoft Graph izsaukums tiek veikts no pierakstījušā lietotāja pārlūkprogrammas ar šim lietotājam izsniegtu marķieri. Vitextra tīmekļa daļām nav lietojumprogrammas (app-only) atļauju un nav pakalpojuma konta.
  • Microsoft Graph pārbauda piešķirtos deleģētos tvērumus un lietotāja atļaujas. Redzamība adrešu grāmatā un atsevišķu lietojumprogrammu filtri ir atšķirīgi mehānismi; lietotāja paslēpšana programmā Outlook nenozīmē, ka viņš tiks paslēpts Graph vaicājumos.
  • Informāciju par atsevišķu produktu datu plūsmām, licences pieprasījumiem, telemetriju un glabāšanu skatiet rakstā KB10363. Kur Vitextra produkti glabā jūsu datus: konfidencialitāte, datu atrašanās vieta un VDAR.

Jautājumi un atbildes

Uzdodiet jautājumu par šo rakstu un saņemiet oficiālu atbildi no mūsu komandas.

Vēl nav jautājumu. Uzdodiet pirmo jautājumu.

Izvēlētie raksti

Kā lapai pievienot Absence & Coverage tīmekļa daļas un atlasīt vietni

Soli pa solim sniegts ceļvedis, kā SharePoint lapai pievienot tīmekļa daļas My Absences, Team Absence Calendar un Substitutions, atlasīt vietni prombūtņu sarakstiem, kas tiek izveidots automātiski, un kādi ir rekvizītu rūts iestatījumi ar noklusējuma vērtībām.

101 5 min
My Tasks: filtrēšana, kārtošana un personiskie skata iestatījumi

Kā filtrēt un kārtot uzdevumu sarakstu Vitextra My Tasks: filtru paneļa grupas un UN/VAI loģika, kārtošana no kolonnas galvenes izvēlnes, administratora iestatītā noklusējuma kārtošana, kuri personiskie skata iestatījumi tiek atcerēti pārlūkprogrammā un kā tos atiestatīt.

96 4 min
Lielu sarakstu filtrēšana: indeksētās kolonnas un 5000 vienumu slieksnis

Kāpēc SharePoint Online saraksta ar vairāk nekā 5000 vienumiem filtrēšana var neizdoties, kā Vitextra List Filter Online tīmekļa daļa brīdina par neindeksētām filtra kolonnām un izveido indeksu uz vietas, kā pievienot indeksu saraksta iestatījumos un kā projektēt filtrus, kārtošanu un grupēšanu, lai lieli saraksti turpinātu darboties.

103 8 min

Kopīgot