Organizational Chart nepieciešamās Microsoft Graph atļaujas

Ievads

Vitextra Organizational Chart neglabā nekādus savus darbinieku datus. Viss, ko tā rāda — vārdi, amati, vadītāju saites, fotoattēli un klātbūtnes statuss —, tiek nolasīts izpildes laikā no Microsoft Entra ID, izmantojot Microsoft Graph API. Lai tas darbotos, tīmekļa daļai ir nepieciešams neliels API atļauju kopums, ko nomnieka administrators apstiprina vienu reizi.

Šajā rakstā ir uzskaitītas šīs atļaujas, paskaidrots, kam katra no tām tiek izmantota, parādīts, kā tās apstiprināt, un aprakstīts, kā diagramma izskatās, ja kāda atļauja trūkst. Raksts ir paredzēts SharePoint un Microsoft 365 administratoriem, kā arī drošības pārbaudītājiem, kuriem produkts jānovērtē pirms izvietošanas.

Atļaujas

Organizational Chart pieprasa trīs deleģētās Microsoft Graph atļaujas:

Visas trīs ir deleģētās atļaujas: tīmekļa daļa vienmēr izsauc Microsoft Graph pierakstījušos lietotāja vārdā, nekad — ar savu lietojumprogrammas identitāti. Tāpēc diagramma nekad nerāda apmeklētājam neko tādu, ko apmeklētājs nevarētu redzēt, pats pārlūkojot direktoriju Microsoft 365, — tā tikai pasniedz šo informāciju ērtākā formā.

Atļauju apstiprināšana

Atļauju pieprasījumi tiek reģistrēti automātiski, kad Organizational Chart pakotne tiek izvietota nomnieka lietotņu katalogā. Lai tos apstiprinātu:

1. Pierakstieties SharePoint administrēšanas centrā ar kontu, kuram ir loma Globālais administrators vai SharePoint administrators.
2. Kreisajā navigācijā izvērsiet Papildu un atlasiet API piekļuve.
3. Sadaļā Gaidošie pieprasījumi atrodiet Organizational Chart pakotnes pieprasījumus resursam Microsoft Graph — Directory.Read.All, User.Read.All un Presence.Read.All.
4. Atlasiet katru pieprasījumu un noklikšķiniet uz Apstiprināt. Apstipriniet darbību atvērtajā panelī. Apstiprinātās atļaujas pāriet uz sarakstu Apstiprinātie pieprasījumi, kur tās jebkurā brīdī var pārskatīt vai atsaukt.

Kas notiek, ja atļauja trūkst

Trīs atļaujas atsakās darboties dažādi, un tas palīdz diagnosticēt problēmu:

• Directory.Read.All vai User.Read.All nav apstiprināta. Diagramma vispār nevar ielādēt direktoriju. Koka vietā tīmekļa daļa rāda ziņojumu Diemžēl kaut kas nogāja greizi. Lūdzu, atsvaidziniet lapu un mēģiniet vēlreiz. un pogu Konfigurēt lapas redaktoriem. Apstipriniet gaidošos pieprasījumus un ielādējiet lapu atkārtoti.
• Presence.Read.All nav apstiprināta. Diagramma ielādējas un visas kartītes tiek rādītas, bet klātbūtnes punkts uz fotoattēliem trūkst visiem. Tas ir visbiežāk sastopamais daļējais stāvoklis: abas direktorija atļaujas ir apstiprinātas, bet klātbūtnes pieprasījums ir palicis nepamanīts.
• Atļauja tika atsaukta pēc izvietošanas. Simptomi ir tādi paši kā iepriekš. Atsauktās atļaujas atkal parādās sadaļā Gaidošie pieprasījumi, un tās var apstiprināt vēlreiz.

Kas var redzēt diagrammu

Tā kā tīmekļa daļa izmanto deleģētās atļaujas, piekļuvi diagrammai nosaka divi faktori:

• Piekļuve lapai. Apmeklētājam ir jāspēj atvērt SharePoint lapu vai Teams cilni, kurā atrodas tīmekļa daļa, — tiek piemērotas parastās SharePoint un Teams atļaujas.
• Piekļuve direktorijam. Pēc noklusējuma ikviens organizācijas dalībnieks var lasīt direktorija pamatinformāciju Microsoft 365, tāpēc katrs apmeklētājs ar piekļuvi lapai redz vienu un to pašu diagrammu. Savukārt viesu lietotāji diagrammā netiek ielādēti un parasti arī nevar lasīt pilnu direktoriju.

Organizational Chart nepievieno nekādu savu atļauju slāni: tā neslēpj atsevišķus darbiniekus no konkrētiem apmeklētājiem un nevienam nepiešķir piekļuvi datiem, ko tas nevarētu lasīt citur Microsoft 365. Lai noteiktus kontus — pakalpojumu kontus, koplietojamās pastkastes, testa lietotājus — pilnībā izslēgtu no diagrammas, izmantojiet tīmekļa daļas filtrēšanas un izslēgšanas opcijas, kas aprakstītas rakstā KB10233. Kā pievienot un konfigurēt Organizational Chart tīmekļa daļu.

Datu apstrāde

Drošības pārbaudei parasti ir būtiski šādi punkti:

• Darbinieku datus no Microsoft Graph nolasa tieši lietotāja pārlūkprogramma, un tie netiek sūtīti ne uz Vitextra, ne uz kādu trešās puses pakalpojumu.
• Ielādētā direktorija momentuzņēmums tiek glabāts pārlūkprogrammas lokālajā krātuvē līdz 12 stundām, lai paātrinātu atkārtotus apmeklējumus; tas tiek glabāts katram lietotājam un katrai pārlūkprogrammai atsevišķi un nekad neatstāj ierīci.
• Fotoattēli un klātbūtnes statuss tiek pieprasīti tikai ekrānā redzamajām kartītēm un netiek saglabāti kešatmiņā ilgāk par lapas sesiju.
• Tīmekļa daļa sazinās ar Vitextra serveriem tikai tāpēc, lai pārbaudītu nomnieka licences statusu, ielādētu statiskos resursus, piemēram, ikonas, un apkopotu anonīmu telemetriju par produkta lietošanu. Šajos pieprasījumos direktorija dati netiek iekļauti.