[Mattermost 教學#7] Mattermost的OAuth 2.0應用程式整合的操作步驟

如果只是把Mattermost當做即時通訊工具來看待的話，可是大大低估了Mattermost的功用與潛力了。Mattermost真正強大的是它的開放整合的特性，透過整合功能，我們可以把各種以往只能經由Email溝通的事物，藉由Mattermost方便的通知提醒，更容易達到資訊透通與迅速交流的目標。Mattermost有四種整合方式：

• 傳入的Webhook（網路掛接）：以Mattermost主機當中心，由別的網站傳給Mattermost主機接收的網路服務（發送端：其他網站，接收端：Mattermost主機）
• 傳出的Webhook：Mattermost主機發送給別的網站接收的網路服務（發送端：Mattermost主機，接收端：其他網站）
• 斜線命令：於訊息輸入框以正斜線啟動的對外網路服務
• OAuth 2.0應用程式：Mattermost主機開放OAuth授權，由使用者同意別的應用程式能傳送資料給Mattermost接收

整合功能必須由系統系統員由【系統主控台】→【整合】→【自訂整合】選擇要開放的種類（第一個選項中文有誤，是傳入才對）：

如果四種整合都啟用，則會看到下列畫面：

OAuth 2.0 應用程式

這四種整合只有最後一種「OAuth 2.0應用程式」不需要程式設計，只要找好應用程式和設定就能「餵」資料給Mattermost接收，因此本文先以OAuth應用程式來解說Mattermost的整合功能是如何運作的。

首先我們可以依照整合文件Zapier Integration — Mattermost 4.9 documentation的說明來設定Zapier網站（類似IFTTT.com的服務代理網站）如何讀取第三方的RSS資訊，再將資訊傳遞給Mattermost。我們的範例是讓Zapier網站去讀取天下雜誌的精選文章RSS，再把文章標題和連結傳Mattermost接收並顯示在特定頻道內。

Mattermost OAuth 2.0設定

1-1. 確認是否已啟用了OAuth 2.0應用程式整合功能

紅色3位置必須選【是】，紅色4位置則是設定此項整合允不允許一般使用者也能使用。

1-2. 進入OAuth 2.0 應用程式整合網頁

由主功能表【整合】→再點擊【OAuth 2.0 應用程式】。

1-3. 新增應用程式

點擊右上角的【新增OAuth 2.0 應用程式】。

1-4. 輸入OAuth 2.0欄位

輸入欄位如下:

• 是受信任：選擇【否】需要許可才能存取資料
• 顯示名稱：可辨識的名稱
• 敘述：任意描述文字
• 首頁：輸入 https://zapier.com
• 回呼網址：連線Mattermost後，Mattermost叫用此網址讓Zapier接收叫用結果

1-5. 設定結果

設定成功後會產生連線需要的用戶端ID與用戶端密碼，這兩個欄位是後面提供給別的應用程式用來登入Mattermost主機的資料。

到此Mattermost主機上的OAuth 2.0設定完成，接著設定中介網站Zapier的選項。

Zapier的服務建立步驟

Zapier裡的一個服務項目稱為一個Zap。第一步是先建立一個Zapier網站的帳號，再用此帳號來建立新的Zap。

2-1. 建立Zap

2-2. 選擇驅動的應用

在【Choose a Trigger App】步驟選用內建的【RSS】應用。

2-3. 設定RSS資料欄位

接著以【New item in Feed】繼續，再於右方的【Feed URL】欄位填入天下雜誌精選文章的RSS網址：http://www.cw.com.tw/RSS/cw_content.xml。

2-4. 編輯送出訊息的格式

把標示有Required的欄位都選擇完成，即要輸出的團隊、頻道和顯示內容格式，顯示格式由其右上角圖示選擇，有標題、內容、超連結能欄位，即RSS項目的各個欄位。

▼ Edit Template設定後送出測試內容到Mattermost

2-5. 測試RSS feed URL

繼續在【Test RSS by Zapier】網頁按【Fetch & Continue】，擷取天下雜誌精選文章的新內容。

2-6. 測試結果網頁

看到Test Sucessful表擷取天下雜誌精選文章RSS項目成功。

2-7. 選擇接收對象

來源網站設定完成後，接著設定作用的對象設定。在【Choose an Action App】輸入mattermost以找到Mattermost應用程式。

2-8. 選擇Mattermost應用的動作

Mattermost應用的動作是Post Message（送出訊息）。

2-9. 連接Mattermost

輸入Mattermost的用戶端ID與用戶端密碼使能正確和Mattermost主機連線。用戶端ID與用戶端密碼是在步驟1-5時產生的資訊。

2-10. 正確與Mattermost連線並允許取存

輸入Mattermost帳號後若能正確連線，則會出現是否允許Zapier RSS應用程式取存Mattermost資訊的選項，回覆【允許】。

2-11. 測試

Mattermost能成功連線後，按Test測試將RSS應用送出訊息給Mattermost接收。

2-12. 測試後訊息

測試後訊息顯示出來後，可以到Mattermost頻道檢視是否有接收到RSS訊息，若有接收到則表示整合測試成功。

發送RSS訊息

在Zapier網站的Zaps分頁選用Run，可立即取用天下雜誌精選文章RSS內容並傳送給Mattermost。

Mattermost接收到RSS內容並顯示在指定的頻道：

＃＃

您可能也會有興趣的類似文章

• [Mattermost 教學#8] 傳入的Webhook範例說明 (2則留言, 2018/05/27)
• [Mattermost 教學#1] 團隊溝通工具Mattermost的Windows安裝指引 (0則留言, 2018/04/07)
• [Mattermost 教學#6] Mattermost 桌面應用程式使用說明 (3則留言, 2018/04/19)
• [Mattermost 教學#3] 頁面樣式與訊息操作 (0則留言, 2018/04/08)
• [Mattermost 教學#5] 方便的斜線命令與AutoHotkey (2則留言, 2018/04/17)
• [Mattermost 教學#4] Mattermost的快捷鍵 (0則留言, 2018/04/16)
• [Mattermost 教學#2] 系統控制台與帳號設定 (0則留言, 2018/04/08)
• 簡聊：適合團隊協同工作的即時通訊工具 (0則留言, 2015/02/02)
• 建立測試環境以git rebase -i變更Commit歷史 (0則留言, 2014/10/08)
• [Tools] 令人失望的Dia試用 (0則留言, 2005/03/01)
• BoltWire：讓人享受堆積木樂趣的Wiki系統 (6則留言, 2008/12/13)
• 使用JUnit5測試程式的操作步驟 (IDEA教學 #10) (0則留言, 2019/08/31)
• 超簡單MSN下載檔案自動分類 (0則留言, 2010/02/27)
• Obs156｜懶人式版本控制＋差異式備份：diffzip－Differential ZIP Backup (2則留言, 2024/03/16)
• [Obs＃62] Obsidian搜尋全攻略 (0則留言, 2021/11/26)