Teams整合環境準備

1.1 版本

1.2 功能簡介

本文將介紹開始配置Teams整合前所需的環境準備工作。

• 安裝Teams integration 插件，可實現Teams 整合

• 在排程管理的匯出設定中，可以配置並派送Teams訊息

• 支援整合多個Teams應用

• 功能當前為內測招募階段，如需試用本文介紹的功能，請填寫 問卷 或者直接掃描下方 QRCODE 報名，對於符合試用要求的用戶，報名後將會有工作人員聯絡您。

1.3 網路環境

1.3.1 網路要求

1）外網使用者

• 无限制，可正常使用
  

2）內網使用者

• 報表伺服器上，需要能ping通下列三个URL：

     login.microsoftonline.com 

     https://graph.microsoft.com/v1.0

     webhook所用的域名，例如:https://fanruan.webhook.office.com，如何查看域名请参见：Teams整合範例 第3.3.3節

• ping不通，找三个個代理伺服器配置nginx正向代理，代理伺服器配置需要配置上述三个URL。

1.3.2 報表伺服器域名格式要求

報表伺服器域名支援下列2種格式：

• 配置為https，例如：https://xxx.xxx.com/webroot/decision

• 非https的情況下，只支援http://localhost:埠/webroot/decision格式。該情況下，Teams集成後排程管理不支援派送圖文訊息。

            注：非https的情況下，僅限本地工程配合本機進行Teams測試，派送訊息僅支援在伺服器端訪問，因此如需在正式環境使用，請配置https

1.4 注意事項

• 目前僅teams用戶端支援使用單點登入功能。

• 不支援新版本Teams（圖標顯示為），請安裝家用版本，如下圖：

新版本相關公告見：Announcing general availability of the new Microsoft Teams app for Windows and Mac 。

2.1 Microsoft Azure 建立應用

1）管理者進入https://portal.azure.com/#home，搜尋框內輸入“應用程式註冊”，選中。

2）點選新增按鈕

3）填寫名稱，點選註冊

2.2 配置應用權限

1）在應用權限管理中找到剛才建立的應用，點選進入。

2）在管理中找到API 權限，點選「新增權限>Microsoft API>Microsoft Graph權限」。

3）新增權限。

委派的權限：搜尋User.Read並勾選。

應用程式權限：分別勾選下列6項權限。

• Application.Read.All

• Chat.Create

• Group.Read.All

• GroupMember.Read.All

• Organization.Read.All

• User.Read.All

3）申請後需管理者進行同意。

2.3 設定憑證及祕密

在管理中找到憑證和密碼，點選「用戶端密碼>新增用戶端密碼」，新增用戶端密碼

注：除了剛剛建立時，之後無法查看用戶端密碼值。請務必在建立時儲存密碼，然後再離開該頁面。

2.4 URL通配符配置

在管理中找到清單，搜尋關鍵詞replyUrlsWithType，新增如下所示JSON。

(該部分說明可參考微軟官方文檔-重定向 URI（答覆 URL）限制和侷限)  

"replyUrlsWithType": [
        {
            "url": "https://ip:port/webroot/decision/plugin/public/com.fr.plugin.teams.v11/teams/single/*",
            "type": "Web"
        }
    ],

注：此處URL中的 ip:port 為帆軟工程的ip與埠，且帆軟工程需要已完成https配置。