Quantcast
Channel: 簡睿隨筆
Viewing all articles
Browse latest Browse all 897

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

$
0
0

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

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

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

integration 1

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

integration 2

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位置則是設定此項整合允不允許一般使用者也能使用。

oauth1

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

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

oauth2

1-3. 新增應用程式

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

oauth3

1-4. 輸入OAuth 2.0欄位

輸入欄位如下:

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

new RSS

1-5. 設定結果

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

connection info

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

Zapier的服務建立步驟

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

2-1. 建立Zap

make a zap

2-2. 選擇驅動的應用

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

choose app

new item

2-3. 設定RSS資料欄位

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

Set up RSS

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

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

Edit template

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

2-5. 測試RSS feed URL

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

test fetch by RSS

2-6. 測試結果網頁

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

test result

2-7. 選擇接收對象

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

choose action app

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

Mattermost應用的動作是Post Message(送出訊息)。

choose action

2-9. 連接Mattermost

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

connect to mattermost

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

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

allow to access

2-11. 測試

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

test post

2-12. 測試後訊息

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

after test

發送RSS訊息

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

post message

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

final message

##

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


Viewing all articles
Browse latest Browse all 897

Trending Articles