Prepojte účty Microsoftu pre Teams
Prepojenie účtu Microsoftu umožní človeku z Teams dostať sa z Teams k svojmu prístupu v Chettym a Chetty umožní pracovať s jeho dátami v Microsoft 365.
Skôr než začnete
- Bot v Teams funguje: má nastavené prihlasovacie údaje a odpovedá v osobnom chate. Pozrite Microsoft Teams.
- Ste administrátor Microsoft Entra pre daný tenant, alebo viete, kto ním je.
- Chetty má verejnú adresu HTTPS. Bez nej prihlásenie do webovej aplikácie nefunguje.
Prihláste sa z osobného chatu
- Vytvorte druhú registráciu aplikácie Entra pre jedného tenanta, určenú pre pripojenie prihlásenia.
- Pridajte adresu presmerovania
https://token.botframework.com/.auth/web/redirecta udeľte delegované oprávnenia uvedené v Udeľte rozsahy oprávnení. - V prostriedku Azure Bot pridajte pripojenie OAuth s poskytovateľom Microsoft Entra ID v2, s ID, tajným kľúčom a tenantom tejto aplikácie. Token Exchange URL nechajte prázdne.
- V Chettym otvorte stránku MS Teams a zadajte presný názov pripojenia do Názov pripojenia OAuth.
- Zapnite Prihlásenie k Microsoftu v osobnom chate.
Člen tenantu, ktorý je v Chettym aktívny, sa potom môže prihlásiť z osobného chatu v Teams a pracovať s prístupom svojho prepojeného účtu.
Prihláste sa do webovej aplikácie
- Na stránke MS Teams zapnite Povoliť prihlásenie cez Microsoft.
- Nastavte Verejnú adresu Chetty na verejnú adresu Chetty s HTTPS.
- Zaregistrujte túto adresu s doplneným
/api/auth/sso/microsoft/callbackako adresu presmerovania v aplikácii bota.
Ľudia sa potom prihlasujú do Chettyho účtom Microsoftu namiesto miestneho hesla.
Spárujte existujúci účet
Prepojenie z osobného chatu a prihlásenie do webovej aplikácie sú samostatné funkcie a obe končia pri jednom prepojenom účte v aplikácii Chetty.
- Prepájať existujúce účty podľa e-mailu pri prvom prihlásení do webovej aplikácie spáruje práve jeden existujúci účet v aplikácii Chetty. Potom je trvalou identitou ID objektu Entra.
- Prepojiť účet Chettyho v pracovnom priestore Teams umožní administrátorovi pripojiť známu identitu z Teams k inému existujúcemu účtu.
Nejednoznačné alebo konfliktné zhody sa odmietnu, namiesto toho aby sa odhadovali.
Zakladajte účty automaticky
Nastavte Zakladanie účtov na Celý tenant, aby sa pre každého aktívneho člena nastaveného tenantu založil účet v aplikácii Chetty.
Chetty rozlíši člena od hosťa podľa voliteľného claimu acct v ID tokene; pridajte ho v Token configuration aplikácie bota. Bez tohto claimu sa Chetty opýta Microsoft Graphu, čo potrebuje aplikačné oprávnenie User.Read.All so súhlasom administrátora tenantu. Hostia, zakázané účty a identity mimo tenanta sa odmietnu.
Predvolené projekty nových účtov a Nový osobný projekt pre každý nový účet platia len pre účty založené neskôr. Existujúce účty si nechávajú, čo majú.
Používajte nástroje Microsoft 365
Nástroje Microsoft 365 konajú s delegovanou identitou a oprávneniami prepojeného účtu všade, kde sa tento účet používa, vrátane zdieľaných chatov a osobných naplánovaných úloh daného človeka. Tokeny zostávajú v službe Bot Framework Token Service, nie v Chettym.
Prístup k Microsoft 365 je v predvolenom stave Iba na čítanie. Čítanie a zápis každú zmenu najprv zobrazí v náhľade, kým ju agent výslovne nepotvrdí.
Udeľte rozsahy oprávnení
Delegovaná aplikácia potrebuje len oprávnenia pre nástroje, ktoré chcete používať. Praktický základ je:
openid profile email offline_access
User.Read User.Read.All People.Read
Files.ReadWrite.All Sites.ReadWrite.All
Mail.ReadWrite Mail.Send Mail.ReadWrite.Shared Mail.Send.Shared
Calendars.ReadWrite Calendars.ReadWrite.Shared
Contacts.ReadWrite Tasks.ReadWrite
Group.ReadWrite.All Notes.ReadWrite.All
Chat.ReadWrite ChatMessage.Send
Team.ReadBasic.All Channel.ReadBasic.All ChannelMessage.Read.All ChannelMessage.Send
offline_access nechajte, aby pripojenie prežilo vypršanie tokenu. GroupMember.Read.All pridajte len vtedy, keď volanie členstva v skupinách v adresári hlási, že chýba. Pripojenie Teams Chat.Read.All nepotrebuje.
Overte, že to funguje
- Prihláste sa z osobného chatu v Teams testovacím účtom Microsoftu.
- Požiadajte Chettyho o niečo jednoduché z Microsoft 365, napríklad o najbližšie stretnutie v kalendári.
- Otvorte účet v Používatelia a overte, že je prepojený s identitou Microsoftu, ktorú ste použili.
Keď to nefunguje
- Chýba tlačidlo prihlásenia: zodpovedajúci prepínač je na stránke MS Teams vypnutý, alebo Názov pripojenia OAuth presne nezodpovedá pripojeniu v Azure Bote.
- Prihlásenie u Microsoftu zlyhá: v aplikácii Entra chýba adresa presmerovania, alebo nie sú udelené delegované oprávnenia.
- „Nepodarilo sa overiť váš prístup v adresári Microsoftu": aplikácia nevie čítať dáta adresára. Pridajte claim alebo oprávnenie Graph opísané v Zakladajte účty automaticky.
- Nástroj Microsoft 365 je odmietnutý: Prístup k Microsoft 365 je Iba na čítanie, alebo nebolo nikdy udelené oprávnenie pre daný nástroj.
- Prepojenie je odmietnuté: tomu e-mailu zodpovedá viac účtov v aplikácii Chetty, alebo je identita už prepojená inde.
Súvisiace návody
Prečítajte si Microsoft Teams o nastavení bota, Čo je zdieľané v kanáli o zdieľaných chatoch a Kanály o pravidlách prístupu.