為何 AB Projects 需要 Microsoft Graph 權限

為何 AB Projects 需要 Microsoft Graph 權限

AB Projects 會在兩個地方要求權限。系統管理員會為整個組織檢視一次 Microsoft 同意畫面;當應用程式被新增到團隊或更新時,團隊擁有者會接受一份簡短的團隊權限清單。每一項都對應到產品中看得見的功能,其中大部分是委派存取,也就是應用程式以您的身分運作,絕不會做超出您原本就能做的事。

什麼是 Microsoft Graph?這些權限用在哪裡?

Microsoft Graph 是 Microsoft 365 內建的 API — 應用程式存取 Teams、Outlook 與您個人檔案的官方入口。AB Projects 將它用於四件事:

頻道連結與名冊同步

將專案連接到正確的 Teams 頻道,並自動將頻道成員加入專案 — 請參閱新增或移除成員。

任務卡片與留言同步

將任務卡片與留言張貼到頻道討論串,並將該討論串中的回覆同步回任務 — 請參閱在頻道中以提及方式留言。

行事曆排程

當您選擇為任務封鎖時間時,為該任務建立 Outlook 行事曆事件,並排定會議。

登入(SSO)

使用您的 Microsoft 365 帳戶免密碼登入 — 請參閱SSO 與 Microsoft 登入。

組織層級權限

這些是系統管理員在 Microsoft Entra ID 中同意一次的權限。委派 = 應用程式以已登入使用者的身分運作,僅限於該使用者原本就能執行的範圍。應用程式 = 在沒有使用者登入時由 AB Projects 使用,用於背景作業,例如讓專案成員與其頻道保持一致。

權限類型AB Projects 為何需要此權限
User.Read委派登入並讀取您的基本 Microsoft 365 個人檔案。任何使用 Microsoft 登入的應用程式都需要此權限。
openid, profile, email委派標準登入範圍:驗證您的身分,並讀取您的名稱、頭像與電子郵件地址,讓任務與留言歸屬於正確的人。
offline_access委派讓應用程式在背景重新整理存取權(例如行事曆同步),而不必在每次權杖過期時要求您重新登入。
Team.ReadBasic.All委派讀取您所屬 Teams 團隊的名稱,以便將專案連結到正確的團隊。
Channel.ReadBasic.All委派讀取基本的頻道名稱,以便在索引標籤設定期間選取正確的頻道並正確顯示。
Group.Read.All委派讀取團隊背後的 Microsoft 365 群組 — 用於專案 ↔ 頻道連結,以及將頻道成員加入專案的自動名冊同步。
ChannelMessage.Send委派當您變更任務或新增留言時,以您的身分張貼到已連結的頻道(包括 @提及您選取的成員)。
ChannelMessage.ReadWrite委派讀取並張貼頻道訊息,讓任務留言與更新出現在該任務自己的 Teams 討論串中。
Calendars.ReadWrite委派當您選擇同步任務時,為該任務建立及更新 Outlook 行事曆事件(時間封鎖)。在登入時要求,因此之後不會再出現額外的同意提示。
Schedule.Read.All委派讀取您原本就能檢視的 Teams 班表。它列在同意畫面上,但目前沒有任何 AB Projects 功能使用它。
TeamMember.Read.All應用程式讀取團隊中有哪些成員,讓專案的成員清單即使在無人登入時也能跟隨已連結的頻道。
ChannelMember.Read.All應用程式讀取私人或共用頻道中有哪些成員。這類頻道的成員可能與團隊不同,因此這些專案取得的是頻道成員,而非整個團隊。

團隊權限(由團隊擁有者接受)

有幾項權限只適用於單一團隊。Microsoft 稱之為資源特定同意:不是由系統管理員在整個組織授與存取權,而是在 AB Projects 新增到團隊時,或在更新新增了權限時,由團隊擁有者接受。這些權限不會在該團隊之外賦予應用程式任何存取權,從團隊中移除 AB Projects 後,這些權限也會隨之取消。

權限類型AB Projects 為何需要此權限
TeamMember.Read.Group團隊讀取此團隊的成員清單,用於名冊同步。
ChannelMessage.Read.Group團隊讓 Bot 不必被 @提及就能接收此團隊頻道中的回覆,任務卡片下的一般回覆因此會成為任務的留言。於 AB Projects 2.4.0 新增。AB Projects 只會記錄其自身任務卡片與文件卡片下方討論串中的回覆。

給系統管理員的注意事項

  • 委派存取不會超出使用者本身的權限。上表大部分的權限都以已登入者的身分運作 — 如果此人看不到某個頻道,應用程式也看不到。
  • 應用程式權限用於名冊同步。它們讓 AB Projects 在無人登入時也能讓專案成員與其頻道保持一致。它們只讀取成員資格,不讀取訊息。
  • 回覆同步使用的是團隊權限,而非組織層級權限。ChannelMessage.Read.Group 由團隊擁有者逐一團隊接受,因此絕不會涵蓋尚未接受的團隊。
  • 寫入行事曆須針對每個任務主動選擇。只有在您明確同步任務或從任務排定會議時,應用程式才會存取您的行事曆。
  • 控制權始終在您手上。組織層級權限可隨時在 Microsoft Entra ID 中檢閱或撤銷;首次登入時,每個組織可能需要同意一次(請參閱SSO 與 Microsoft 登入)。從團隊中移除 AB Projects 後,團隊權限即告終止。

簡而言之:這些權限的存在是為了讓任務、Teams 頻道與您的行事曆保持同步 — 其中沒有任何權限會讀取您的郵件或檔案,而同意畫面始終是權威清單。

發佈於 2025-07-14
最後更新於 2026-10-08
版本 2